RubyGems - jekyll-docs - Versions diffs - 3.6.0 → 3.6.1 - Mend

jekyll-docs 3.6.0 → 3.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (253) hide show

checksums.yaml +4 -4
data/lib/jekyll.rb +195 -0
data/lib/jekyll/cleaner.rb +110 -0
data/lib/jekyll/collection.rb +230 -0
data/lib/jekyll/command.rb +78 -0
data/lib/jekyll/commands/build.rb +102 -0
data/lib/jekyll/commands/clean.rb +43 -0
data/lib/jekyll/commands/doctor.rb +153 -0
data/lib/jekyll/commands/help.rb +34 -0
data/lib/jekyll/commands/new.rb +156 -0
data/lib/jekyll/commands/new_theme.rb +40 -0
data/lib/jekyll/commands/serve.rb +245 -0
data/lib/jekyll/commands/serve/servlet.rb +62 -0
data/lib/jekyll/configuration.rb +410 -0
data/lib/jekyll/converter.rb +54 -0
data/lib/jekyll/converters/identity.rb +23 -0
data/lib/jekyll/converters/markdown.rb +104 -0
data/lib/jekyll/converters/markdown/kramdown_parser.rb +123 -0
data/lib/jekyll/converters/markdown/rdiscount_parser.rb +35 -0
data/lib/jekyll/converters/markdown/redcarpet_parser.rb +108 -0
data/lib/jekyll/converters/smartypants.rb +36 -0
data/lib/jekyll/convertible.rb +251 -0
data/lib/jekyll/deprecator.rb +52 -0
data/lib/jekyll/document.rb +507 -0
data/lib/jekyll/drops/collection_drop.rb +22 -0
data/lib/jekyll/drops/document_drop.rb +69 -0
data/lib/jekyll/drops/drop.rb +214 -0
data/lib/jekyll/drops/excerpt_drop.rb +15 -0
data/lib/jekyll/drops/jekyll_drop.rb +33 -0
data/lib/jekyll/drops/site_drop.rb +47 -0
data/lib/jekyll/drops/static_file_drop.rb +13 -0
data/lib/jekyll/drops/unified_payload_drop.rb +25 -0
data/lib/jekyll/drops/url_drop.rb +88 -0
data/lib/jekyll/entry_filter.rb +123 -0
data/lib/jekyll/errors.rb +20 -0
data/lib/jekyll/excerpt.rb +126 -0
data/lib/jekyll/external.rb +74 -0
data/lib/jekyll/filters.rb +430 -0
data/lib/jekyll/filters/grouping_filters.rb +65 -0
data/lib/jekyll/filters/url_filters.rb +60 -0
data/lib/jekyll/frontmatter_defaults.rb +197 -0
data/lib/jekyll/generator.rb +5 -0
data/lib/jekyll/hooks.rb +104 -0
data/lib/jekyll/layout.rb +62 -0
data/lib/jekyll/liquid_extensions.rb +24 -0
data/lib/jekyll/liquid_renderer.rb +49 -0
data/lib/jekyll/liquid_renderer/file.rb +56 -0
data/lib/jekyll/liquid_renderer/table.rb +96 -0
data/lib/jekyll/log_adapter.rb +147 -0
data/lib/jekyll/mime.types +825 -0
data/lib/jekyll/page.rb +187 -0
data/lib/jekyll/plugin.rb +98 -0
data/lib/jekyll/plugin_manager.rb +113 -0
data/lib/jekyll/publisher.rb +23 -0
data/lib/jekyll/reader.rb +134 -0
data/lib/jekyll/readers/collection_reader.rb +22 -0
data/lib/jekyll/readers/data_reader.rb +77 -0
data/lib/jekyll/readers/layout_reader.rb +71 -0
data/lib/jekyll/readers/page_reader.rb +25 -0
data/lib/jekyll/readers/post_reader.rb +72 -0
data/lib/jekyll/readers/static_file_reader.rb +25 -0
data/lib/jekyll/readers/theme_assets_reader.rb +49 -0
data/lib/jekyll/regenerator.rb +201 -0
data/lib/jekyll/related_posts.rb +52 -0
data/lib/jekyll/renderer.rb +269 -0
data/lib/jekyll/site.rb +471 -0
data/lib/jekyll/static_file.rb +162 -0
data/lib/jekyll/stevenson.rb +61 -0
data/lib/jekyll/tags/highlight.rb +141 -0
data/lib/jekyll/tags/include.rb +215 -0
data/lib/jekyll/tags/link.rb +37 -0
data/lib/jekyll/tags/post_url.rb +103 -0
data/lib/jekyll/theme.rb +68 -0
data/lib/jekyll/theme_builder.rb +119 -0
data/lib/jekyll/url.rb +161 -0
data/lib/jekyll/utils.rb +337 -0
data/lib/jekyll/utils/ansi.rb +59 -0
data/lib/jekyll/utils/exec.rb +27 -0
data/lib/jekyll/utils/platforms.rb +82 -0
data/lib/jekyll/utils/rouge.rb +21 -0
data/lib/jekyll/utils/win_tz.rb +75 -0
data/lib/jekyll/version.rb +5 -0
data/lib/site_template/404.html +24 -0
data/lib/site_template/_config.yml +43 -0
data/lib/site_template/_posts/0000-00-00-welcome-to-jekyll.markdown.erb +25 -0
data/lib/site_template/about.md +18 -0
data/lib/site_template/index.md +6 -0
data/lib/theme_template/CODE_OF_CONDUCT.md.erb +74 -0
data/lib/theme_template/Gemfile +4 -0
data/lib/theme_template/LICENSE.txt.erb +21 -0
data/lib/theme_template/README.md.erb +52 -0
data/lib/theme_template/_layouts/default.html +1 -0
data/lib/theme_template/_layouts/page.html +5 -0
data/lib/theme_template/_layouts/post.html +5 -0
data/lib/theme_template/example/_config.yml.erb +1 -0
data/lib/theme_template/example/_post.md +12 -0
data/lib/theme_template/example/index.html +14 -0
data/lib/theme_template/example/style.scss +7 -0
data/lib/theme_template/gitignore.erb +5 -0
data/lib/theme_template/theme.gemspec.erb +19 -0
metadata +103 -156
data/lib/jekyll-docs.rb +0 -31
data/site/404.html +0 -153
data/site/CNAME +0 -1
data/site/community/index.html +0 -299
data/site/conduct/index.html +0 -10
data/site/css/screen.css +0 -1
data/site/docs/assets/index.html +0 -724
data/site/docs/code_of_conduct/index.html +0 -730
data/site/docs/collections/index.html +0 -1097
data/site/docs/conduct/index.html +0 -744
data/site/docs/configuration/index.html +0 -1403
data/site/docs/continuous-integration/buddyworks/index.html +0 -726
data/site/docs/continuous-integration/circleci/index.html +0 -757
data/site/docs/continuous-integration/index.html +0 -681
data/site/docs/continuous-integration/travis-ci/index.html +0 -891
data/site/docs/contributing/index.html +0 -863
data/site/docs/datafiles/index.html +0 -780
data/site/docs/deployment-methods/index.html +0 -875
data/site/docs/drafts/index.html +0 -636
data/site/docs/extras/index.html +0 -689
data/site/docs/frontmatter/index.html +0 -807
data/site/docs/github-pages/index.html +0 -819
data/site/docs/history/index.html +0 -3955
data/site/docs/home/index.html +0 -644
data/site/docs/includes/index.html +0 -800
data/site/docs/index.html +0 -10
data/site/docs/installation/index.html +0 -732
data/site/docs/maintaining/affinity-team-captain/index.html +0 -706
data/site/docs/maintaining/avoiding-burnout/index.html +0 -709
data/site/docs/maintaining/becoming-a-maintainer/index.html +0 -717
data/site/docs/maintaining/index.html +0 -713
data/site/docs/maintaining/merging-a-pull-request/index.html +0 -747
data/site/docs/maintaining/reviewing-a-pull-request/index.html +0 -725
data/site/docs/maintaining/special-labels/index.html +0 -705
data/site/docs/maintaining/triaging-an-issue/index.html +0 -735
data/site/docs/migrations/index.html +0 -647
data/site/docs/pages/index.html +0 -695
data/site/docs/pagination/index.html +0 -870
data/site/docs/permalinks/index.html +0 -1027
data/site/docs/plugins/index.html +0 -1800
data/site/docs/posts/index.html +0 -858
data/site/docs/quickstart/index.html +0 -650
data/site/docs/resources/index.html +0 -769
data/site/docs/sites/index.html +0 -702
data/site/docs/static-files/index.html +0 -720
data/site/docs/structure/index.html +0 -822
data/site/docs/templates/index.html +0 -1208
data/site/docs/themes/index.html +0 -935
data/site/docs/troubleshooting/index.html +0 -893
data/site/docs/upgrading/0-to-2/index.html +0 -826
data/site/docs/upgrading/2-to-3/index.html +0 -824
data/site/docs/upgrading/index.html +0 -693
data/site/docs/usage/index.html +0 -705
data/site/docs/variables/index.html +0 -1048
data/site/docs/windows/index.html +0 -799
data/site/favicon.ico +0 -0
data/site/feed.xml +0 -372
data/site/fonts/FontAwesome.eot +0 -0
data/site/fonts/FontAwesome.svg +0 -12
data/site/fonts/FontAwesome.ttf +0 -0
data/site/fonts/FontAwesome.woff +0 -0
data/site/github.html +0 -10
data/site/help/index.html +0 -244
data/site/icomoon-selection.json +0 -96
data/site/img/article-footer.png +0 -0
data/site/img/footer-arrow.png +0 -0
data/site/img/footer-logo.png +0 -0
data/site/img/jekyll-sticker.jpg +0 -0
data/site/img/jekylllayoutconcept.png +0 -0
data/site/img/logo-2x.png +0 -0
data/site/img/logo-rss.png +0 -0
data/site/img/octojekyll.png +0 -0
data/site/index.html +0 -267
data/site/issues.html +0 -10
data/site/js/html5shiv.min.js +0 -4
data/site/js/respond.min.js +0 -5
data/site/latest_version.txt +0 -1
data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +0 -570
data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +0 -570
data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +0 -571
data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +0 -568
data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +0 -570
data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +0 -569
data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +0 -565
data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +0 -565
data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +0 -572
data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +0 -566
data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +0 -564
data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +0 -599
data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +0 -568
data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +0 -583
data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +0 -565
data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +0 -564
data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +0 -573
data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +0 -564
data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +0 -569
data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +0 -585
data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +0 -565
data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +0 -567
data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +0 -582
data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +0 -579
data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +0 -568
data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +0 -588
data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +0 -574
data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +0 -597
data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +0 -575
data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +0 -565
data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +0 -572
data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +0 -567
data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +0 -568
data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +0 -588
data/site/news/2015/02/26/introducing-jekyll-talk/index.html +0 -563
data/site/news/2015/10/26/jekyll-3-0-released/index.html +0 -592
data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +0 -576
data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +0 -566
data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +0 -599
data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +0 -583
data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +0 -578
data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +0 -569
data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +0 -565
data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +0 -571
data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +0 -566
data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +0 -572
data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +0 -576
data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +0 -564
data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +0 -566
data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +0 -567
data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +0 -676
data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +0 -571
data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +0 -566
data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +0 -645
data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +0 -569
data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +0 -592
data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +0 -649
data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +0 -598
data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +0 -594
data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +0 -589
data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +0 -569
data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +0 -573
data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +0 -565
data/site/news/index.html +0 -3609
data/site/news/releases/index.html +0 -3344
data/site/philosophy.html +0 -46
data/site/readme.md +0 -23
data/site/robots.txt +0 -1
data/site/sitemap.xml +0 -485
data/site/tutorials/convert-site-to-jekyll/index.html +0 -793
data/site/tutorials/custom-404-page/index.html +0 -358
data/site/tutorials/home/index.html +0 -323
data/site/tutorials/index.html +0 -10
data/site/tutorials/navigation/index.html +0 -872
data/site/tutorials/orderofinterpretation/index.html +0 -441

