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