jekyll-docs 3.2.1 → 3.3.0

data/site/docs/posts/index.html

@@ -4,7 +4,7 @@
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width,initial-scale=1">
-  <meta name="generator" content="Jekyll v3.2.1">
+  <meta name="generator" content="Jekyll v3.3.0">
   <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
   <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
   <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
@@ -19,7 +19,7 @@
 <meta property="og:url" content="https://jekyllrb.com/docs/posts/">
 <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
 <meta property="og:type" content="article">
-<meta property="article:published_time" content="2016-08-02T18:14:35-07:00">
+<meta property="article:published_time" content="2016-10-06T11:16:34-07:00">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:site" content="@jekyllrb">
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
@@ -28,9 +28,9 @@
     "@context": "http://schema.org",
     "@type": "BlogPosting",
     "headline": "Writing posts",
-    "datePublished": "2016-08-02T18:14:35-07:00",
+    "datePublished": "2016-10-06T11:16:34-07:00",
     "description": "One of Jekyll’s best aspects is that it is “blog aware”. What does this mean,exactly? Well, simply put, it means that blogging is baked into Jekyll’sfunctionality. If you write articles and publish them online, you can publishand maintain a blog simply by managing a folder of text-files on your computer.Compared to the hassle of configuring and maintaining databases and web-basedCMS systems, this will be a welcome change!",
-    "logo": "https://jekyllrb.comimg/logo-2x.png",
+    "logo": "https://jekyllrb.com/img/logo-2x.png",
     "url": "https://jekyllrb.com/docs/posts/"
   }
 </script>
@@ -114,27 +114,27 @@
       
   
   
-  <option value="https://jekyllrb.com/docs/home/">Welcome</option>
+  <option value="/docs/home/">Welcome</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/quickstart/">Quick-start guide</option>
+  <option value="/docs/quickstart/">Quick-start guide</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/installation/">Installation</option>
+  <option value="/docs/installation/">Installation</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/usage/">Basic Usage</option>
+  <option value="/docs/usage/">Basic Usage</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/structure/">Directory structure</option>
+  <option value="/docs/structure/">Directory structure</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/configuration/">Configuration</option>
+  <option value="/docs/configuration/">Configuration</option>
 
 
     </optgroup>
@@ -143,43 +143,43 @@
       
   
   
-  <option value="https://jekyllrb.com/docs/frontmatter/">Front Matter</option>
+  <option value="/docs/frontmatter/">Front Matter</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/posts/">Writing posts</option>
+  <option value="/docs/posts/">Writing posts</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/drafts/">Working with drafts</option>
+  <option value="/docs/drafts/">Working with drafts</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/pages/">Creating pages</option>
+  <option value="/docs/pages/">Creating pages</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/static-files/">Static Files</option>
+  <option value="/docs/static-files/">Static Files</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/variables/">Variables</option>
+  <option value="/docs/variables/">Variables</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/collections/">Collections</option>
+  <option value="/docs/collections/">Collections</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/datafiles/">Data Files</option>
+  <option value="/docs/datafiles/">Data Files</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/assets/">Assets</option>
+  <option value="/docs/assets/">Assets</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/migrations/">Blog migrations</option>
+  <option value="/docs/migrations/">Blog migrations</option>
 
 
     </optgroup>
@@ -188,27 +188,27 @@
       
   
   
-  <option value="https://jekyllrb.com/docs/templates/">Templates</option>
+  <option value="/docs/templates/">Templates</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/permalinks/">Permalinks</option>
+  <option value="/docs/permalinks/">Permalinks</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/pagination/">Pagination</option>
+  <option value="/docs/pagination/">Pagination</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/plugins/">Plugins</option>
+  <option value="/docs/plugins/">Plugins</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/themes/">Themes</option>
+  <option value="/docs/themes/">Themes</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/extras/">Extras</option>
+  <option value="/docs/extras/">Extras</option>
 
 
     </optgroup>
@@ -217,15 +217,15 @@
       
   
   
-  <option value="https://jekyllrb.com/docs/github-pages/">GitHub Pages</option>
+  <option value="/docs/github-pages/">GitHub Pages</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</option>
+  <option value="/docs/deployment-methods/">Deployment methods</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</option>
+  <option value="/docs/continuous-integration/">Continuous Integration</option>
 
 
     </optgroup>
