RubyGems - jekyll-docs - Versions diffs - 3.1.6 → 3.2.0 - Mend

jekyll-docs 3.1.6 → 3.2.0

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 (211) hide show

checksums.yaml +4 -4
data/lib/jekyll-docs.rb +7 -13
data/site/community/index.html +305 -0
data/site/conduct/index.html +10 -0
data/site/css/screen.css +1445 -0
data/site/docs/assets/index.html +701 -0
data/site/docs/collections/index.html +973 -0
data/site/docs/conduct/index.html +718 -0
data/site/docs/configuration/index.html +1337 -0
data/site/docs/continuous-integration/index.html +846 -0
data/site/docs/contributing/index.html +815 -0
data/site/docs/datafiles/index.html +742 -0
data/site/docs/deployment-methods/index.html +866 -0
data/site/docs/drafts/index.html +615 -0
data/site/docs/extras/index.html +656 -0
data/site/docs/frontmatter/index.html +776 -0
data/site/docs/github-pages/index.html +778 -0
data/site/docs/history/index.html +3293 -0
data/site/docs/home/index.html +627 -0
data/site/docs/index.html +10 -0
data/site/docs/installation/index.html +682 -0
data/site/docs/migrations/index.html +627 -0
data/site/docs/pages/index.html +698 -0
data/site/docs/pagination/index.html +840 -0
data/site/docs/permalinks/index.html +924 -0
data/site/docs/plugins/index.html +1726 -0
data/site/docs/posts/index.html +811 -0
data/site/docs/quickstart/index.html +599 -0
data/site/docs/resources/index.html +717 -0
data/site/docs/sites/index.html +676 -0
data/site/docs/static-files/index.html +655 -0
data/site/docs/structure/index.html +794 -0
data/site/docs/templates/index.html +1105 -0
data/site/docs/themes/index.html +751 -0
data/site/docs/troubleshooting/index.html +826 -0
data/site/docs/upgrading/0-to-2/index.html +802 -0
data/site/docs/upgrading/2-to-3/index.html +785 -0
data/site/docs/upgrading/index.html +664 -0
data/site/docs/usage/index.html +673 -0
data/site/docs/variables/index.html +1013 -0
data/site/docs/windows/index.html +775 -0
data/site/feed.xml +222 -0
data/site/github.html +10 -0
data/site/help/index.html +246 -0
data/site/img/article-footer.png +0 -0
data/site/img/footer-logo.png +0 -0
data/site/img/logo-2x.png +0 -0
data/site/index.html +200 -16
data/site/issues.html +10 -0
data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +524 -0
data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +524 -0
data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +525 -0
data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +522 -0
data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +524 -0
data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +523 -0
data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +519 -0
data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +519 -0
data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +526 -0
data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +520 -0
data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +518 -0
data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +553 -0
data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +522 -0
data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +537 -0
data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +519 -0
data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +518 -0
data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +527 -0
data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +518 -0
data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +523 -0
data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +539 -0
data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +519 -0
data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +521 -0
data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +536 -0
data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +533 -0
data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +522 -0
data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +542 -0
data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +528 -0
data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +551 -0
data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +529 -0
data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +519 -0
data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +526 -0
data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +521 -0
data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +522 -0
data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +542 -0
data/site/news/2015/02/26/introducing-jekyll-talk/index.html +517 -0
data/site/news/2015/10/26/jekyll-3-0-released/index.html +546 -0
data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +530 -0
data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +520 -0
data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +553 -0
data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +537 -0
data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +532 -0
data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +523 -0
data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +519 -0
data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +525 -0
data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +521 -0
data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +526 -0
data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +530 -0
data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +518 -0
data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +520 -0
data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +521 -0
data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +630 -0
data/site/news/index.html +2831 -10
data/site/news/releases/index.html +2603 -10
data/site/sitemap.xml +327 -0
metadata +99 -111
data/site/_config.yml +0 -25
data/site/_data/docs.yml +0 -49
data/site/_docs/assets.md +0 -94
data/site/_docs/collections.md +0 -380
data/site/_docs/conduct.md +0 -55
data/site/_docs/configuration.md +0 -747
data/site/_docs/continuous-integration.md +0 -221
data/site/_docs/contributing.md +0 -124
data/site/_docs/datafiles.md +0 -151
data/site/_docs/deployment-methods.md +0 -213
data/site/_docs/drafts.md +0 -20
data/site/_docs/extras.md +0 -22
data/site/_docs/frontmatter.md +0 -191
data/site/_docs/github-pages.md +0 -133
data/site/_docs/history.md +0 -2323
data/site/_docs/index.md +0 -57
data/site/_docs/installation.md +0 -106
data/site/_docs/migrations.md +0 -9
data/site/_docs/pages.md +0 -100
data/site/_docs/pagination.md +0 -224
data/site/_docs/permalinks.md +0 -308
data/site/_docs/plugins.md +0 -903
data/site/_docs/posts.md +0 -237
data/site/_docs/quickstart.md +0 -26
data/site/_docs/resources.md +0 -38
data/site/_docs/sites.md +0 -23
data/site/_docs/static_files.md +0 -52
data/site/_docs/structure.md +0 -211
data/site/_docs/templates.md +0 -451
data/site/_docs/troubleshooting.md +0 -207
data/site/_docs/upgrading.md +0 -10
data/site/_docs/upgrading/0-to-2.md +0 -140
data/site/_docs/upgrading/2-to-3.md +0 -126
data/site/_docs/usage.md +0 -101
data/site/_docs/variables.md +0 -390
data/site/_docs/windows.md +0 -46
data/site/_includes/analytics.html +0 -30
data/site/_includes/anchor_links.html +0 -33
data/site/_includes/docs_contents.html +0 -8
data/site/_includes/docs_contents_mobile.html +0 -10
data/site/_includes/docs_option.html +0 -11
data/site/_includes/docs_ul.html +0 -17
data/site/_includes/footer.html +0 -15
data/site/_includes/header.html +0 -18
data/site/_includes/news_contents.html +0 -33
data/site/_includes/news_contents_mobile.html +0 -11
data/site/_includes/news_item.html +0 -24
data/site/_includes/primary-nav-items.html +0 -17
data/site/_includes/section_nav.html +0 -39
data/site/_includes/top.html +0 -17
data/site/_layouts/default.html +0 -13
data/site/_layouts/docs.html +0 -26
data/site/_layouts/news.html +0 -19
data/site/_layouts/news_item.html +0 -27
data/site/_layouts/page.html +0 -18
data/site/_posts/2013-05-06-jekyll-1-0-0-released.markdown +0 -23
data/site/_posts/2013-05-08-jekyll-1-0-1-released.markdown +0 -27
data/site/_posts/2013-05-12-jekyll-1-0-2-released.markdown +0 -28
data/site/_posts/2013-06-07-jekyll-1-0-3-released.markdown +0 -25
data/site/_posts/2013-07-14-jekyll-1-1-0-released.markdown +0 -27
data/site/_posts/2013-07-24-jekyll-1-1-1-released.markdown +0 -31
data/site/_posts/2013-07-25-jekyll-1-0-4-released.markdown +0 -20
data/site/_posts/2013-07-25-jekyll-1-1-2-released.markdown +0 -20
data/site/_posts/2013-09-06-jekyll-1-2-0-released.markdown +0 -23
data/site/_posts/2013-09-14-jekyll-1-2-1-released.markdown +0 -19
data/site/_posts/2013-10-28-jekyll-1-3-0-rc1-released.markdown +0 -17
data/site/_posts/2013-11-04-jekyll-1-3-0-released.markdown +0 -43
data/site/_posts/2013-11-26-jekyll-1-3-1-released.markdown +0 -21
data/site/_posts/2013-12-07-jekyll-1-4-0-released.markdown +0 -30
data/site/_posts/2013-12-09-jekyll-1-4-1-released.markdown +0 -18
data/site/_posts/2013-12-16-jekyll-1-4-2-released.markdown +0 -18
data/site/_posts/2014-01-13-jekyll-1-4-3-released.markdown +0 -26
data/site/_posts/2014-03-24-jekyll-1-5-0-released.markdown +0 -19
data/site/_posts/2014-03-27-jekyll-1-5-1-released.markdown +0 -26
data/site/_posts/2014-05-06-jekyll-turns-2-0-0.markdown +0 -31
data/site/_posts/2014-05-08-jekyll-2-0-3-released.markdown +0 -18
data/site/_posts/2014-06-04-jekyll-stickers-1-dollar-stickermule.markdown +0 -19
data/site/_posts/2014-06-28-jekyll-turns-21-i-mean-2-1-0.markdown +0 -31
data/site/_posts/2014-07-01-jekyll-2-1-1-released.markdown +0 -30
data/site/_posts/2014-07-29-jekyll-2-2-0-released.markdown +0 -19
data/site/_posts/2014-08-10-jekyll-2-3-0-released.markdown +0 -41
data/site/_posts/2014-09-09-jekyll-2-4-0-released.markdown +0 -25
data/site/_posts/2014-11-06-jekylls-midlife-crisis-jekyll-turns-2-5-0.markdown +0 -47
data/site/_posts/2014-11-08-jekyll-2-5-1-released.markdown +0 -29
data/site/_posts/2014-11-12-jekyll-2-5-2-released.markdown +0 -18
data/site/_posts/2014-12-17-alfredxing-welcome-to-jekyll-core.md +0 -27
data/site/_posts/2014-12-22-jekyll-2-5-3-released.markdown +0 -20
data/site/_posts/2015-01-20-jekyll-meet-and-greet.markdown +0 -20
data/site/_posts/2015-01-24-jekyll-3-0-0-beta1-released.markdown +0 -40
data/site/_posts/2015-02-26-introducing-jekyll-talk.markdown +0 -15
data/site/_posts/2015-10-26-jekyll-3-0-released.markdown +0 -35
data/site/_posts/2015-11-17-jekyll-3-0-1-released.markdown +0 -25
data/site/_posts/2016-01-20-jekyll-3-0-2-released.markdown +0 -19
data/site/_posts/2016-01-24-jekyll-3-1-0-released.markdown +0 -50
data/site/_posts/2016-01-28-jekyll-3-1-1-released.markdown +0 -33
data/site/_posts/2016-02-08-jekyll-3-0-3-released.markdown +0 -32
data/site/_posts/2016-02-19-jekyll-3-1-2-released.markdown +0 -20
data/site/_sass/_font-awesome.scss +0 -25
data/site/_sass/_gridism.scss +0 -124
data/site/_sass/_mixins.scss +0 -38
data/site/_sass/_normalize.scss +0 -1
data/site/_sass/_pygments.scss +0 -78
data/site/_sass/_style.scss +0 -1002
data/site/css/screen.scss +0 -9
data/site/help/index.md +0 -41
data/site/redirects/github.html +0 -4
data/site/redirects/issues.html +0 -4

