commit
						fd06fd9dd7
					
				|  | @ -3,94 +3,94 @@ | ||||||
|     <h4>Getting Started</h4> |     <h4>Getting Started</h4> | ||||||
|     <ul> |     <ul> | ||||||
|       <li class="{% if page.title == 'Welcome' %}current{% endif %}"> |       <li class="{% if page.title == 'Welcome' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/home">Welcome</a> |         <a href="{{ site.url }}/docs/home/">Welcome</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == 'Quick-start guide' %}current{% endif %}"> |       <li class="{% if page.title == 'Quick-start guide' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/quickstart">Quick-start guide</a> |         <a href="{{ site.url }}/docs/quickstart/">Quick-start guide</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == 'Installation' %}current{% endif %}"> |       <li class="{% if page.title == 'Installation' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/installation">Installation</a> |         <a href="{{ site.url }}/docs/installation/">Installation</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == 'Basic Usage' %}current{% endif %}"> |       <li class="{% if page.title == 'Basic Usage' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/usage">Basic Usage</a> |         <a href="{{ site.url }}/docs/usage/">Basic Usage</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == 'Directory structure' %}current{% endif %}"> |       <li class="{% if page.title == 'Directory structure' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/structure">Directory structure</a> |         <a href="{{ site.url }}/docs/structure/">Directory structure</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == 'Configuration' %}current{% endif %}"> |       <li class="{% if page.title == 'Configuration' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/configuration">Configuration</a> |         <a href="{{ site.url }}/docs/configuration/">Configuration</a> | ||||||
|       </li> |       </li> | ||||||
|     </ul> |     </ul> | ||||||
|     <h4>Your Content</h4> |     <h4>Your Content</h4> | ||||||
|     <ul> |     <ul> | ||||||
|       <li class="{% if page.title == 'Front-matter' %}current{% endif %}"> |       <li class="{% if page.title == 'Front-matter' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/frontmatter">Front-matter</a> |         <a href="{{ site.url }}/docs/frontmatter/">Front-matter</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == 'Writing posts' %}current{% endif %}"> |       <li class="{% if page.title == 'Writing posts' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/posts">Writing posts</a> |         <a href="{{ site.url }}/docs/posts/">Writing posts</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == 'Working with drafts' %}current{% endif %}"> |       <li class="{% if page.title == 'Working with drafts' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/drafts">Working with drafts</a> |         <a href="{{ site.url }}/docs/drafts/">Working with drafts</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == 'Creating pages' %}current{% endif %}"> |       <li class="{% if page.title == 'Creating pages' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/pages">Creating pages</a> |         <a href="{{ site.url }}/docs/pages/">Creating pages</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == 'Variables' %}current{% endif %}"> |       <li class="{% if page.title == 'Variables' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/variables">Variables</a> |         <a href="{{ site.url }}/docs/variables/">Variables</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == 'Blog migrations' %}current{% endif %}"> |       <li class="{% if page.title == 'Blog migrations' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/migrations">Blog migrations</a> |         <a href="{{ site.url }}/docs/migrations/">Blog migrations</a> | ||||||
|       </li> |       </li> | ||||||
|     </ul> |     </ul> | ||||||
|     <h4>Customization</h4> |     <h4>Customization</h4> | ||||||
|     <ul> |     <ul> | ||||||
|       <li class="{% if page.title == "Templates" %}current{% endif %}"> |       <li class="{% if page.title == 'Templates' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/templates">Templates</a> |         <a href="{{ site.url }}/docs/templates/">Templates</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == "Permalinks" %}current{% endif %}"> |       <li class="{% if page.title == 'Permalinks' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/permalinks">Permalinks</a> |         <a href="{{ site.url }}/docs/permalinks/">Permalinks</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == "Pagination" %}current{% endif %}"> |       <li class="{% if page.title == 'Pagination' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/pagination">Pagination</a> |         <a href="{{ site.url }}/docs/pagination/">Pagination</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == "Plugins" %}current{% endif %}"> |       <li class="{% if page.title == 'Plugins' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/plugins">Plugins</a> |         <a href="{{ site.url }}/docs/plugins/">Plugins</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == "Extras" %}current{% endif %}"> |       <li class="{% if page.title == 'Extras' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/extras">Extras</a> |         <a href="{{ site.url }}/docs/extras/">Extras</a> | ||||||
|       </li> |       </li> | ||||||
|     </ul> |     </ul> | ||||||
|     <h4>Deployment</h4> |     <h4>Deployment</h4> | ||||||
|     <ul> |     <ul> | ||||||
|       <li class="{% if page.title == "GitHub Pages" %}current{% endif %}"> |       <li class="{% if page.title == 'GitHub Pages' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/github-pages">GitHub Pages</a> |         <a href="{{ site.url }}/docs/github-pages/">GitHub Pages</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == "Deployment methods" %}current{% endif %}"> |       <li class="{% if page.title == 'Deployment methods' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/deployment-methods">Other methods</a> |         <a href="{{ site.url }}/docs/deployment-methods/">Other methods</a> | ||||||
|       </li> |       </li> | ||||||
|     </ul> |     </ul> | ||||||
|     <h4>Miscellaneous</h4> |     <h4>Miscellaneous</h4> | ||||||
|     <ul> |     <ul> | ||||||
|       <li class="{% if page.title == "Troubleshooting" %}current{% endif %}"> |       <li class="{% if page.title == 'Troubleshooting' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/troubleshooting">Troubleshooting</a> |         <a href="{{ site.url }}/docs/troubleshooting/">Troubleshooting</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == "Sites using Jekyll" %}current{% endif %}"> |       <li class="{% if page.title == 'Sites using Jekyll' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/sites">Sites using Jekyll</a> |         <a href="{{ site.url }}/docs/sites/">Sites using Jekyll</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == "Resources" %}current{% endif %}"> |       <li class="{% if page.title == 'Resources' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/resources">Resources</a> |         <a href="{{ site.url }}/docs/resources/">Resources</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == "Upgrading" %}current{% endif %}"> |       <li class="{% if page.title == 'Upgrading' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/upgrading">Upgrading</a> |         <a href="{{ site.url }}/docs/upgrading/">Upgrading</a> | ||||||
|       </li> |       </li> | ||||||
|     </ul> |     </ul> | ||||||
|     <h4>Meta</h4> |     <h4>Meta</h4> | ||||||
|     <ul> |     <ul> | ||||||
|       <li class="{% if page.title == "Contributing" %}current{% endif %}"> |       <li class="{% if page.title == 'Contributing' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/contributing">Contributing</a> |         <a href="{{ site.url }}/docs/contributing/">Contributing</a> | ||||||
|       </li> |       </li> | ||||||
|       <li class="{% if page.title == "History" %}current{% endif %}"> |       <li class="{% if page.title == 'History' %}current{% endif %}"> | ||||||
|         <a href="{{ site.url }}/docs/history">History</a> |         <a href="{{ site.url }}/docs/history/">History</a> | ||||||
|       </li> |       </li> | ||||||
|     </ul> |     </ul> | ||||||
|   </aside> |   </aside> | ||||||
|  |  | ||||||
|  | @ -2,41 +2,41 @@ | ||||||
|   <select onchange="if (this.value) window.location.href=this.value"> |   <select onchange="if (this.value) window.location.href=this.value"> | ||||||
|     <option value="">Navigate the docs…</option> |     <option value="">Navigate the docs…</option> | ||||||
|     <optgroup label="Getting started"> |     <optgroup label="Getting started"> | ||||||
|       <option value="{{ site.url }}/docs/home">Welcome</option> |       <option value="{{ site.url }}/docs/home/">Welcome</option> | ||||||
|       <option value="{{ site.url }}/docs/quickstart">Quick-start guide</option> |       <option value="{{ site.url }}/docs/quickstart/">Quick-start guide</option> | ||||||
|       <option value="{{ site.url }}/docs/installation">Installation</option> |       <option value="{{ site.url }}/docs/installation/">Installation</option> | ||||||
|       <option value="{{ site.url }}/docs/usage">Basic Usage</option> |       <option value="{{ site.url }}/docs/usage/">Basic Usage</option> | ||||||
|       <option value="{{ site.url }}/docs/structure">Directory structure</option> |       <option value="{{ site.url }}/docs/structure/">Directory structure</option> | ||||||
|       <option value="{{ site.url }}/docs/configuration">Configuration</option> |       <option value="{{ site.url }}/docs/configuration/">Configuration</option> | ||||||
|     </optgroup> |     </optgroup> | ||||||
|     <optgroup label="Your Content"> |     <optgroup label="Your Content"> | ||||||
|       <option value="{{ site.url }}/docs/frontmatter">Front-matter</option> |       <option value="{{ site.url }}/docs/frontmatter/">Front-matter</option> | ||||||
|       <option value="{{ site.url }}/docs/posts">Writing posts</option> |       <option value="{{ site.url }}/docs/posts/">Writing posts</option> | ||||||
|       <option value="{{ site.url }}/docs/drafts">Working with drafts</option> |       <option value="{{ site.url }}/docs/drafts/">Working with drafts</option> | ||||||
|       <option value="{{ site.url }}/docs/pages">Creating pages</option> |       <option value="{{ site.url }}/docs/pages/">Creating pages</option> | ||||||
|       <option value="{{ site.url }}/docs/variables">Variables</option> |       <option value="{{ site.url }}/docs/variables/">Variables</option> | ||||||
|       <option value="{{ site.url }}/docs/migrations">Blog migrations</option> |       <option value="{{ site.url }}/docs/migrations/">Blog migrations</option> | ||||||
|     </optgroup> |     </optgroup> | ||||||
|     <optgroup label="Customization"> |     <optgroup label="Customization"> | ||||||
|       <option value="{{ site.url }}/docs/templates">Templates</option> |       <option value="{{ site.url }}/docs/templates/">Templates</option> | ||||||
|       <option value="{{ site.url }}/docs/permalinks">Permalinks</option> |       <option value="{{ site.url }}/docs/permalinks/">Permalinks</option> | ||||||
|       <option value="{{ site.url }}/docs/pagination">Pagination</option> |       <option value="{{ site.url }}/docs/pagination/">Pagination</option> | ||||||
|       <option value="{{ site.url }}/docs/plugins">Plugins</option> |       <option value="{{ site.url }}/docs/plugins/">Plugins</option> | ||||||
|       <option value="{{ site.url }}/docs/extras">Extras</option> |       <option value="{{ site.url }}/docs/extras/">Extras</option> | ||||||
|     </optgroup> |     </optgroup> | ||||||
|     <optgroup label="Deployment"> |     <optgroup label="Deployment"> | ||||||
|       <option value="{{ site.url }}/docs/github-pages">GitHub Pages</option> |       <option value="{{ site.url }}/docs/github-pages/">GitHub Pages</option> | ||||||
|       <option value="{{ site.url }}/docs/deployment-methods">Other methods</option> |       <option value="{{ site.url }}/docs/deployment-methods/">Other methods</option> | ||||||
|     </optgroup> |     </optgroup> | ||||||
|     <optgroup label="Miscellaneous"> |     <optgroup label="Miscellaneous"> | ||||||
|       <option value="{{ site.url }}/docs/troubleshooting">Troubleshooting</option> |       <option value="{{ site.url }}/docs/troubleshooting/">Troubleshooting</option> | ||||||
|       <option value="{{ site.url }}/docs/sites">Sites using Jekyll</option> |       <option value="{{ site.url }}/docs/sites/">Sites using Jekyll</option> | ||||||
|       <option value="{{ site.url }}/docs/resources">Resources</option> |       <option value="{{ site.url }}/docs/resources/">Resources</option> | ||||||
|       <option value="{{ site.url }}/docs/upgrading">Upgrading</option> |       <option value="{{ site.url }}/docs/upgrading/">Upgrading</option> | ||||||
|     </optgroup> |     </optgroup> | ||||||
|     <optgroup label="Meta"> |     <optgroup label="Meta"> | ||||||
|       <option value="{{ site.url }}/docs/contributing">Contributing</option> |       <option value="{{ site.url }}/docs/contributing/">Contributing</option> | ||||||
|       <option value="{{ site.url }}/docs/history">History</option> |       <option value="{{ site.url }}/docs/history/">History</option> | ||||||
|     </optgroup> |     </optgroup> | ||||||
|   </select> |   </select> | ||||||
| </div> | </div> | ||||||
|  |  | ||||||
|  | @ -3,10 +3,10 @@ | ||||||
|     <a href="{{ site.url }}/">Overview</a> |     <a href="{{ site.url }}/">Overview</a> | ||||||
|   </li> |   </li> | ||||||
|   <li class="{% if page.url contains '/docs/' %}current{% endif %}"> |   <li class="{% if page.url contains '/docs/' %}current{% endif %}"> | ||||||
|     <a href="{{ site.url }}/docs/home">Doc<span class="show-on-mobiles">s</span><span class="hide-on-mobiles">umentation</span></a> |     <a href="{{ site.url }}/docs/home/">Doc<span class="show-on-mobiles">s</span><span class="hide-on-mobiles">umentation</span></a> | ||||||
|   </li> |   </li> | ||||||
|   <li class="{% if page.author %}current{% endif %}"> |   <li class="{% if page.author %}current{% endif %}"> | ||||||
|     <a href="{{ site.url }}/news">News</a> |     <a href="{{ site.url }}/news/">News</a> | ||||||
|   </li> |   </li> | ||||||
|   <li class=""> |   <li class=""> | ||||||
|     <a href="https://github.com/mojombo/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a> |     <a href="https://github.com/mojombo/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a> | ||||||
|  |  | ||||||
|  | @ -1,7 +1,7 @@ | ||||||
| <div class="section-nav"> | <div class="section-nav"> | ||||||
|   <div class="left align-right"> |   <div class="left align-right"> | ||||||
|     {% if page.prev_section != null %} |     {% if page.prev_section != null %} | ||||||
|       <a href="{{ site.url }}/docs/{{ page.prev_section }}" class="prev"> |       <a href="{{ site.url }}/docs/{{ page.prev_section }}/" class="prev"> | ||||||
|         Back |         Back | ||||||
|       </a> |       </a> | ||||||
|     {% else %} |     {% else %} | ||||||
|  | @ -10,7 +10,7 @@ | ||||||
|   </div> |   </div> | ||||||
|   <div class="right align-left"> |   <div class="right align-left"> | ||||||
|     {% if page.next_section != null %} |     {% if page.next_section != null %} | ||||||
|       <a href="{{ site.url }}/docs/{{ page.next_section }}" class="next"> |       <a href="{{ site.url }}/docs/{{ page.next_section }}/" class="next"> | ||||||
|         Next |         Next | ||||||
|       </a> |       </a> | ||||||
|     {% else %} |     {% else %} | ||||||
|  |  | ||||||
|  | @ -54,7 +54,7 @@ class="flag">flags</code> (specified on the command-line) that control them. | ||||||
|     <tr class='setting'> |     <tr class='setting'> | ||||||
|       <td> |       <td> | ||||||
|         <p class='name'><strong>Safe</strong></p> |         <p class='name'><strong>Safe</strong></p> | ||||||
|         <p class='description'>Disable <a href="../plugins">custom plugins</a>.</p> |         <p class='description'>Disable <a href="../plugins/">custom plugins</a>.</p> | ||||||
|       </td> |       </td> | ||||||
|       <td class="align-center"> |       <td class="align-center"> | ||||||
|         <p><code class="option">safe: BOOL</code></p> |         <p><code class="option">safe: BOOL</code></p> | ||||||
|  |  | ||||||
|  | @ -23,7 +23,7 @@ If you have direct access yourself to the deployment web server yourself, the pr | ||||||
| 
 | 
 | ||||||
| ## Automated methods | ## Automated methods | ||||||
| 
 | 
 | ||||||
| There are also a number of ways to easily automate the deployment of a Jekyll site. If you’ve got another method that isn’t listed below, we’d love it if you [contributed](../contributing) so that everyone else can benefit too. | There are also a number of ways to easily automate the deployment of a Jekyll site. If you’ve got another method that isn’t listed below, we’d love it if you [contributed](../contributing/) so that everyone else can benefit too. | ||||||
| 
 | 
 | ||||||
| ### Git post-update hook | ### Git post-update hook | ||||||
| 
 | 
 | ||||||
|  | @ -105,5 +105,5 @@ low-volume blogs as you only pay for what you use. | ||||||
| 
 | 
 | ||||||
| <div class="note"> | <div class="note"> | ||||||
|   <h5>ProTip™: Use GitHub Pages for zero-hassle Jekyll hosting</h5> |   <h5>ProTip™: Use GitHub Pages for zero-hassle Jekyll hosting</h5> | ||||||
|   <p>GitHub Pages are powered by Jekyll behind the scenes, so if you’re looking for a zero-hassle, zero-cost solution, GitHub Pages are a great way to <a href="../github-pages">host your Jekyll-powered website for free</a>.</p> |   <p>GitHub Pages are powered by Jekyll behind the scenes, so if you’re looking for a zero-hassle, zero-cost solution, GitHub Pages are a great way to <a href="../github-pages/">host your Jekyll-powered website for free</a>.</p> | ||||||
| </div> | </div> | ||||||
|  |  | ||||||
|  | @ -37,7 +37,7 @@ relies on. | ||||||
| <div class="note"> | <div class="note"> | ||||||
|   <h5>ProTip™: Front Matter Variables Are Optional</h5> |   <h5>ProTip™: Front Matter Variables Are Optional</h5> | ||||||
|   <p> |   <p> | ||||||
|     If you want to use <a href="../variables">Liquid tags and variables</a> but |     If you want to use <a href="../variables/">Liquid tags and variables</a> but | ||||||
|     don't need anything in your front-matter, just leave it empty! The set of |     don't need anything in your front-matter, just leave it empty! The set of | ||||||
|     triple-dashed lines with nothing in between will still get Jekyll to process |     triple-dashed lines with nothing in between will still get Jekyll to process | ||||||
|     your file. (This is useful for things like CSS and RSS feeds!) |     your file. (This is useful for things like CSS and RSS feeds!) | ||||||
|  |  | ||||||
|  | @ -42,7 +42,7 @@ $ gem install jekyll | ||||||
| 
 | 
 | ||||||
| All of Jekyll’s gem dependencies are automatically installed by the above | All of Jekyll’s gem dependencies are automatically installed by the above | ||||||
| command, so you won’t have to worry about them at all. If you have problems | command, so you won’t have to worry about them at all. If you have problems | ||||||
| installing Jekyll, check out the [troubleshooting](../troubleshooting) page or | installing Jekyll, check out the [troubleshooting](../troubleshooting/) page or | ||||||
| [report an issue](https://github.com/mojombo/jekyll/issues/new) so the Jekyll | [report an issue](https://github.com/mojombo/jekyll/issues/new) so the Jekyll | ||||||
| community can improve the experience for everyone. | community can improve the experience for everyone. | ||||||
| 
 | 
 | ||||||
|  | @ -51,7 +51,7 @@ community can improve the experience for everyone. | ||||||
| There are a number of (optional) extra features that Jekyll supports that you | There are a number of (optional) extra features that Jekyll supports that you | ||||||
| may want to install, depending on how you plan to use Jekyll. These extras | may want to install, depending on how you plan to use Jekyll. These extras | ||||||
| include LaTeX support, and the use of alternative content rendering engines. | include LaTeX support, and the use of alternative content rendering engines. | ||||||
| Check out [the extras page](../extras) for more information. | Check out [the extras page](../extras/) for more information. | ||||||
| 
 | 
 | ||||||
| <div class="note"> | <div class="note"> | ||||||
|   <h5>ProTip™: Enable Syntax Highlighting</h5> |   <h5>ProTip™: Enable Syntax Highlighting</h5> | ||||||
|  |  | ||||||
|  | @ -6,7 +6,7 @@ next_section: variables | ||||||
| permalink: /docs/pages/ | permalink: /docs/pages/ | ||||||
| --- | --- | ||||||
| 
 | 
 | ||||||
| In addition to [writing posts](../posts), another thing you may want to do with | In addition to [writing posts](../posts/), another thing you may want to do with | ||||||
| your Jekyll site is create static pages. By taking advantage of the way Jekyll | your Jekyll site is create static pages. By taking advantage of the way Jekyll | ||||||
| copies files and directories, this is easy to do. | copies files and directories, this is easy to do. | ||||||
| 
 | 
 | ||||||
|  |  | ||||||
|  | @ -7,8 +7,8 @@ permalink: /docs/permalinks/ | ||||||
| --- | --- | ||||||
| 
 | 
 | ||||||
| Jekyll supports a flexible way to build your site’s URLs. You can specify the | Jekyll supports a flexible way to build your site’s URLs. You can specify the | ||||||
| permalinks for your site through the [Configuration](../configuration) or in the | permalinks for your site through the [Configuration](../configuration/) or in the | ||||||
| [YAML Front Matter](../frontmatter) for each post. You’re free to choose one of | [YAML Front Matter](../frontmatter/) for each post. You’re free to choose one of | ||||||
| the built-in styles to create your links or craft your own. The default style is | the built-in styles to create your links or craft your own. The default style is | ||||||
| `date`. | `date`. | ||||||
| 
 | 
 | ||||||
|  |  | ||||||
|  | @ -13,7 +13,7 @@ having to modify the Jekyll source itself. | ||||||
| <div class="note info"> | <div class="note info"> | ||||||
|   <h5>Plugins on GitHub Pages</h5> |   <h5>Plugins on GitHub Pages</h5> | ||||||
|   <p> |   <p> | ||||||
|     <a href="http://pages.github.com">GitHub Pages</a> is powered by Jekyll, |     <a href="http://pages.github.com/">GitHub Pages</a> is powered by Jekyll, | ||||||
|     however all Pages sites are generated using the <code>--safe</code> option |     however all Pages sites are generated using the <code>--safe</code> option | ||||||
|     to disable custom plugins for security reasons. Unfortunately, this means |     to disable custom plugins for security reasons. Unfortunately, this means | ||||||
|     your plugins won’t work if you’re deploying to GitHub Pages.<br><br> |     your plugins won’t work if you’re deploying to GitHub Pages.<br><br> | ||||||
|  | @ -458,7 +458,7 @@ You can find a few useful plugins at the following locations: | ||||||
|   <h5>Jekyll Plugins Wanted</h5> |   <h5>Jekyll Plugins Wanted</h5> | ||||||
|   <p> |   <p> | ||||||
|     If you have a Jekyll plugin that you would like to see added to this list, |     If you have a Jekyll plugin that you would like to see added to this list, | ||||||
|     you should <a href="../contributing">read the contributing page</a> to find |     you should <a href="../contributing/">read the contributing page</a> to find | ||||||
|     out how to make that happen. |     out how to make that happen. | ||||||
|   </p> |   </p> | ||||||
| </div> | </div> | ||||||
|  |  | ||||||
|  | @ -15,11 +15,11 @@ and web-based CMS systems, this will be a welcome change! | ||||||
| 
 | 
 | ||||||
| ## The Posts Folder | ## The Posts Folder | ||||||
| 
 | 
 | ||||||
| As explained on the [directory structure](../structure) page, the `_posts` | As explained on the [directory structure](../structure/) page, the `_posts` | ||||||
| folder is where your blog posts will live. These files can be either | folder is where your blog posts will live. These files can be either | ||||||
| [Markdown](http://daringfireball.net/projects/markdown/) or | [Markdown](http://daringfireball.net/projects/markdown/) or | ||||||
| [Textile](http://textile.sitemonks.com/) formatted text files, and as long as | [Textile](http://textile.sitemonks.com/) formatted text files, and as long as | ||||||
| they have [YAML front-matter](../frontmatter), they will be converted from their | they have [YAML front-matter](../frontmatter/), they will be converted from their | ||||||
| source format into an HTML page that is part of your static site. | source format into an HTML page that is part of your static site. | ||||||
| 
 | 
 | ||||||
| ### Creating Post Files | ### Creating Post Files | ||||||
|  | @ -43,7 +43,7 @@ file. For example, the following are examples of valid post filenames: | ||||||
| 
 | 
 | ||||||
| ### Content Formats | ### Content Formats | ||||||
| 
 | 
 | ||||||
| All blog post files must begin with [YAML front- matter](../frontmatter). After | All blog post files must begin with [YAML front- matter](../frontmatter/). After | ||||||
| that, it's simply a matter of deciding which format you prefer. Jekyll supports | that, it's simply a matter of deciding which format you prefer. Jekyll supports | ||||||
| two popular content markup formats: | two popular content markup formats: | ||||||
| [Markdown](http://daringfireball.net/projects/markdown/) and | [Markdown](http://daringfireball.net/projects/markdown/) and | ||||||
|  | @ -95,7 +95,7 @@ Linking to a PDF for readers to download: | ||||||
| 
 | 
 | ||||||
| It’s all well and good to have posts in a folder, but a blog is no use unless | It’s all well and good to have posts in a folder, but a blog is no use unless | ||||||
| you have a list of posts somewhere. Creating an index of posts on another page | you have a list of posts somewhere. Creating an index of posts on another page | ||||||
| (or in a [template](../templates)) is easy, thanks to the [Liquid template | (or in a [template](../templates/)) is easy, thanks to the [Liquid template | ||||||
| language](http://wiki.shopify.com/Liquid) and its tags. Here’s a basic example of how | language](http://wiki.shopify.com/Liquid) and its tags. Here’s a basic example of how | ||||||
| to create a list of links to your blog posts: | to create a list of links to your blog posts: | ||||||
| 
 | 
 | ||||||
|  | @ -111,7 +111,7 @@ to create a list of links to your blog posts: | ||||||
| 
 | 
 | ||||||
| Of course, you have full control over how (and where) you display your posts, | Of course, you have full control over how (and where) you display your posts, | ||||||
| and how you structure your site. You should read more about [how templates | and how you structure your site. You should read more about [how templates | ||||||
| work](../templates) with Jekyll if you want to know more. | work](../templates/) with Jekyll if you want to know more. | ||||||
| 
 | 
 | ||||||
| ## Post excerpts | ## Post excerpts | ||||||
| 
 | 
 | ||||||
|  | @ -177,5 +177,5 @@ end | ||||||
| 
 | 
 | ||||||
| These basics should be enough to get you started writing your first posts. When | These basics should be enough to get you started writing your first posts. When | ||||||
| you’re ready to dig into what else is possible, you might be interested in doing | you’re ready to dig into what else is possible, you might be interested in doing | ||||||
| things like [customizing post permalinks](../permalinks) or using [custom | things like [customizing post permalinks](../permalinks/) or using [custom | ||||||
| variables](../variables) in your posts and elsewhere on your site. | variables](../variables/) in your posts and elsewhere on your site. | ||||||
|  |  | ||||||
|  | @ -53,7 +53,7 @@ An overview of what each of these does: | ||||||
|       <td> |       <td> | ||||||
|         <p> |         <p> | ||||||
| 
 | 
 | ||||||
|           Stores <a href="../configuration">configuration</a> data. Many of |           Stores <a href="../configuration/">configuration</a> data. Many of | ||||||
|           these options can be specified from the command line executable but |           these options can be specified from the command line executable but | ||||||
|           it’s easier to specify them here so you don’t have to remember them. |           it’s easier to specify them here so you don’t have to remember them. | ||||||
| 
 | 
 | ||||||
|  | @ -67,7 +67,7 @@ An overview of what each of these does: | ||||||
|       <td> |       <td> | ||||||
|         <p> |         <p> | ||||||
| 
 | 
 | ||||||
|           Drafts are unpublished posts. The format of these files is without a date: <code>title.MARKUP</code>. Learn how to <a href="../drafts">work with drafts</a>. |           Drafts are unpublished posts. The format of these files is without a date: <code>title.MARKUP</code>. Learn how to <a href="../drafts/">work with drafts</a>. | ||||||
| 
 | 
 | ||||||
|         </p> |         </p> | ||||||
|       </td> |       </td> | ||||||
|  | @ -96,7 +96,7 @@ An overview of what each of these does: | ||||||
|         <p> |         <p> | ||||||
| 
 | 
 | ||||||
|           These are the templates that wrap posts. Layouts are chosen on a post- |           These are the templates that wrap posts. Layouts are chosen on a post- | ||||||
|           by-post basis in the <a href="../frontmatter">YAML front matter</a>, |           by-post basis in the <a href="../frontmatter/">YAML front matter</a>, | ||||||
|           which is described in the next section. The liquid tag |           which is described in the next section. The liquid tag | ||||||
|           <code>{% raw %}{{ content }}{% endraw %}</code> |           <code>{% raw %}{{ content }}{% endraw %}</code> | ||||||
|           is used to inject content into the web page. |           is used to inject content into the web page. | ||||||
|  | @ -114,7 +114,7 @@ An overview of what each of these does: | ||||||
|           Your dynamic content, so to speak. The format of these files is |           Your dynamic content, so to speak. The format of these files is | ||||||
|           important, and must follow the format: |           important, and must follow the format: | ||||||
|           <code>YEAR-MONTH-DAY-title.MARKUP</code>. |           <code>YEAR-MONTH-DAY-title.MARKUP</code>. | ||||||
|           The <a href="../permalinks">permalinks</a> can be customized for each |           The <a href="../permalinks/">permalinks</a> can be customized for each | ||||||
|           post, but the date and markup language are determined solely by the |           post, but the date and markup language are determined solely by the | ||||||
|           file name. |           file name. | ||||||
| 
 | 
 | ||||||
|  | @ -142,7 +142,7 @@ An overview of what each of these does: | ||||||
|       <td> |       <td> | ||||||
|         <p> |         <p> | ||||||
| 
 | 
 | ||||||
|           Provided that the file has a <a href="../frontmatter">YAML Front |           Provided that the file has a <a href="../frontmatter/">YAML Front | ||||||
|           Matter</a> section, it will be transformed by Jekyll. The same will |           Matter</a> section, it will be transformed by Jekyll. The same will | ||||||
|           happen for any <code>.html</code>, <code>.markdown</code>, |           happen for any <code>.html</code>, <code>.markdown</code>, | ||||||
|           <code>.md</code>, or <code>.textile</code> file in your site's root |           <code>.md</code>, or <code>.textile</code> file in your site's root | ||||||
|  | @ -161,7 +161,7 @@ An overview of what each of these does: | ||||||
|           Every other directory and file except for those listed above—such as |           Every other directory and file except for those listed above—such as | ||||||
|           <code>css</code> and <code>images</code> folders, |           <code>css</code> and <code>images</code> folders, | ||||||
|           <code>favicon.ico</code> files, and so forth—will be copied verbatim |           <code>favicon.ico</code> files, and so forth—will be copied verbatim | ||||||
|           to the generated site. There are plenty of <a href="../sites">sites |           to the generated site. There are plenty of <a href="../sites/">sites | ||||||
|           already using Jekyll</a> if you're curious to see how they're laid |           already using Jekyll</a> if you're curious to see how they're laid | ||||||
|           out. |           out. | ||||||
| 
 | 
 | ||||||
|  |  | ||||||
|  | @ -84,7 +84,7 @@ http://localhost:4000/blog | ||||||
| 
 | 
 | ||||||
| ## Configuration problems | ## Configuration problems | ||||||
| 
 | 
 | ||||||
| The order of precedence for conflicting [configuration settings](../configuration) | The order of precedence for conflicting [configuration settings](../configuration/) | ||||||
| is as follows: | is as follows: | ||||||
| 
 | 
 | ||||||
| 1.  Command-line flags | 1.  Command-line flags | ||||||
|  |  | ||||||
|  | @ -35,7 +35,7 @@ $ jekyll serve --watch | ||||||
| # => As above, but watch for changes and regenerate automatically. | # => As above, but watch for changes and regenerate automatically. | ||||||
| {% endhighlight %} | {% endhighlight %} | ||||||
| 
 | 
 | ||||||
| This is just a few of the available [configuration options](../configuration). | This is just a few of the available [configuration options](../configuration/). | ||||||
| Many configuration options can either be specified as flags on the command line, | Many configuration options can either be specified as flags on the command line, | ||||||
| or alternatively (and more commonly) they can be specified in a `_config.yml` | or alternatively (and more commonly) they can be specified in a `_config.yml` | ||||||
| file at the root of the source directory. Jekyll will automatically use the | file at the root of the source directory. Jekyll will automatically use the | ||||||
|  | @ -55,4 +55,4 @@ $ jekyll build --source _source --destination _deploy | ||||||
| {% endhighlight %} | {% endhighlight %} | ||||||
| 
 | 
 | ||||||
| For more about the possible configuration options, see the | For more about the possible configuration options, see the | ||||||
| [configuration](../configuration) page. | [configuration](../configuration/) page. | ||||||
|  |  | ||||||
|  | @ -7,7 +7,7 @@ permalink: /docs/variables/ | ||||||
| --- | --- | ||||||
| 
 | 
 | ||||||
| Jekyll traverses your site looking for files to process. Any files with [YAML | Jekyll traverses your site looking for files to process. Any files with [YAML | ||||||
| Front Matter](../frontmatter) are subject to processing. For each of these | Front Matter](../frontmatter/) are subject to processing. For each of these | ||||||
| files, Jekyll makes a variety of data available via the [Liquid templating | files, Jekyll makes a variety of data available via the [Liquid templating | ||||||
| system](http://wiki.github.com/shopify/liquid/liquid-for-designers). The | system](http://wiki.github.com/shopify/liquid/liquid-for-designers). The | ||||||
| following is a reference of the available data. | following is a reference of the available data. | ||||||
|  | @ -36,7 +36,7 @@ following is a reference of the available data. | ||||||
|       <td><p><code>page</code></p></td> |       <td><p><code>page</code></p></td> | ||||||
|       <td><p> |       <td><p> | ||||||
| 
 | 
 | ||||||
|         Page specific information + the <a href="../frontmatter">YAML Front |         Page specific information + the <a href="../frontmatter/">YAML Front | ||||||
|         Matter</a>. Custom variables set via the YAML front matter will be |         Matter</a>. Custom variables set via the YAML front matter will be | ||||||
|         available here. See below for details. |         available here. See below for details. | ||||||
| 
 | 
 | ||||||
|  | @ -57,7 +57,7 @@ following is a reference of the available data. | ||||||
| 
 | 
 | ||||||
|         When the <code>paginate</code> configuration option is set, this |         When the <code>paginate</code> configuration option is set, this | ||||||
|         variable becomes available for use. See <a |         variable becomes available for use. See <a | ||||||
|         href="../pagination">Pagination</a> for details. |         href="../pagination/">Pagination</a> for details. | ||||||
| 
 | 
 | ||||||
|       </p></td> |       </p></td> | ||||||
|     </tr> |     </tr> | ||||||
|  | @ -221,7 +221,7 @@ following is a reference of the available data. | ||||||
|         directory. For example, a post at |         directory. For example, a post at | ||||||
|         <code>/work/code/_posts/2008-12-24-closures.md</code> would have this |         <code>/work/code/_posts/2008-12-24-closures.md</code> would have this | ||||||
|         field set to <code>['work', 'code']</code>. These can also be specified |         field set to <code>['work', 'code']</code>. These can also be specified | ||||||
|         in the <a href="../frontmatter">YAML Front Matter</a>. |         in the <a href="../frontmatter/">YAML Front Matter</a>. | ||||||
| 
 | 
 | ||||||
|       </p></td> |       </p></td> | ||||||
|     </tr> |     </tr> | ||||||
|  | @ -230,7 +230,7 @@ following is a reference of the available data. | ||||||
|       <td><p> |       <td><p> | ||||||
| 
 | 
 | ||||||
|         The list of tags to which this post belongs. These can be specified in |         The list of tags to which this post belongs. These can be specified in | ||||||
|         the <a href="../frontmatter">YAML Front Matter</a>. |         the <a href="../frontmatter/">YAML Front Matter</a>. | ||||||
| 
 | 
 | ||||||
|       </p></td> |       </p></td> | ||||||
|     </tr> |     </tr> | ||||||
|  | @ -240,7 +240,7 @@ following is a reference of the available data. | ||||||
| 
 | 
 | ||||||
|         The path to the raw post or page. Example usage: Linking back to the |         The path to the raw post or page. Example usage: Linking back to the | ||||||
|         page or post's source on GitHub. This can be overridden in the |         page or post's source on GitHub. This can be overridden in the | ||||||
|         <a href="../frontmatter">YAML Front Matter</a>. |         <a href="../frontmatter/">YAML Front Matter</a>. | ||||||
| 
 | 
 | ||||||
|       </p></td> |       </p></td> | ||||||
|     </tr> |     </tr> | ||||||
|  |  | ||||||
|  | @ -18,19 +18,19 @@ overview: true | ||||||
|       <p> |       <p> | ||||||
|         No more databases, comment moderation, or pesky updates to install—just <em>your content</em>. |         No more databases, comment moderation, or pesky updates to install—just <em>your content</em>. | ||||||
|       </p> |       </p> | ||||||
|       <a href="/docs/usage" class="">How Jekyll works →</a> |       <a href="/docs/usage/" class="">How Jekyll works →</a> | ||||||
|     </div> |     </div> | ||||||
|     <div class="unit one-third"> |     <div class="unit one-third"> | ||||||
|       <h2>Static</h2> |       <h2>Static</h2> | ||||||
|       <p><a href="http://daringfireball.net/projects/markdown/">Markdown</a> (or <a href="http://textile.sitemonks.com/">Textile</a>), <a href="http://wiki.shopify.com/Liquid">Liquid</a>, HTML <span class="amp">&</span> CSS go in. Static sites come out ready for deployment.</p> |       <p><a href="http://daringfireball.net/projects/markdown/">Markdown</a> (or <a href="http://textile.sitemonks.com/">Textile</a>), <a href="http://wiki.shopify.com/Liquid">Liquid</a>, HTML <span class="amp">&</span> CSS go in. Static sites come out ready for deployment.</p> | ||||||
|       <a href="/docs/templates" class="">Jekyll template guide →</a> |       <a href="/docs/templates/" class="">Jekyll template guide →</a> | ||||||
|     </div> |     </div> | ||||||
|     <div class="unit one-third"> |     <div class="unit one-third"> | ||||||
|       <h2>Blog-aware</h2> |       <h2>Blog-aware</h2> | ||||||
|       <p> |       <p> | ||||||
|         Permalinks, categories, pages, posts, and custom layouts are all first-class citizens here. |         Permalinks, categories, pages, posts, and custom layouts are all first-class citizens here. | ||||||
|       </p> |       </p> | ||||||
|       <a href="/docs/migrations" class="">Migrate your blog →</a> |       <a href="/docs/migrations/" class="">Migrate your blog →</a> | ||||||
|     </div> |     </div> | ||||||
|     <div class="clear"></div> |     <div class="clear"></div> | ||||||
|   </div> |   </div> | ||||||
|  |  | ||||||
		Loading…
	
		Reference in New Issue