@@ -234,23 +234,23 @@
       
   
   
-  <option value="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</option>
+  <option value="/docs/troubleshooting/">Troubleshooting</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/sites/">Sites using Jekyll</option>
+  <option value="/docs/sites/">Sites using Jekyll</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/resources/">Resources</option>
+  <option value="/docs/resources/">Resources</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
+  <option value="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
+  <option value="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
 
 
     </optgroup>
@@ -259,15 +259,15 @@
       
   
   
-  <option value="https://jekyllrb.com/docs/contributing/">Contributing</option>
+  <option value="/docs/contributing/">Contributing</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/conduct/">Code of Conduct</option>
+  <option value="/docs/conduct/">Code of Conduct</option>
 
   
   
-  <option value="https://jekyllrb.com/docs/history/">History</option>
+  <option value="/docs/history/">History</option>
 
 
     </optgroup>
@@ -305,14 +305,20 @@ static site.</p>
 directory. How you name files in this folder is important. Jekyll requires blog
 post files to be named according to the following format:</p>
 
-<figure class="highlight"><pre><code class="language-shell" data-lang="shell">YEAR-MONTH-DAY-title.MARKUP</code></pre></figure>
+<div class="language-sh highlighter-rouge">
+<pre class="highlight"><code>YEAR-MONTH-DAY-title.MARKUP
+</code></pre>
+</div>
 
 <p>Where <code class="highlighter-rouge">YEAR</code> is a four-digit number, <code class="highlighter-rouge">MONTH</code> and <code class="highlighter-rouge">DAY</code> are both two-digit
 numbers, and <code class="highlighter-rouge">MARKUP</code> is the file extension representing the format used in the
 file. For example, the following are examples of valid post filenames:</p>
 
-<figure class="highlight"><pre><code class="language-shell" data-lang="shell">2011-12-31-new-years-eve-is-awesome.md
-2012-09-12-how-to-write-a-blog.textile</code></pre></figure>
+<div class="language-sh highlighter-rouge">
+<pre class="highlight"><code>2011-12-31-new-years-eve-is-awesome.md
+2012-09-12-how-to-write-a-blog.md
+</code></pre>
+</div>
 
 <div class="note">
   <h5>ProTip™: Link to other posts</h5>
@@ -364,12 +370,18 @@ variable in a post.</p>
 
 <p>Including an image asset in a post:</p>
 
-<figure class="highlight"><pre><code class="language-text" data-lang="text">... which is shown in the screenshot below:
-![My helpful screenshot]({{ site.url }}/assets/screenshot.jpg)</code></pre></figure>
+<div class="language-text highlighter-rouge">
+<pre class="highlight"><code>... which is shown in the screenshot below:
+![My helpful screenshot]({{ site.url }}/assets/screenshot.jpg)
+</code></pre>
+</div>
 
 <p>Linking to a PDF for readers to download:</p>
 
-<figure class="highlight"><pre><code class="language-text" data-lang="text">... you can [get the PDF]({{ site.url }}/assets/mydoc.pdf) directly.</code></pre></figure>
+<div class="language-text highlighter-rouge">
+<pre class="highlight"><code>... you can [get the PDF]({{ site.url }}/assets/mydoc.pdf) directly.
+</code></pre>
+</div>
 
 <div class="note">
   <h5>ProTip™: Link using just the site root URL</h5>
@@ -389,13 +401,16 @@ you have a list of posts somewhere. Creating an index of posts on another page
 language</a> and its tags. Here’s a
 basic example of how to create a list of links to your blog posts:</p>
 
-<figure class="highlight"><pre><code class="language-html" data-lang="html"><span class="nt">&lt;ul&gt;</span>
+<div class="language-html highlighter-rouge">
+<pre class="highlight"><code><span class="nt">&lt;ul&gt;</span>
   {% for post in site.posts %}
     <span class="nt">&lt;li&gt;</span>
       <span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"{{ post.url }}"</span><span class="nt">&gt;</span>{{ post.title }}<span class="nt">&lt;/a&gt;</span>
     <span class="nt">&lt;/li&gt;</span>
   {% endfor %}
