jekyll-docs 3.2.1 → 3.3.0

data/site/docs/collections/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/collections/">
 <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": "Collections",
-    "datePublished": "2016-08-02T18:14:35-07:00",
+    "datePublished": "2016-10-06T11:16:34-07:00",
     "description": "Not everything is a post or a page. Maybe you want to document the variousmethods in your open source project, members of a team, or talks at aconference. Collections allow you to define a new type of document that behavelike Pages or Posts do normally, but also have their own unique properties andnamespace.",
-    "logo": "https://jekyllrb.comimg/logo-2x.png",
+    "logo": "https://jekyllrb.com/img/logo-2x.png",
     "url": "https://jekyllrb.com/docs/collections/"
   }
 </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>
@@ -295,23 +295,32 @@ namespace.</p>
 <p>Add the following to your site’s <code class="highlighter-rouge">_config.yml</code> file, replacing <code class="highlighter-rouge">my_collection</code>
 with the name of your collection:</p>
 
-<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">collections</span><span class="pi">:</span>
-<span class="pi">-</span> <span class="s">my_collection</span></code></pre></figure>
+<div class="language-yaml highlighter-rouge">
+<pre class="highlight"><code><span class="s">collections</span><span class="pi">:</span>
+<span class="pi">-</span> <span class="s">my_collection</span>
+</code></pre>
+</div>
 
 <p>You can optionally specify metadata for your collection in the configuration:</p>
 
-<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">collections</span><span class="pi">:</span>
+<div class="language-yaml highlighter-rouge">
+<pre class="highlight"><code><span class="s">collections</span><span class="pi">:</span>
   <span class="s">my_collection</span><span class="pi">:</span>
-    <span class="s">foo</span><span class="pi">:</span> <span class="s">bar</span></code></pre></figure>
+    <span class="s">foo</span><span class="pi">:</span> <span class="s">bar</span>
+</code></pre>
+</div>
 
 <p>Default attributes can also be set for a collection:</p>
 
-<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">defaults</span><span class="pi">:</span>
+<div class="language-yaml highlighter-rouge">
+<pre class="highlight"><code><span class="s">defaults</span><span class="pi">:</span>
   <span class="pi">-</span> <span class="s">scope</span><span class="pi">:</span>
       <span class="s">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span>
       <span class="s">type</span><span class="pi">:</span> <span class="s">my_collection</span>
     <span class="s">values</span><span class="pi">:</span>
-      <span class="s">layout</span><span class="pi">:</span> <span class="s">page</span></code></pre></figure>
+      <span class="s">layout</span><span class="pi">:</span> <span class="s">page</span>
+</code></pre>
+</div>
 
 <h3 id="step-2-add-your-content">Step 2: Add your content</h3>
 
@@ -334,9 +343,12 @@ your <code>_config.yml</code> file, with the addition of the preceding <code>_</
 document in your collection, set the <code class="highlighter-rouge">output</code> key to <code class="highlighter-rouge">true</code> in your collection
 metadata in your <code class="highlighter-rouge">_config.yml</code>:</p>
 
-<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">collections</span><span class="pi">:</span>
+<div class="language-yaml highlighter-rouge">
+<pre class="highlight"><code><span class="s">collections</span><span class="pi">:</span>
   <span class="s">my_collection</span><span class="pi">:</span>
-    <span class="s">output</span><span class="pi">:</span> <span class="s">true</span></code></pre></figure>
+    <span class="s">output</span><span class="pi">:</span> <span class="s">true</span>
+</code></pre>
+</div>
 
 <p>This will produce a file for each document in the collection.
 For example, if you have <code class="highlighter-rouge">_my_collection/some_subdir/some_doc.md</code>,
@@ -346,10 +358,13 @@ choice and written out to <code class="highlighter-rouge">&lt;dest&gt;/my_collec
 <p>As for posts with <a href="../permalinks/">Permalinks</a>, the document
 URL can be customized by setting <code class="highlighter-rouge">permalink</code> metadata for the collection:</p>
 
-<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">collections</span><span class="pi">:</span>
+<div class="language-yaml highlighter-rouge">
+<pre class="highlight"><code><span class="s">collections</span><span class="pi">:</span>
   <span class="s">my_collection</span><span class="pi">:</span>
     <span class="s">output</span><span class="pi">:</span> <span class="s">true</span>