data/site/docs/collections/index.html DELETED Viewed

@@ -1,1097 +0,0 @@
-<!DOCTYPE HTML>
-<html lang="en-US">
-<head>
-<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.6.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">
-  <link rel="stylesheet" href="/css/screen.css">
-  <link rel="icon" type="image/x-icon" href="/favicon.ico">
-  <!-- Begin Jekyll SEO tag v2.3.0 -->
-<title>Collections | Jekyll • Simple, blog-aware, static sites</title>
-<meta property="og:title" content="Collections">
-<meta property="og:locale" content="en_US">
-<meta name="description" content="Not everything is a post or a page. Maybe you want to document the various methods in your open source project, members of a team, or talks at a conference. Collections allow you to define a new type of document that behave like Pages or Posts do normally, but also have their own unique properties and namespace.">
-<meta property="og:description" content="Not everything is a post or a page. Maybe you want to document the various methods in your open source project, members of a team, or talks at a conference. Collections allow you to define a new type of document that behave like Pages or Posts do normally, but also have their own unique properties and namespace.">
-<link rel="canonical" href="https://jekyllrb.com/docs/collections/">
-<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="2017-10-24T08:07:43-07:00">
-<meta name="twitter:card" content="summary">
-<meta name="twitter:site" content="@jekyllrb">
-<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
-<script type="application/ld+json">
-{"name":null,"description":"Not everything is a post or a page. Maybe you want to document the various methods in your open source project, members of a team, or talks at a conference. Collections allow you to define a new type of document that behave like Pages or Posts do normally, but also have their own unique properties and namespace.","url":"https://jekyllrb.com/docs/collections/","headline":"Collections","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/collections/"},"@context":"http://schema.org"}</script>
-<!-- End Jekyll SEO tag -->
-  <!--[if lt IE 9]>
-  <script src="/js/html5shiv.min.js"></script>
-  <script src="/js/respond.min.js"></script>
-  <![endif]-->
-</head>
-<body class="wrap">
-  <header>
-  <nav class="mobile-nav show-on-mobiles">
-    <ul>
-  <li class="">
-    <a href="/">Home</a>
-  </li>
-  <li class="current">
-    <a href="/docs/home/">Docs</a>
-  </li>
-  <li class="">
-    <a href="/news/">News</a>
-  </li>
-  <li class="">
-    <a href="/community/">Community</a>
-  </li>
-  <li class="">
-    <a href="/help/">Help</a>
-  </li>
-  <li>
-    <a href="https://github.com/jekyll/jekyll">GitHub</a>
-  </li>
-</ul>
-  </nav>
-  <div class="grid">
-    <div class="unit one-third center-on-mobiles">
-      <h1>
-        <a href="/">
-          <span class="sr-only">Jekyll</span>
-          <img src="/img/logo-2x.png" width="249" height="115" alt="Jekyll Logo">
-        </a>
-      </h1>
-    </div>
-    <nav class="main-nav unit two-thirds hide-on-mobiles">
-      <ul>
-  <li class="">
-    <a href="/">Home</a>
-  </li>
-  <li class="current">
-    <a href="/docs/home/">Docs</a>
-  </li>
-  <li class="">
-    <a href="/news/">News</a>
-  </li>
-  <li class="">
-    <a href="/community/">Community</a>
-  </li>
-  <li class="">
-    <a href="/help/">Help</a>
-  </li>
-  <li>
-    <a href="https://github.com/jekyll/jekyll">GitHub</a>
-  </li>
-</ul>
-    </nav>
-  </div>
-</header>
-    <section class="docs">
-    <div class="grid">
-      <div class="docs-nav-mobile unit whole show-on-mobiles">
-  <select onchange="if (this.value) window.location.href=this.value">
-    <option value="">Navigate the docs…</option>
-    <optgroup label="Getting Started">
-  <option value="/docs/home/">Welcome</option>
-  <option value="/docs/quickstart/">Quick-start guide</option>
-  <option value="/docs/installation/">Installation</option>
-  <option value="/docs/windows/">Jekyll on Windows</option>
-  <option value="/docs/usage/">Basic Usage</option>
-  <option value="/docs/structure/">Directory structure</option>
-  <option value="/docs/configuration/">Configuration</option>
-    </optgroup>
-    <optgroup label="Your Content">
-  <option value="/docs/frontmatter/">Front Matter</option>
-  <option value="/docs/posts/">Writing posts</option>
-  <option value="/docs/drafts/">Working with drafts</option>
-  <option value="/docs/pages/">Creating pages</option>
-  <option value="/docs/static-files/">Static Files</option>
-  <option value="/docs/variables/">Variables</option>
-  <option value="/docs/collections/">Collections</option>
-  <option value="/docs/datafiles/">Data Files</option>
-  <option value="/docs/assets/">Assets</option>
-  <option value="/docs/migrations/">Blog migrations</option>
-    </optgroup>
-    <optgroup label="Customization">
-  <option value="/docs/templates/">Templates</option>
-  <option value="/docs/includes/">Includes</option>
-  <option value="/docs/permalinks/">Permalinks</option>
-  <option value="/docs/pagination/">Pagination</option>
-  <option value="/docs/plugins/">Plugins</option>
-  <option value="/docs/themes/">Themes</option>
-  <option value="/docs/extras/">Extras</option>
-    </optgroup>
-    <optgroup label="Deployment">
-  <option value="/docs/github-pages/">GitHub Pages</option>
-  <option value="/docs/deployment-methods/">Deployment methods</option>
-  <option value="/docs/continuous-integration/">Continuous Integration</option>
-    </optgroup>
-    <optgroup label="Miscellaneous">
-  <option value="/docs/troubleshooting/">Troubleshooting</option>
-  <option value="/docs/sites/">Sites using Jekyll</option>
-  <option value="/docs/resources/">Resources</option>
-  <option value="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
-  <option value="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
-    </optgroup>
-    <optgroup label="Meta">
-  <option value="/docs/contributing/">Contributing</option>
-  <option value="/docs/maintaining/">Maintaining Jekyll</option>
-  <option value="/docs/conduct/">Code of Conduct</option>
-  <option value="/docs/history/">History</option>
-    </optgroup>
-  </select>
-</div>
-      <div class="unit four-fifths">
-        <article>
-          <div class="improve right hide-on-mobiles">
-            <a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/collections.md"><i class="fa fa-pencil"></i>  Improve this page</a>
-          </div>
-          <h1>Collections</h1>
-          <p>Not everything is a post or a page. Maybe you want to document the various
-methods in your open source project, members of a team, or talks at a
-conference. Collections allow you to define a new type of document that behave
-like Pages or Posts do normally, but also have their own unique properties and
-namespace.</p>
-<h2 id="using-collections">Using Collections</h2>
-<p>To start using collections, follow these 3 steps:</p>
-<ul>
-  <li><a href="#step1">Step 1: Tell Jekyll to read in your collection</a></li>
-  <li><a href="#step2">Step 2: Add your content</a></li>
-  <li><a href="#step3">Step 3: Optionally render your collection’s documents into independent files</a></li>
-</ul>
-<h3 id="step1">Step 1: Tell Jekyll to read in your collection</h3>
-<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>
-<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">collections</span><span class="pi">:</span>
-<span class="pi">-</span> <span class="s">my_collection</span>
-</code></pre></div></div>
-<p>You can optionally specify metadata for your collection in the configuration:</p>
-<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">collections</span><span class="pi">:</span>
-  <span class="na">my_collection</span><span class="pi">:</span>
-    <span class="na">foo</span><span class="pi">:</span> <span class="s">bar</span>
-</code></pre></div></div>
-<p>Default attributes can also be set for a collection:</p>
-<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">defaults</span><span class="pi">:</span>
-  <span class="pi">-</span> <span class="na">scope</span><span class="pi">:</span>
-      <span class="na">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">"</span>
-      <span class="na">type</span><span class="pi">:</span> <span class="s">my_collection</span>
-    <span class="na">values</span><span class="pi">:</span>
-      <span class="na">layout</span><span class="pi">:</span> <span class="s">page</span>
-</code></pre></div></div>
-<h3 id="step2">Step 2: Add your content</h3>
-<p>Create a corresponding folder (e.g. <code class="highlighter-rouge">&lt;source&gt;/_my_collection</code>) and add
-documents. YAML front matter is processed if the front matter exists, and everything
-after the front matter is pushed into the document’s <code class="highlighter-rouge">content</code> attribute. If no YAML front
-matter is provided, Jekyll will not generate the file in your collection.</p>
-<div class="note info">
-  <h5>Be sure to name your directories correctly</h5>
-  <p>
-The folder must be named identically to the collection you defined in
-your <code>_config.yml</code> file, with the addition of the preceding <code>_</code> character.
-  </p>
-</div>
-<h3 id="step3">Step 3: Optionally render your collection’s documents into independent files</h3>
-<p>If you’d like Jekyll to create a public-facing, rendered version of each
-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>
-<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">collections</span><span class="pi">:</span>
-  <span class="na">my_collection</span><span class="pi">:</span>
-    <span class="na">output</span><span class="pi">:</span> <span class="no">true</span>
-</code></pre></div></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>,
-it will be rendered using Liquid and the Markdown converter of your
-choice and written out to <code class="highlighter-rouge">&lt;dest&gt;/my_collection/some_subdir/some_doc.html</code>.</p>
-<div class="note info">
-  <h5>Don't forget to add YAML for processing</h5>
-  <p>
-  Files in collections that do not have front matter are treated as
-  <a href="/docs/static-files">static files</a> and simply copied to their
-  output location without processing.
-  </p>
-</div>
-<h2 id="permalinks">Configuring permalinks for collections</h2>
-<p>If you wish to specify a custom pattern for the URLs where your Collection pages
-will reside, you may do so with the <a href="../permalinks/"><code class="highlighter-rouge">permalink</code> property</a>:</p>
-<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">collections</span><span class="pi">:</span>
-  <span class="na">my_collection</span><span class="pi">:</span>
-    <span class="na">output</span><span class="pi">:</span> <span class="no">true</span>
-    <span class="na">permalink</span><span class="pi">:</span> <span class="s">/:collection/:name</span>
-</code></pre></div></div>
-<h3 id="examples">Examples</h3>
-<p>For a collection with the following source file structure,</p>
-<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>_my_collection/
-└── some_subdir
-    └── some_doc.md
-</code></pre></div></div>
-<p>each of the following <code class="highlighter-rouge">permalink</code> configurations will produce the document structure shown below it.</p>
-<ul>
-  <li>
-    <p><strong>Default</strong><br>
-Same as <code class="highlighter-rouge">permalink: /:collection/:path</code>.</p>
-    <div class="highlighter-rouge">
-<div class="highlight"><pre class="highlight"><code>_site/
-├── my_collection
-│   └── some_subdir
-│       └── some_doc.html
-...
-</code></pre></div>    </div>
-  </li>
-  <li>
-    <p><code class="highlighter-rouge">permalink: pretty</code><br>
-Same as <code class="highlighter-rouge">permalink: /:collection/:path/</code>.</p>
-    <div class="highlighter-rouge">
-<div class="highlight"><pre class="highlight"><code>_site/
-├── my_collection
-│   └── some_subdir
-│       └── some_doc
-│           └── index.html
-...
-</code></pre></div>    </div>
-  </li>
-  <li>
-    <p><code class="highlighter-rouge">permalink: /doc/:path</code></p>
-    <div class="highlighter-rouge">
-<div class="highlight"><pre class="highlight"><code>_site/
-├── doc
-│   └── some_subdir
-│       └── some_doc.html
-...
-</code></pre></div>    </div>
-  </li>
-  <li>
-    <p><code class="highlighter-rouge">permalink: /doc/:name</code></p>
-    <div class="highlighter-rouge">
-<div class="highlight"><pre class="highlight"><code>_site/
-├── doc
-│   └── some_doc.html
-...
-</code></pre></div>    </div>
-  </li>
-  <li>
-    <p><code class="highlighter-rouge">permalink: /:name</code></p>
-    <div class="highlighter-rouge">
-<div class="highlight"><pre class="highlight"><code>_site/
-├── some_doc.html
-...
-</code></pre></div>    </div>
-  </li>
-</ul>
-<h3 id="template-variables">Template Variables</h3>
-<div class="mobile-side-scroller">
-<table>
-  <thead>
-    <tr>
-      <th>Variable</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p><code>:collection</code></p>
-      </td>
-      <td>
-        <p>Label of the containing collection.</p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>:path</code></p>
-      </td>
-      <td>
-        <p>Path to the document relative to the collection's directory.</p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>:name</code></p>
-      </td>
-      <td>
-        <p>The document's base filename, with every sequence of spaces
-        and non-alphanumeric characters replaced by a hyphen.</p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>:title</code></p>
-      </td>
-      <td>
-        <p>
-          The <code>:title</code> template variable will take the
-          <code>slug</code> <a href="/docs/frontmatter/">front matter</a>
-          variable value if any is present in the document; if none is
-          defined then <code>:title</code> will be equivalent to
-          <code>:name</code>, aka the slug generated from the filename.
-        </p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>:output_ext</code></p>
-      </td>
-      <td>
-        <p>Extension of the output file. (Included by default and usually unnecessary.)</p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-</div>
-<h2 id="liquid-attributes">Liquid Attributes</h2>
-<h3 id="collections">Collections</h3>
-<p>Each collection is accessible as a field on the <code class="highlighter-rouge">site</code> variable. For example, if
-you want to access the <code class="highlighter-rouge">albums</code> collection found in <code class="highlighter-rouge">_albums</code>, you’d use
-<code class="highlighter-rouge">site.albums</code>.</p>
-<p>Each collection is itself an array of documents (e.g., <code class="highlighter-rouge">site.albums</code> is an array of documents, much like <code class="highlighter-rouge">site.pages</code> and
-<code class="highlighter-rouge">site.posts</code>). See the table below for how to access attributes of those documents.</p>
-<p>The collections are also available under <code class="highlighter-rouge">site.collections</code>, with the metadata
-you specified in your <code class="highlighter-rouge">_config.yml</code> (if present) and the following information:</p>
-<div class="mobile-side-scroller">
-<table>
-  <thead>
-    <tr>
-      <th>Variable</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p><code>label</code></p>
-      </td>
-      <td>
-        <p>
-          The name of your collection, e.g. <code>my_collection</code>.
-        </p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>docs</code></p>
-      </td>
-      <td>
-        <p>
-          An array of <a href="#documents">documents</a>.
-        </p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>files</code></p>
-      </td>
-      <td>
-        <p>
-          An array of static files in the collection.
-        </p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>relative_directory</code></p>
-      </td>
-      <td>
-        <p>
-          The path to the collection's source directory, relative to the site
-          source.
-        </p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>directory</code></p>
-      </td>
-      <td>
-        <p>
-          The full path to the collections's source directory.
-        </p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>output</code></p>
-      </td>
-      <td>
-        <p>
-          Whether the collection's documents will be output as individual
-          files.
-        </p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-</div>
-<div class="note info">
-  <h5>A Hard-Coded Collection</h5>
-  <p>In addition to any collections you create yourself, the
-  <code>posts</code> collection is hard-coded into Jekyll. It exists whether
-  you have a <code>_posts</code> directory or not. This is something to note
-  when iterating through <code>site.collections</code> as you may need to
-  filter it out.</p>
-  <p>You may wish to use filters to find your collection:
-  <code>{{ site.collections | where: "label", "myCollection" | first }}</code></p>
-</div>
-<h3 id="documents">Documents</h3>
-<p>In addition to any YAML Front Matter provided in the document’s corresponding
-file, each document has the following attributes:</p>
-<div class="mobile-side-scroller">
-<table>
-  <thead>
-    <tr>
-      <th>Variable</th>
-      <th>Description</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr>
-      <td>
-        <p><code>content</code></p>
-      </td>
-      <td>
-        <p>
-          The (unrendered) content of the document. If no YAML Front Matter is
-          provided, Jekyll will not generate the file in your collection. If
-          YAML Front Matter is used, then this is all the contents of the file
-          after the terminating
-          `---` of the front matter.
-        </p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>output</code></p>
-      </td>
-      <td>
-        <p>
-          The rendered output of the document, based on the
-          <code>content</code>.
-        </p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>path</code></p>
-      </td>
-      <td>
-        <p>
-          The full path to the document's source file.
-        </p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>relative_path</code></p>
-      </td>
-      <td>
-        <p>
-          The path to the document's source file relative to the site source.
-        </p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>url</code></p>
-      </td>
-      <td>
-        <p>
-          The URL of the rendered collection. The file is only written to the destination when the collection to which it belongs has <code>output: true</code> in the site's configuration.
-          </p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>collection</code></p>
-      </td>
-      <td>
-        <p>
-          The name of the document's collection.
-        </p>
-      </td>
-    </tr>
-    <tr>
-      <td>
-        <p><code>date</code></p>
-      </td>
-      <td>
-        <p>
-          The date of the document's collection.
-        </p>
-      </td>
-    </tr>
-  </tbody>
-</table>
-</div>
-<h2 id="accessing-collection-attributes">Accessing Collection Attributes</h2>
-<p>Attributes from the YAML front matter can be accessed as data anywhere in the
-site. Using the above example for configuring a collection as <code class="highlighter-rouge">site.albums</code>,
-you 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>
-<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">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="na">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="na">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="na">works</span><span class="pi">:</span>
-  <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s2">"</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="na">composer</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Josquin</span><span class="nv"> </span><span class="s">des</span><span class="nv"> </span><span class="s">Prez"</span>
-    <span class="na">tracks</span><span class="pi">:</span>
-      <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Kyrie"</span>
-        <span class="na">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">4:25"</span>
-      <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Gloria"</span>
-        <span class="na">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">9:53"</span>
-      <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s2">"</span><span class="s">Credo"</span>
-        <span class="na">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">9:09"</span>
-      <span class="pi">-</span> <span class="na">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="na">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">7:47"</span>
-      <span class="pi">-</span> <span class="na">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="na">duration</span><span class="pi">:</span> <span class="s2">"</span><span class="s">6:49"</span>
-</code></pre></div></div>
-<p>Every album in the collection could be listed on a single page with a template:</p>
-<div class="language-html highlighter-rouge"><div class="highlight"><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 %}
-    <span class="nt">&lt;h3&gt;</span>{{ work.title }}<span class="nt">&lt;/h3&gt;</span>
-    <span class="nt">&lt;p&gt;</span>Composed by {{ work.composer }}<span class="nt">&lt;/p&gt;</span>
-    <span class="nt">&lt;ul&gt;</span>
-    {% for track in work.tracks %}
-      <span class="nt">&lt;li&gt;</span>{{ track.title }} ({{ track.duration }})<span class="nt">&lt;/li&gt;</span>
-    {% endfor %}
-    <span class="nt">&lt;/ul&gt;</span>
-  {% endfor %}
-{% endfor %}
-</code></pre></div></div>
-    <div class="section-nav">
-      <div class="left align-right">
-            <a href="/docs/variables/" class="prev">Back</a>
-      </div>
-      <div class="right align-left">
-            <a href="/docs/datafiles/" class="next">Next</a>
-      </div>
-    </div>
-    <div class="clear"></div>
-        </article>
-      </div>
-      <div class="unit one-fifth hide-on-mobiles">
-  <aside>
-    <h4>Getting Started</h4>
-    <ul>
-  <li class=""><a href="/docs/home/">Welcome</a></li>
-  <li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
-  <li class=""><a href="/docs/installation/">Installation</a></li>
-  <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
-  <li class=""><a href="/docs/usage/">Basic Usage</a></li>
-  <li class=""><a href="/docs/structure/">Directory structure</a></li>
-  <li class=""><a href="/docs/configuration/">Configuration</a></li>
-</ul>
-    <h4>Your Content</h4>
-    <ul>
-  <li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
-  <li class=""><a href="/docs/posts/">Writing posts</a></li>
-  <li class=""><a href="/docs/drafts/">Working with drafts</a></li>
-  <li class=""><a href="/docs/pages/">Creating pages</a></li>
-  <li class=""><a href="/docs/static-files/">Static Files</a></li>
-  <li class=""><a href="/docs/variables/">Variables</a></li>
-  <li class="current"><a href="/docs/collections/">Collections</a></li>
-  <li class=""><a href="/docs/datafiles/">Data Files</a></li>
-  <li class=""><a href="/docs/assets/">Assets</a></li>
-  <li class=""><a href="/docs/migrations/">Blog migrations</a></li>
-</ul>
-    <h4>Customization</h4>
-    <ul>
-  <li class=""><a href="/docs/templates/">Templates</a></li>
-  <li class=""><a href="/docs/includes/">Includes</a></li>
-  <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
-  <li class=""><a href="/docs/pagination/">Pagination</a></li>
-  <li class=""><a href="/docs/plugins/">Plugins</a></li>
-  <li class=""><a href="/docs/themes/">Themes</a></li>
-  <li class=""><a href="/docs/extras/">Extras</a></li>
-</ul>
-    <h4>Deployment</h4>
-    <ul>
-  <li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
-  <li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
-  <li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
-</ul>
-    <h4>Miscellaneous</h4>
-    <ul>
-  <li class=""><a href="/docs/troubleshooting/">Troubleshooting</a></li>
-  <li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
-  <li class=""><a href="/docs/resources/">Resources</a></li>
-  <li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
-  <li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
-</ul>
-    <h4>Meta</h4>
-    <ul>
-  <li class=""><a href="/docs/contributing/">Contributing</a></li>
-  <li class=""><a href="/docs/maintaining/">Maintaining Jekyll</a></li>
-  <li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
-  <li class=""><a href="/docs/history/">History</a></li>
-</ul>
-  </aside>
-</div>
-      <div class="clear"></div>
-    </div>
-  </section>
-  <footer>
-  <div class="grid">
-    <div class="unit one-third center-on-mobiles">
-      <p>The contents of this website are <br>© 2017 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
-    </div>
-    <div class="unit two-thirds align-right center-on-mobiles">
-      <p>
-        Proudly hosted by
-        <a href="https://github.com">
-          <img src="/img/footer-logo.png" width="100" height="30" alt="GitHub • Social coding">
-        </a>
-      </p>
-    </div>
-  </div>
-</footer>
-  <script>
-  var anchorForId = function (id) {
-    var anchor = document.createElement("a");
-    anchor.className = "header-link";
-    anchor.href      = "#" + id;
-    anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
-    anchor.title = "Permalink";
-    return anchor;
-  };
-  var linkifyAnchors = function (level, containingElement) {
-    var headers = containingElement.getElementsByTagName("h" + level);
-    for (var h = 0; h < headers.length; h++) {
-      var header = headers[h];
-      if (typeof header.id !== "undefined" && header.id !== "") {
-        header.appendChild(anchorForId(header.id));
-      }
-    }
-  };
-  document.onreadystatechange = function () {
-    if (this.readyState === "complete") {
-      var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
-      if (!contentBlock) {
-        return;
-      }
-      for (var level = 1; level <= 6; level++) {
-        linkifyAnchors(level, contentBlock);
-      }
-    }
-  };
-</script>
-  <!-- Gauges (http://get.gaug.es/) -->
-  <script>
-    var _gauges = _gauges || [];
-    (function() {
-      var t   = document.createElement('script');
-      t.type  = 'text/javascript';
-      t.async = true;
-      t.id    = 'gauges-tracker';
-      t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
-      t.src = '//secure.gaug.es/track.js';
-      var s = document.getElementsByTagName('script')[0];
-      s.parentNode.insertBefore(t, s);
-    })();
-  </script>
-  <!-- Google Analytics (https://www.google.com/analytics) -->
-  <script>
-    !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
-    (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
-    L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
-    L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
-    ga('create', 'UA-50755011-1', 'jekyllrb.com');
-    ga('send', 'pageview');
-  </script>
-</body>
-</html>