-<span class="nt">&lt;/ul&gt;</span></code></pre></figure>
+<span class="nt">&lt;/ul&gt;</span>
+</code></pre>
+</div>
 
 <p>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 <a href="../templates/">how templates
@@ -414,33 +429,42 @@ Take the above example of an index of posts. Perhaps you want to include
 a little hint about the post’s content by adding the first paragraph of each of
 your posts:</p>
 
-<figure class="highlight"><pre><code class="language-html" data-lang="html"><span class="nt">&lt;ul&gt;</span>
+<div class="language-html highlighter-rouge">
+<pre class="highlight"><code><span class="nt">&lt;ul&gt;</span>
   {% for post in site.posts %}
     <span class="nt">&lt;li&gt;</span>
       <span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"{{ post.url }}"</span><span class="nt">&gt;</span>{{ post.title }}<span class="nt">&lt;/a&gt;</span>
       {{ post.excerpt }}
     <span class="nt">&lt;/li&gt;</span>
   {% endfor %}
-<span class="nt">&lt;/ul&gt;</span></code></pre></figure>
+<span class="nt">&lt;/ul&gt;</span>
+</code></pre>
+</div>
 
 <p>Because Jekyll grabs the first paragraph you will not need to wrap the excerpt
 in <code class="highlighter-rouge">p</code> tags, which is already done for you. These tags can be removed with the
 following if you’d prefer:</p>
 
-<figure class="highlight"><pre><code class="language-html" data-lang="html">{{ post.excerpt | remove: '<span class="nt">&lt;p&gt;</span>' | remove: '<span class="nt">&lt;/p&gt;</span>' }}</code></pre></figure>
+<div class="language-html highlighter-rouge">
+<pre class="highlight"><code>{{ post.excerpt | remove: '<span class="nt">&lt;p&gt;</span>' | remove: '<span class="nt">&lt;/p&gt;</span>' }}
+</code></pre>
+</div>
 
 <p>If you don’t like the automatically-generated post excerpt, it can be
 explicitly overridden by adding an <code class="highlighter-rouge">excerpt</code> value to your post’s YAML
 Front Matter. Alternatively, you can choose to define a custom
 <code class="highlighter-rouge">excerpt_separator</code> in the post’s YAML front matter:</p>
 
-<figure class="highlight"><pre><code class="language-text" data-lang="text">---
+<div class="language-text highlighter-rouge">
+<pre class="highlight"><code>---
 excerpt_separator: &lt;!--more--&gt;
 ---
 
 Excerpt
 &lt;!--more--&gt;
-Out-of-excerpt</code></pre></figure>
+Out-of-excerpt
+</code></pre>
+</div>
 
 <p>You can also set the <code class="highlighter-rouge">excerpt_separator</code> globally in your <code class="highlighter-rouge">_config.yml</code>
 configuration file.</p>
@@ -459,7 +483,8 @@ html tags along with the content is not desirable.</p>
 either Pygments or Rouge, and including a code snippet in any post is easy.
 Just use the dedicated Liquid tag as follows:</p>
 
-<figure class="highlight"><pre><code class="language-text" data-lang="text">{% highlight ruby %}
+<div class="language-text highlighter-rouge">
+<pre class="highlight"><code>{% highlight ruby %}
 def show
   @widget = Widget(params[:id])
   respond_to do |format|
@@ -467,17 +492,22 @@ def show
     format.json { render json: @widget }
   end
 end
-{% endhighlight %}</code></pre></figure>
+{% endhighlight %}
+</code></pre>
+</div>
 
 <p>And the output will look like this:</p>
 
