暫無描述

Mark Otto 2515dd35ec bump version		10 年之前
_includes	0636f97d92 Update head.html	10 年之前
_layouts	48f632cd3b Merge pull request #94 from dapenggao/patch-2	10 年之前
_posts	f991b86869 remove extra line	10 年之前
_sass	312e77a7f3 redesign highlightable code and allow line numbers	10 年之前
public	18881e6d7a Change up all the things to do Sass support	10 年之前
.gitignore	18881e6d7a Change up all the things to do Sass support	10 年之前
404.html	17651abeeb more baseurl changes	10 年之前
LICENSE.md	633aed112b add all the things	11 年之前
README.md	021efcbe9b mention sass in readme	10 年之前
_config.yml	2515dd35ec bump version	10 年之前
about.md	11e7656963 Fix poole issues link	10 年之前
atom.xml	a7771d1362 remove slashes from atom.xml urls	10 年之前
index.html	5e1cbc6b13 Merge branch 'improve_paginator_paths' of https://github.com/tra/poole into tra-improve_paginator_paths	10 年之前
styles.scss	423c5f1b3e move from css folder to base dir	10 年之前

Poole

The Strange Case of Dr. Jekyll and Mr. Hyde tells the story of a lawyer investigating the connection of two persons, Dr. Henry Jekyll and Mr. Edward Hyde. Chief among the novel's supporting cast is a man by the name of Mr. Poole, Dr. Jekyll's loyal butler.

Poole is the butler for Jekyll, the static site generator. It's designed and developed by @mdo to provide a clear and concise foundational setup for any Jekyll site. It does so by furnishing a full vanilla Jekyll install with example templates, pages, posts, and styles.

See Poole in action with the demo site.

There are currently two official themes built on Poole:

Hyde
Lanyon

Individual theme feedback and bug reports should be submitted to the theme's individual repository.

Usage
Options
- Rems, font-size, and scaling
Development
Author
License

Usage

1. Install dependencies

Poole is built on Jekyll and uses its built-in SCSS compiler to generate our CSS. Before getting started, you'll need to install the Jekyll gem:

$ gem install jekyll

Windows users: Windows users have a bit more work to do, but luckily @juthilo has your back with his Run Jekyll on Windows guide.

Need syntax highlighting? Poole includes support for Pygments or Rouge, so install your gem of choice to make use of the built-in styling. Read more about this in the Jekyll docs.

2a. Quick start

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.

2b. Roll your own Jekyll site

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.).

3. Running locally

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):

$ jekyll serve

Open http://localhost:4000 in your browser, and voilà.

4. Serving it up

If you host your code on GitHub, you can use GitHub Pages to host your project.

Fork this repo and switch to the gh-pages branch.
1. If you're using a custom domain name, modify the CNAME file to point to your new domain.
2. If you're not using a custom domain name, modify the baseurl in _config.yml to point to your GitHub Pages URL. Example: for a repo at github.com/username/poole, use http://username.github.io/poole/. Be sure to include the trailing slash.
Done! Head to your GitHub Pages URL or custom domain.

No matter your production or hosting setup, be sure to verify the baseurl option file and CNAME settings. Not applying this correctly can mean broken styles on your site.

Options

Poole includes some customizable options, typically applied via classes on the <body> element.

Rems, `font-size`, and scaling

Poole is built almost entirely with rems (instead of pixels). rems are like ems, but instead of building on the immediate parent's font-size, they build on the root element, <html>.

By default, we use the following:

html {
  font-size: 16px;
  line-height: 1.5;
}
@media (min-width: 38em) {
  html {
    font-size: 20px;
  }
}

To easily scale your site's typography and components, simply customize the base font-sizes here.

Development

Poole has two branches, but only one is used for active development.

master for development. All pull requests should be to submitted against master.
gh-pages for our hosted site, which includes our analytics tracking code. Please avoid using this branch.

CSS is handled via Jeykll's built-in Sass compiler. Source Sass files are located in _sass/, included into styles.scss, and compile to styles.css.

Author

Mark Otto

License

Open sourced under the MIT license.

README.md