3 In the novel, *The Strange Case of Dr. Jeykll and Mr. Hyde*, Mr. Poole is Dr. Jekyll's virtuous and loyal butler. Similarly, Poole is the Butler for Jekyll themes by [@mdo](https://twitter.com/mdo), providing a clear and concise foundational setup for any Jekyll site.
5 ![Poole](https://f.cloud.github.com/assets/98681/1825252/f61f1fec-71af-11e3-8e90-fdd031b64308.png)
7 There are currently two official themes built on Poole:
9 * [Hyde](http://hyde.getpoole.com)
10 * [Lanyon](http://lanyon.getpoole.com)
12 Individual theme feedback and bug reports should be submitted to the theme's individual repository.
19 Poole is built for use with Jekyll, so naturally you'll need to install that. On Macs, it's rather straightforward:
25 **Windows users:** Windows users have a bit more work to do, but luckily [@juthilo](https://github.com/juthilo) has your back with his [Run Jekyll on Windows](https://github.com/juthilo/run-jekyll-on-windows) guide.
27 You may also need to install Pygments, the Python syntax highlighter for code snippets that plays nicely with Jekyll. Read more about this [in the Jekyll docs](http://jekyllrb.com/docs/templates/#code_snippet_highlighting).
31 To help anyone with any level of familiarity with Jekyll quickly get started, Poole includes everything you need for a basic Jekyll site. To that end, just download Poole and start up Jekyll.
33 ### 2b. Roll your own Jekyll site
35 Folks wishing to use Jekyll's templates and styles can do so with a little bit of manual labor. Download Poole and then copy what you need (likely `_layouts/`, `*.html` files, `atom.xml` for RSS, and `public/` for CSS, JS, etc.).
37 ### 3. Running locally
39 To see your Jekyll site with Poole applied, start a Jekyll server. In Terminal, from `/Poole` (or whatever your Jekyll site's root directory is named):
45 Open <http://localhost:4000> in your browser, and voilĂ . You're done.
50 Poole includes some customizable options, typically applied via classes on the `<body>` element.
53 ### Rems, `font-size`, and scaling
55 Poole is built almost entirely with `rem`s (instead of pixels). `rem`s are like `em`s, but instead of building on the immediate parent's `font-size`, they build on the root element, `<html>`.
57 By default, we use the following:
64 @media (min-width: 38rem) {
72 To easily scale your site's typography and components, simply customize the base `font-size`s here.
78 - <https://github.com/mdo>
79 - <https://twitter.com/mdo>
84 Open sourced under the [MIT license](LICENSE.md).