-<figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="k">def</span> <span class="nf">show</span>
+<div class="language-ruby highlighter-rouge">
+<pre class="highlight"><code><span class="k">def</span> <span class="nf">show</span>
   <span class="vi">@widget</span> <span class="o">=</span> <span class="no">Widget</span><span class="p">(</span><span class="n">params</span><span class="p">[</span><span class="ss">:id</span><span class="p">])</span>
   <span class="n">respond_to</span> <span class="k">do</span> <span class="o">|</span><span class="nb">format</span><span class="o">|</span>
     <span class="nb">format</span><span class="p">.</span><span class="nf">html</span> <span class="c1"># show.html.erb</span>
     <span class="nb">format</span><span class="p">.</span><span class="nf">json</span> <span class="p">{</span> <span class="n">render</span> <span class="ss">json: </span><span class="vi">@widget</span> <span class="p">}</span>
   <span class="k">end</span>
-<span class="k">end</span></code></pre></figure>
+<span class="k">end</span>
+</code></pre>
+</div>
 
 <div class="note">
   <h5>ProTip™: Show line numbers</h5>
@@ -552,27 +582,27 @@ site.</p>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/home/">Welcome</a></li>
+  <li class=""><a href="/docs/home/">Welcome</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/quickstart/">Quick-start guide</a></li>
+  <li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/installation/">Installation</a></li>
+  <li class=""><a href="/docs/installation/">Installation</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/usage/">Basic Usage</a></li>
+  <li class=""><a href="/docs/usage/">Basic Usage</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/structure/">Directory structure</a></li>
+  <li class=""><a href="/docs/structure/">Directory structure</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/configuration/">Configuration</a></li>
+  <li class=""><a href="/docs/configuration/">Configuration</a></li>
 
 </ul>
 
@@ -582,43 +612,43 @@ site.</p>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/frontmatter/">Front Matter</a></li>
+  <li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
 
   
   
-  <li class="current"><a href="https://jekyllrb.com/docs/posts/">Writing posts</a></li>
+  <li class="current"><a href="/docs/posts/">Writing posts</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/drafts/">Working with drafts</a></li>
+  <li class=""><a href="/docs/drafts/">Working with drafts</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/pages/">Creating pages</a></li>
+  <li class=""><a href="/docs/pages/">Creating pages</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/static-files/">Static Files</a></li>
+  <li class=""><a href="/docs/static-files/">Static Files</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/variables/">Variables</a></li>
+  <li class=""><a href="/docs/variables/">Variables</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/collections/">Collections</a></li>
+  <li class=""><a href="/docs/collections/">Collections</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/datafiles/">Data Files</a></li>
+  <li class=""><a href="/docs/datafiles/">Data Files</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/assets/">Assets</a></li>
+  <li class=""><a href="/docs/assets/">Assets</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/migrations/">Blog migrations</a></li>
+  <li class=""><a href="/docs/migrations/">Blog migrations</a></li>
 
 </ul>
 
@@ -628,27 +658,27 @@ site.</p>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/templates/">Templates</a></li>
+  <li class=""><a href="/docs/templates/">Templates</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/permalinks/">Permalinks</a></li>
+  <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/pagination/">Pagination</a></li>
+  <li class=""><a href="/docs/pagination/">Pagination</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/plugins/">Plugins</a></li>
+  <li class=""><a href="/docs/plugins/">Plugins</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/themes/">Themes</a></li>
+  <li class=""><a href="/docs/themes/">Themes</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/extras/">Extras</a></li>
+  <li class=""><a href="/docs/extras/">Extras</a></li>
 
 </ul>
 
@@ -658,15 +688,15 @@ site.</p>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/github-pages/">GitHub Pages</a></li>
+  <li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</a></li>
+  <li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</a></li>
+  <li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
 
 </ul>
 
@@ -676,23 +706,23 @@ site.</p>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</a></li>
+  <li class=""><a href="/docs/troubleshooting/">Troubleshooting</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/sites/">Sites using Jekyll</a></li>
+  <li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/resources/">Resources</a></li>
+  <li class=""><a href="/docs/resources/">Resources</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
+  <li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
+  <li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
 
 </ul>
 
@@ -702,15 +732,15 @@ site.</p>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/contributing/">Contributing</a></li>
+  <li class=""><a href="/docs/contributing/">Contributing</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/conduct/">Code of Conduct</a></li>
+  <li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
 
   
   
-  <li class=""><a href="https://jekyllrb.com/docs/history/">History</a></li>
+  <li class=""><a href="/docs/history/">History</a></li>
 
 </ul>