data/site/docs/upgrading/2-to-3/index.html ADDED

@@ -0,0 +1,785 @@
+<!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.2.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.0.0 -->
+<title>Upgrading from 2.x to 3.x - Jekyll • Simple, blog-aware, static sites</title>
+<meta property="og:title" content="Upgrading from 2.x to 3.x">
+<meta name="description" content="Transform your plain text into static websites and blogs">
+<meta property="og:description" content="Transform your plain text into static websites and blogs">
+<link rel="canonical" href="https://jekyllrb.com/docs/upgrading/2-to-3/">
+<meta property="og:url" content="https://jekyllrb.com/docs/upgrading/2-to-3/">
+<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-07-27T18:44:57-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">
+  {
+    "@context": "http://schema.org",
+    "@type": "BlogPosting",
+    "headline": "Upgrading from 2.x to 3.x",
+    "datePublished": "2016-07-27T18:44:57-07:00",
+    "description": "Transform your plain text into static websites and blogs",
+    "logo": "https://jekyllrb.comimg/logo-2x.png",
+    "url": "https://jekyllrb.com/docs/upgrading/2-to-3/"
+  }
+</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"><span class="hide-on-mobiles">View on </span>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"><span class="hide-on-mobiles">View on </span>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="https://jekyllrb.com/docs/home/">Welcome</option>
+  <option value="https://jekyllrb.com/docs/quickstart/">Quick-start guide</option>
+  <option value="https://jekyllrb.com/docs/installation/">Installation</option>
+  <option value="https://jekyllrb.com/docs/usage/">Basic Usage</option>
+  <option value="https://jekyllrb.com/docs/structure/">Directory structure</option>
+  <option value="https://jekyllrb.com/docs/configuration/">Configuration</option>
+    </optgroup>
+    <optgroup label="Your Content">
+  <option value="https://jekyllrb.com/docs/frontmatter/">Front Matter</option>
+  <option value="https://jekyllrb.com/docs/posts/">Writing posts</option>
+  <option value="https://jekyllrb.com/docs/drafts/">Working with drafts</option>
+  <option value="https://jekyllrb.com/docs/pages/">Creating pages</option>
+  <option value="https://jekyllrb.com/docs/static-files/">Static Files</option>
+  <option value="https://jekyllrb.com/docs/variables/">Variables</option>
+  <option value="https://jekyllrb.com/docs/collections/">Collections</option>
+  <option value="https://jekyllrb.com/docs/datafiles/">Data Files</option>
+  <option value="https://jekyllrb.com/docs/assets/">Assets</option>
+  <option value="https://jekyllrb.com/docs/migrations/">Blog migrations</option>
+    </optgroup>
+    <optgroup label="Customization">
+  <option value="https://jekyllrb.com/docs/templates/">Templates</option>
+  <option value="https://jekyllrb.com/docs/permalinks/">Permalinks</option>
+  <option value="https://jekyllrb.com/docs/pagination/">Pagination</option>
+  <option value="https://jekyllrb.com/docs/plugins/">Plugins</option>
+  <option value="https://jekyllrb.com/docs/themes/">Themes</option>
+  <option value="https://jekyllrb.com/docs/extras/">Extras</option>
+    </optgroup>
+    <optgroup label="Deployment">
+  <option value="https://jekyllrb.com/docs/github-pages/">GitHub Pages</option>
+  <option value="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</option>
+  <option value="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</option>
+    </optgroup>
+    <optgroup label="Miscellaneous">
+  <option value="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</option>
+  <option value="https://jekyllrb.com/docs/sites/">Sites using Jekyll</option>
+  <option value="https://jekyllrb.com/docs/resources/">Resources</option>
+  <option value="https://jekyllrb.com/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>
+    </optgroup>
+    <optgroup label="Meta">
+  <option value="https://jekyllrb.com/docs/contributing/">Contributing</option>
+  <option value="https://jekyllrb.com/docs/conduct/">Code of Conduct</option>
+  <option value="https://jekyllrb.com/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/site/_docs/upgrading/2-to-3.md"><i class="fa fa-pencil"></i>  Improve this page</a>
+          </div>
+          <h1>Upgrading from 2.x to 3.x</h1>
+          <p>Upgrading from an older version of Jekyll? A few things have changed in 3.0
+that you’ll want to know about.</p>
+<p>Before we dive in, go ahead and fetch the latest version of Jekyll:</p>
+<figure class="highlight"><pre><code class="language-shell" data-lang="shell"><span class="gp">$ </span>gem update jekyll</code></pre></figure>
+<p>Please note: Jekyll 3 requires Ruby version &gt;= 2.0.0.</p>
+<div class="note feature">
+  <h5>Diving in</h5>
+  <p>Want to get a new Jekyll site up and running quickly? Simply
+   run <code>jekyll new SITENAME</code> to create a new folder with a bare bones
+   Jekyll site.</p>
+</div>
+<h3 id="sitecollections-has-changed">site.collections has changed</h3>
+<p>In 2.x, your iterations over <code class="highlighter-rouge">site.collections</code> yielded an array with the collection
+label and the collection object as the first and second items, respectively. In 3.x,
+this complication has been removed and iterations now yield simply the collection object.
+A simple conversion must be made in your templates:</p>
+<ul>
+  <li>
+<code class="highlighter-rouge">collection[0]</code> becomes <code class="highlighter-rouge">collection.label</code>
+</li>
+  <li>
+<code class="highlighter-rouge">collection[1]</code> becomes <code class="highlighter-rouge">collection</code>
+</li>
+</ul>
+<p>When iterating over <code class="highlighter-rouge">site.collections</code>, ensure the above conversions are made.</p>
+<p>For <code class="highlighter-rouge">site.collections.myCollection</code> in Jekyll 2, you now do:</p>
+<figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{%</span><span class="w"> </span><span class="nt">assign</span><span class="w"> </span><span class="nv">myCollection</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">site</span><span class="p">.</span><span class="nv">collections</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">where</span><span class="p">:</span><span class="w"> </span><span class="s2">"label"</span><span class="p">,</span><span class="w"> </span><span class="s2">"myCollection"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">first</span><span class="w"> </span><span class="p">%}</span></code></pre></figure>
+<p>This is a bit cumbersome at first, but is easier than a big <code class="highlighter-rouge">for</code> loop.</p>
+<h3 id="dropped-dependencies">Dropped dependencies</h3>
+<p>We dropped a number of dependencies the Core Team felt were optional. As such, in 3.0, they must be explicitly installed and included if you use any of the features. They are:</p>
+<ul>
+  <li>jekyll-paginate – Jekyll’s pagination solution from days past</li>
+  <li>jekyll-coffeescript – processing of CoffeeScript</li>
+  <li>jekyll-gist – the <code class="highlighter-rouge">gist</code> Liquid tag</li>
+  <li>pygments.rb – the Pygments highlighter</li>
+  <li>redcarpet – the Markdown processor</li>
+  <li>toml – an alternative to YAML for configuration files</li>
+  <li>classifier-reborn – for <code class="highlighter-rouge">site.related_posts</code>
+</li>
+</ul>
+<h3 id="future-posts">Future posts</h3>
+<p>A seeming feature regression in 2.x, the <code class="highlighter-rouge">--future</code> flag was automatically <em>enabled</em>.
+The future flag allows post authors to give the post a date in the future and to have
+it excluded from the build until the system time is equal or after the post time.
+In Jekyll 3, this has been corrected. <strong>Now, <code class="highlighter-rouge">--future</code> is disabled by default.</strong>
+This means you will need to include <code class="highlighter-rouge">--future</code> if you want your future-dated posts to
+generate when running <code class="highlighter-rouge">jekyll build</code> or <code class="highlighter-rouge">jekyll serve</code>.</p>
+<h3 id="layout-metadata">Layout metadata</h3>
+<p>Introducing: <code class="highlighter-rouge">layout</code>. In Jekyll 2 and below, any metadata in the layout was merged onto
+the <code class="highlighter-rouge">page</code> variable in Liquid. This caused a lot of confusion in the way the data was
+merged and some unexpected behaviour. In Jekyll 3, all layout data is accessible via <code class="highlighter-rouge">layout</code>
+in Liquid. For example, if your layout has <code class="highlighter-rouge">class: my-layout</code> in its YAML front matter,
+then the layout can access that via <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">layout.class</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></code>.</p>
+<h3 id="syntax-highlighter-changed">Syntax highlighter changed</h3>
+<p>For the first time, the default syntax highlighter has changed for the
+<code class="highlighter-rouge">highlight</code> tag and for backtick code blocks. Instead of <a href="https://github.com/tmm1/pygments.rb">Pygments.rb</a>,
+it’s now <a href="http://rouge.jneen.net/">Rouge</a>. If you were using the <code class="highlighter-rouge">highlight</code> tag with certain
+options, such as <code class="highlighter-rouge">hl_lines</code>, they may not be available when using Rouge. To
+go back to using Pygments, set <code class="highlighter-rouge">highlighter: pygments</code> in your
+<code class="highlighter-rouge">_config.yml</code> file and run <code class="highlighter-rouge">gem install pygments.rb</code> or add
+<code class="highlighter-rouge">gem 'pygments.rb'</code> to your project’s <code class="highlighter-rouge">Gemfile</code>.</p>
+<h3 id="relative-permalink-support-removed">Relative Permalink support removed</h3>
+<p>In Jekyll 3 and above, relative permalinks have been deprecated. If you
+created your site using Jekyll 2 and below, you may receive the following
+error when trying to <strong>serve</strong> or <strong>build</strong>:</p>
+<figure class="highlight"><pre><code class="language-text" data-lang="text">Since v3.0, permalinks for pages in subfolders must be relative to the site
+source directory, not the parent directory. Check
+http://jekyllrb.com/docs/upgrading/ for more info.</code></pre></figure>
+<p>This can be fixed by removing the following line from your <code class="highlighter-rouge">_config.yml</code> file:</p>
+<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">relative_permalinks</span><span class="pi">:</span> <span class="s">true</span></code></pre></figure>
+<h3 id="permalinks-no-longer-automatically-add-a-trailing-slash">Permalinks no longer automatically add a trailing slash</h3>
+<p>In Jekyll 2, any URL constructed from the <code class="highlighter-rouge">permalink:</code> field had a trailing slash (<code class="highlighter-rouge">/</code>) added to it automatically.  Jekyll 3 no longer adds a trailing slash automatically to <code class="highlighter-rouge">permalink:</code> URLs. This can potentially result in old links to pages returning a 404 error. For example, suppose a page previously contained the YAML <code class="highlighter-rouge">permalink: /:year-:month-:day-:title</code> that resulted in the URL <code class="highlighter-rouge">example.com/2016-02-01-test/</code> (notice the trailing slash), Jekyll internally generates a folder named <code class="highlighter-rouge">2016-02-01-test</code>. In Jekyll 3, the same <code class="highlighter-rouge">permalink:</code> generate the file <code class="highlighter-rouge">2016-02-01-test.html</code> and the URL for the same page will be <code class="highlighter-rouge">example.com/2016-02-01-test</code>, and consequently any links to the old URL will result in a 404 error. In order to maintain the same URLs and avoid this problem, a trailing slash should be added to the <code class="highlighter-rouge">permalink:</code> field, for example <code class="highlighter-rouge">permalink: /:year-:month-:day-:title/</code>.</p>
+<h3 id="all-my-posts-are-gone-whered-they-go">All my posts are gone! Where’d they go!</h3>
+<p>Try adding <code class="highlighter-rouge">future: true</code> to your <code class="highlighter-rouge">_config.yml</code> file. Are they showing up now? If they are, then you were ensnared by an issue with the way Ruby parses times. Each of your posts is being read in a different timezone than you might expect and, when compared to the computer’s current time, is “in the future.” The fix for this is to add <a href="https://en.wikipedia.org/wiki/List_of_UTC_time_offsets">a timezone offset</a> to each post (and make sure you remove <code class="highlighter-rouge">future: true</code> from your <code class="highlighter-rouge">_config.yml</code> file). If you’re writing from California, for example, you would change this:</p>
+<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="nn">---</span>
+<span class="s">date</span><span class="pi">:</span> <span class="s">2016-02-06 19:32:10</span>
+<span class="nn">---</span></code></pre></figure>
+<p>to this (note the offset):</p>
+<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="nn">---</span>
+<span class="s">date</span><span class="pi">:</span> <span class="s">2016-02-06 19:32:10 -0800</span>
+<span class="nn">---</span></code></pre></figure>
+<h3 id="my-categories-have-stopped-working">My categories have stopped working!</h3>
+<p>If you organized your categories as <code class="highlighter-rouge">/_posts/code/2008-12-24-closures.md</code>, you will need to restructure your directories to put the categories <em>above</em> the <code class="highlighter-rouge">_posts</code> directories, as follows: <code class="highlighter-rouge">/code/_posts/2008-12-24-closures.md</code>.</p>
+<p><em>Did we miss something? Please click “Improve this page” above and add a section. Thanks!</em></p>
+    <div class="section-nav">
+      <div class="left align-right">
+            <a href="/docs/upgrading/0-to-2/" class="prev">Back</a>
+      </div>
+      <div class="right align-left">
+            <a href="/docs/contributing/" 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="https://jekyllrb.com/docs/home/">Welcome</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/quickstart/">Quick-start guide</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/installation/">Installation</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/usage/">Basic Usage</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/structure/">Directory structure</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/configuration/">Configuration</a></li>
+</ul>
+    <h4>Your Content</h4>
+    <ul>
+  <li class=""><a href="https://jekyllrb.com/docs/frontmatter/">Front Matter</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/posts/">Writing posts</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/drafts/">Working with drafts</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/pages/">Creating pages</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/static-files/">Static Files</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/variables/">Variables</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/collections/">Collections</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/datafiles/">Data Files</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/assets/">Assets</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/migrations/">Blog migrations</a></li>
+</ul>
+    <h4>Customization</h4>
+    <ul>
+  <li class=""><a href="https://jekyllrb.com/docs/templates/">Templates</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/permalinks/">Permalinks</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/pagination/">Pagination</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/plugins/">Plugins</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/themes/">Themes</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/extras/">Extras</a></li>
+</ul>
+    <h4>Deployment</h4>
+    <ul>
+  <li class=""><a href="https://jekyllrb.com/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="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</a></li>
+</ul>
+    <h4>Miscellaneous</h4>
+    <ul>
+  <li class=""><a href="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/sites/">Sites using Jekyll</a></li>
+  <li class=""><a href="https://jekyllrb.com/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="current"><a href="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
+</ul>
+    <h4>Meta</h4>
+    <ul>
+  <li class=""><a href="https://jekyllrb.com/docs/contributing/">Contributing</a></li>
+  <li class=""><a href="https://jekyllrb.com/docs/conduct/">Code of Conduct</a></li>
+  <li class=""><a href="https://jekyllrb.com/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>© 2016 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://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 (http://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>