|
1 |
| -# [Hyde](http://andhyde.com) |
| 1 | +# Hyde |
2 | 2 |
|
3 |
| -An elegant open source, mobile first theme for [Jekyll](https://github.com/mojombo/jekyll). It includes lightweight styles and placeholder content to get you up and running with a simple blog in no time. |
| 3 | +Hyde is a [Jekyll](https://github.com/mojombo/jekyll) theme with a fluid landscape layout. It's based on [Poole](https://github.com/poole/poole), the Jekyll butler. |
4 | 4 |
|
5 | 5 | 
|
6 | 6 |
|
7 | 7 |
|
8 |
| -## Usage |
| 8 | +## Installation |
9 | 9 |
|
10 |
| -### 1. Install Jekyll |
| 10 | +### Requires Poole |
11 | 11 |
|
12 |
| -Hyde is built for use with Jekyll, so naturally you'll need to install that. On Macs, it's rather straightforward: |
| 12 | +To get started, download [Poole](https://github.com/poole/poole). See [the usage guidelines](https://github.com/poole/poole#usage) for how to install and get up and running with Jekyll and Poole. |
13 | 13 |
|
14 |
| -```bash |
15 |
| -$ gem install jekyll |
16 |
| -``` |
17 |
| - |
18 |
| -**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. |
19 |
| - |
20 |
| -You may also need to install Pygments, the Python syntax highlighter for code snippets that places nicely with Jekyll. Read more about this [in the Jekyll docs](http://jekyllrb.com/docs/templates/#code_snippet_highlighting). |
21 |
| - |
22 |
| -### 2a. Quick start |
23 |
| - |
24 |
| -To help anyone with any level of familiarity with Jekyll quickly get started, Hyde includes everything you need for a basic Jekyll site. To that end, just download Hyde and start up Jekyll. |
| 14 | +### Enabling Hyde |
25 | 15 |
|
26 |
| -### 2b. Roll your own Jekyll site |
| 16 | +Copy over the included files to turn any vanilla Poole site into a Hyde site. |
27 | 17 |
|
28 |
| -Folks wishing to use Jekyll's templates and styles can do so with a little bit of manual labor. Download Hyde and then copy what you need (likely `_layouts/`, `*.html` files, `atom.xml` for RSS, and `public/` for CSS, JS, etc.). |
29 |
| - |
30 |
| -### 3. Running locally |
31 |
| - |
32 |
| -To see your Jekyll site with Hyde applied, start a Jekyll server. In Terminal, from `/hyde` (or whatever your Jekyll site's root directory is named): |
33 |
| - |
34 |
| -```bash |
35 |
| -$ jekyll serve |
36 |
| -``` |
| 18 | +- Replace `_includes/` with the included folder of the same name (will replace `_includes/head.html` and add `_includes/sidebar.html`) |
| 19 | +- Replace `_layouts/default.html` with the included file of the same name |
| 20 | +- Move `public/css/hyde.css` to `public/css/` |
37 | 21 |
|
38 |
| -Open <http://localhost:4000> in your browser, and voilà. You're done. |
| 22 | +Then, start up your Jekyll server and go! |
39 | 23 |
|
40 | 24 |
|
41 | 25 | ## Options
|
42 | 26 |
|
43 |
| -Hyde includes a few options, typically applied via classes on the `<body>` element. |
| 27 | +Hyde includes some customizable options, typically applied via classes on the `<body>` element. |
44 | 28 |
|
45 | 29 | ### Themes
|
46 | 30 |
|
47 |
| -As of v1.1, Hyde ships with optional themes based on the [base16 color scheme](https://github.com/chriskempson/base16). In Hyde, a theme simply changes the sidebar's background color and the color of links within blog posts. Here's the red theme in action: |
| 31 | +Hyde ships with eight optional themes based on the [base16 color scheme](https://github.com/chriskempson/base16). Apply a theme to change the color scheme (mostly applies to sidebar and links). |
48 | 32 |
|
49 | 33 | 
|
50 | 34 |
|
51 | 35 | There are eight themes available at this time.
|
52 | 36 |
|
53 | 37 | 
|
54 | 38 |
|
55 |
| -To use a theme, add anyone of the available theme classes to the `<body>` element like so: |
| 39 | +To use a theme, add anyone of the available theme classes to the `<body>` element in the `default.html` layout, like so: |
56 | 40 |
|
57 | 41 | ```html
|
58 | 42 | <body class="theme-base-08">
|
59 | 43 | ...
|
60 | 44 | </body>
|
61 | 45 | ```
|
62 | 46 |
|
63 |
| -To create your own theme, look to the Themes section of [Hyde's CSS](https://github.com/mdo/hyde/blob/master/public/css/hyde.css). Copy any existing theme (they're only a few lines of CSS), rename it, and change the provided colors. |
| 47 | +To create your own theme, look to the Themes section of [included CSS file](https://github.com/poole/hyde/blob/master/public/css/hyde.css). Copy any existing theme (they're only a few lines of CSS), rename it, and change the provided colors. |
64 | 48 |
|
65 | 49 | ### Reverse layout
|
66 | 50 |
|
|
0 commit comments