-    <span class="s">permalink</span><span class="pi">:</span> <span class="s">/awesome/:path/</span></code></pre></figure>
+    <span class="s">permalink</span><span class="pi">:</span> <span class="s">/awesome/:path/</span>
+</code></pre>
+</div>
 
 <p>For example, if you have <code class="highlighter-rouge">_my_collection/some_subdir/some_doc.md</code>, it will be
 written out to <code class="highlighter-rouge">&lt;dest&gt;/awesome/some_subdir/some_doc/index.html</code>.</p>
@@ -606,7 +621,8 @@ one might have front matter in an individual file structured as follows (which
 must use a supported markup format, and cannot be saved with a <code class="highlighter-rouge">.yaml</code>
 extension):</p>
 
-<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Josquin:</span><span class="nv"> </span><span class="s">Missa</span><span class="nv"> </span><span class="s">De</span><span class="nv"> </span><span class="s">beata</span><span class="nv"> </span><span class="s">virgine</span><span class="nv"> </span><span class="s">and</span><span class="nv"> </span><span class="s">Missa</span><span class="nv"> </span><span class="s">Ave</span><span class="nv"> </span><span class="s">maris</span><span class="nv"> </span><span class="s">stella"</span>
+<div class="language-yaml highlighter-rouge">
+<pre class="highlight"><code><span class="s">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Josquin:</span><span class="nv"> </span><span class="s">Missa</span><span class="nv"> </span><span class="s">De</span><span class="nv"> </span><span class="s">beata</span><span class="nv"> </span><span class="s">virgine</span><span class="nv"> </span><span class="s">and</span><span class="nv"> </span><span class="s">Missa</span><span class="nv"> </span><span class="s">Ave</span><span class="nv"> </span><span class="s">maris</span><span class="nv"> </span><span class="s">stella"</span>
 <span class="s">artist</span><span class="pi">:</span> <span class="s2">"</span><span class="s">The</span><span class="nv"> </span><span class="s">Tallis</span><span class="nv"> </span><span class="s">Scholars"</span>
 <span class="s">director</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Peter</span><span class="nv"> </span><span class="s">Phillips"</span>
 <span class="s">works</span><span class="pi">:</span>
@@ -622,11 +638,15 @@ extension):</p>
       <span class="pi">-</span> <span class="s">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Sanctus</span><span class="nv"> </span><span class="s">&amp;</span><span class="nv"> </span><span class="s">Benedictus"</span>
         <span class="s">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">7:47"</span>
       <span class="pi">-</span> <span class="s">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Agnus</span><span class="nv"> </span><span class="s">Dei</span><span class="nv"> </span><span class="s">I,</span><span class="nv"> </span><span class="s">II</span><span class="nv"> </span><span class="s">&amp;</span><span class="nv"> </span><span class="s">III"</span>
-        <span class="s">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">6:49"</span></code></pre></figure>
+        <span class="s">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">6:49"</span>
+</code></pre>
+</div>
 
 <p>Every album in the collection could be listed on a single page with a template:</p>
 
-<figure class="highlight"><pre><code class="language-html" data-lang="html">{% for album in site.albums %}
+<div class="language-html highlighter-rouge">
+<pre class="highlight"><code>
+{% for album in site.albums %}
   <span class="nt">&lt;h2&gt;</span>{{ album.title }}<span class="nt">&lt;/h2&gt;</span>
   <span class="nt">&lt;p&gt;</span>Performed by {{ album.artist }}{% if album.director %}, directed by {{ album.director }}{% endif %}<span class="nt">&lt;/p&gt;</span>
   {% for work in album.works %}
@@ -638,8 +658,10 @@ extension):</p>
     {% endfor %}
     <span class="nt">&lt;/ul&gt;</span>
   {% endfor %}
-{% endfor %}</code></pre></figure>
+{% endfor %}
 
+</code></pre>
+</div>
 
           
 
@@ -714,27 +736,27 @@ extension):</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>
 
@@ -744,43 +766,43 @@ extension):</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=""><a href="https://jekyllrb.com/docs/posts/">Writing posts</a></li>
+  <li class=""><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="current"><a href="https://jekyllrb.com/docs/collections/">Collections</a></li>
+  <li class="current"><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>
 
@@ -790,27 +812,27 @@ extension):</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>
 
@@ -820,15 +842,15 @@ extension):</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>
 
@@ -838,23 +860,23 @@ extension):</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>
 
@@ -864,15 +886,15 @@ extension):</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>