jekyll-docs 3.5.2 → 3.6.0

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

@@ -4,13 +4,13 @@
 <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.5.2">
+  <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.2.3 -->
+  <!-- Begin Jekyll SEO tag v2.3.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 property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
 <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="2017-08-12T13:36:54-07:00">
+<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">
-{"@context":"http://schema.org","@type":"BlogPosting","headline":"Upgrading from 2.x to 3.x","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"Upgrading from an older version of Jekyll? A few things have changed in 3.0 that you’ll want to know about.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/upgrading/2-to-3/"},"url":"https://jekyllrb.com/docs/upgrading/2-to-3/"}</script>
+{"name":null,"description":"Upgrading from an older version of Jekyll? A few things have changed in 3.0 that you’ll want to know about.","url":"https://jekyllrb.com/docs/upgrading/2-to-3/","headline":"Upgrading from 2.x to 3.x","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/upgrading/2-to-3/"},"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -292,10 +292,8 @@ that you’ll want to know about.</p>
 
 <p>Before we dive in, go ahead and fetch the latest version of Jekyll:</p>
 
-<div class="language-sh highlighter-rouge">
-<pre class="highlight"><code><span class="gp">$ </span>gem update jekyll
-</code></pre>
-</div>
+<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>gem update jekyll
+</code></pre></div></div>
 
 <p>Please note: Jekyll 3.2 requires Ruby version &gt;= 2.1</p>
 
@@ -326,12 +324,10 @@ A simple conversion must be made in your templates:</p>
 
 <p>For <code class="highlighter-rouge">site.collections.myCollection</code> in Jekyll 2, you now do:</p>
 
-<div class="language-liquid highlighter-rouge">
-<pre class="highlight"><code>
+<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
 <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>
-</div>
+</code></pre></div></div>
 
 <p>This is a bit cumbersome at first, but is easier than a big <code class="highlighter-rouge">for</code> loop.</p>
 
@@ -373,7 +369,7 @@ generate when running <code class="highlighter-rouge">jekyll build</code> or <co
 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>
+then the layout can access that via <code class="highlighter-rouge">{{ layout.class }}</code>.</p>
 
 <h3 id="syntax-highlighter-changed">Syntax highlighter changed</h3>
 
@@ -391,19 +387,15 @@ go back to using Pygments, set <code class="highlighter-rouge">highlighter: pygm
 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>
 
-<div class="language-text highlighter-rouge">
-<pre class="highlight"><code>Since v3.0, permalinks for pages in subfolders must be relative to the site
+<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Since v3.0, permalinks for pages in subfolders must be relative to the site
 source directory, not the parent directory. Check
 https://jekyllrb.com/docs/upgrading/ for more info.
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>This can be fixed by removing the following line from your <code class="highlighter-rouge">_config.yml</code> file:</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="s">relative_permalinks</span><span class="pi">:</span> <span class="s">true</span>
-</code></pre>
-</div>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">relative_permalinks</span><span class="pi">:</span> <span class="no">true</span>
+</code></pre></div></div>
 
 <h3 id="permalinks-no-longer-automatically-add-a-trailing-slash">Permalinks no longer automatically add a trailing slash</h3>
 
@@ -413,21 +405,17 @@ https://jekyllrb.com/docs/upgrading/ for more info.
 
 <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>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="nn">---</span>
-<span class="s">date</span><span class="pi">:</span> <span class="s">2016-02-06 19:32:10</span>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
+<span class="na">date</span><span class="pi">:</span> <span class="s">2016-02-06 19:32:10</span>
 <span class="nn">---</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>to this (note the offset):</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="nn">---</span>
-<span class="s">date</span><span class="pi">:</span> <span class="s">2016-02-06 19:32:10 -0800</span>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
+<span class="na">date</span><span class="pi">:</span> <span class="s">2016-02-06 19:32:10 -0800</span>
 <span class="nn">---</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <h3 id="my-categories-have-stopped-working">My categories have stopped working!</h3>
 

data/site/docs/upgrading/index.html

@@ -4,13 +4,13 @@
 <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.5.2">
+  <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.2.3 -->
+  <!-- Begin Jekyll SEO tag v2.3.0 -->
 <title>Upgrading | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Upgrading">
 <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
 <meta property="og:url" content="https://jekyllrb.com/docs/upgrading/">
 <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-08-12T13:36:54-07:00">
+<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">
-{"@context":"http://schema.org","@type":"BlogPosting","headline":"Upgrading","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"Upgrading from an older version of Jekyll? Upgrading to a new major version of Jekyll (e.g. from v2.x to v3.x) may cause some headaches. Take the following guides to aid your upgrade:","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/upgrading/"},"url":"https://jekyllrb.com/docs/upgrading/"}</script>
+{"name":null,"description":"Upgrading from an older version of Jekyll? Upgrading to a new major version of Jekyll (e.g. from v2.x to v3.x) may cause some headaches. Take the following guides to aid your upgrade:","url":"https://jekyllrb.com/docs/upgrading/","headline":"Upgrading","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/upgrading/"},"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>

data/site/docs/usage/index.html

@@ -4,13 +4,13 @@
 <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.5.2">
+  <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.2.3 -->
+  <!-- Begin Jekyll SEO tag v2.3.0 -->
 <title>Basic Usage | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Basic Usage">
 <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
 <meta property="og:url" content="https://jekyllrb.com/docs/usage/">
 <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-08-12T13:36:54-07:00">
+<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">
-{"@context":"http://schema.org","@type":"BlogPosting","headline":"Basic Usage","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"The Jekyll gem makes a jekyll executable available to you in your Terminal window. You can use this command in a number of ways:","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/usage/"},"url":"https://jekyllrb.com/docs/usage/"}</script>
+{"name":null,"description":"The Jekyll gem makes a jekyll executable available to you in your Terminal window. You can use this command in a number of ways:","url":"https://jekyllrb.com/docs/usage/","headline":"Basic Usage","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/usage/"},"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -290,21 +290,19 @@
           <p>The Jekyll gem makes a <code class="highlighter-rouge">jekyll</code> executable available to you in your Terminal
 window. You can use this command in a number of ways:</p>
 
-<div class="language-sh highlighter-rouge">
-<pre class="highlight"><code><span class="gp">$ </span>jekyll build
+<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>jekyll build
 <span class="c"># =&gt; The current folder will be generated into ./_site</span>
 
-<span class="gp">$ </span>jekyll build --destination &lt;destination&gt;
+<span class="nv">$ </span>jekyll build <span class="nt">--destination</span> &lt;destination&gt;
 <span class="c"># =&gt; The current folder will be generated into &lt;destination&gt;</span>
 
-<span class="gp">$ </span>jekyll build --source &lt;<span class="nb">source</span>&gt; --destination &lt;destination&gt;
+<span class="nv">$ </span>jekyll build <span class="nt">--source</span> &lt;<span class="nb">source</span><span class="o">&gt;</span> <span class="nt">--destination</span> &lt;destination&gt;
 <span class="c"># =&gt; The &lt;source&gt; folder will be generated into &lt;destination&gt;</span>
 
-<span class="gp">$ </span>jekyll build --watch
+<span class="nv">$ </span>jekyll build <span class="nt">--watch</span>
 <span class="c"># =&gt; The current folder will be generated into ./_site,</span>
 <span class="c">#    watched for changes, and regenerated automatically.</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <div class="note info">
   <h5>Changes to _config.yml are not included during automatic regeneration.</h5>
@@ -336,17 +334,15 @@ window. You can use this command in a number of ways:</p>
 <p>Jekyll also comes with a built-in development server that will allow you to
 preview what the generated site will look like in your browser locally.</p>
 
-<div class="language-sh highlighter-rouge">
-<pre class="highlight"><code><span class="gp">$ </span>jekyll serve
+<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>jekyll serve
 <span class="c"># =&gt; A development server will run at http://localhost:4000/</span>
 <span class="c"># Auto-regeneration: enabled. Use `--no-watch` to disable.</span>
 
-<span class="gp">$ </span>jekyll serve --detach
+<span class="nv">$ </span>jekyll serve <span class="nt">--detach</span>
 <span class="c"># =&gt; Same as `jekyll serve` but will detach from the current terminal.</span>
 <span class="c">#    If you need to kill the server, you can `kill -9 1234` where "1234" is the PID.</span>
 <span class="c">#    If you cannot find the PID, then do, `ps aux | grep jekyll` and kill the instance.</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <div class="note info">
   <h5>Be aware of default behavior</h5>
@@ -355,11 +351,9 @@ preview what the generated site will look like in your browser locally.</p>
   </p>
 </div>
 
-<div class="language-sh highlighter-rouge">
-<pre class="highlight"><code><span class="gp">$ </span>jekyll serve --no-watch
+<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>jekyll serve <span class="nt">--no-watch</span>
 <span class="c"># =&gt; Same as `jekyll serve` but will not watch for changes.</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>These are just a few of the available <a href="../configuration/">configuration options</a>.
 Many configuration options can either be specified as flags on the command line,
@@ -368,19 +362,15 @@ file at the root of the source directory. Jekyll will automatically use the
 options from this file when run. For example, if you place the following lines
 in your <code class="highlighter-rouge">_config.yml</code> file:</p>
 
-<div class="language-yaml highlighter-rouge">
-<pre class="highlight"><code><span class="s">source</span><span class="pi">:</span>      <span class="s">_source</span>
-<span class="s">destination</span><span class="pi">:</span> <span class="s">_deploy</span>
-</code></pre>
-</div>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">source</span><span class="pi">:</span>      <span class="s">_source</span>
+<span class="na">destination</span><span class="pi">:</span> <span class="s">_deploy</span>
+</code></pre></div></div>
 
 <p>Then the following two commands will be equivalent:</p>
 
-<div class="language-sh highlighter-rouge">
-<pre class="highlight"><code><span class="gp">$ </span>jekyll build
-<span class="gp">$ </span>jekyll build --source _source --destination _deploy
-</code></pre>
-</div>
+<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>jekyll build
+<span class="nv">$ </span>jekyll build <span class="nt">--source</span> _source <span class="nt">--destination</span> _deploy
+</code></pre></div></div>
 
 <p>For more about the possible configuration options, see the
 <a href="../configuration/">configuration</a> page.</p>

data/site/docs/variables/index.html

@@ -4,13 +4,13 @@
 <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.5.2">
+  <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.2.3 -->
+  <!-- Begin Jekyll SEO tag v2.3.0 -->
 <title>Variables | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Variables">
 <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
 <meta property="og:url" content="https://jekyllrb.com/docs/variables/">
 <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-08-12T13:36:54-07:00">
+<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">
-{"@context":"http://schema.org","@type":"BlogPosting","headline":"Variables","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"Jekyll traverses your site looking for files to process. Any files with YAML front matter are subject to processing. For each of these files, Jekyll makes a variety of data available via the Liquid templating system. The following is a reference of the available data.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/variables/"},"url":"https://jekyllrb.com/docs/variables/"}</script>
+{"name":null,"description":"Jekyll traverses your site looking for files to process. Any files with YAML front matter are subject to processing. For each of these files, Jekyll makes a variety of data available via the Liquid templating system. The following is a reference of the available data.","url":"https://jekyllrb.com/docs/variables/","headline":"Variables","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/variables/"},"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -468,17 +468,32 @@ following is a reference of the available data.</p>
 
       </p></td>
     </tr>
+    <tr>
+      <td><p><code>site.url</code></p></td>
+      <td><p>
+
+        Contains the url of your site as it is configured in the <code>_config.yml</code>.
+        For example, if you have <code>url: http://mysite.com</code>
+        in your configuration file, then it will be accessible in Liquid as
+        <code>site.url</code>. For the development environment there is
+        <a href="/news/#3-siteurl-is-set-by-the-development-server">an exception</a>,
+        if you are running <code>jekyll serve</code> in a development environment
+        <code>site.url</code> will be set to the value of <code>host</code>,
+        <code>port</code>, and SSL-related options. This defaults to
+        <code>url: http://localhost:4000</code>.
+
+      </p></td>
+    </tr>
     <tr>
       <td><p><code>site.[CONFIGURATION_DATA]</code></p></td>
       <td><p>
 
         All the variables set via the command line and your
         <code>_config.yml</code> are available through the <code>site</code>
-        variable. For example, if you have <code>url: http://mysite.com</code>
-        in your configuration file, then in your Posts and Pages it will be
-        stored in <code>site.url</code>. Jekyll does not parse changes to
-        <code>_config.yml</code> in <code>watch</code> mode, you must restart
-        Jekyll to see changes to variables.
+        variable. For example, if you have <code>foo: bar</code>
+        in your configuration file, then it will be accessible in Liquid as <code>site.foo</code>.
+        Jekyll does not parse changes to <code>_config.yml</code> in
+        <code>watch</code> mode, you must restart Jekyll to see changes to variables.
 
       </p></td>
     </tr>
@@ -548,8 +563,9 @@ following is a reference of the available data.</p>
       <td><p><code>page.id</code></p></td>
       <td><p>
 
-        An identifier unique to the Post (useful in RSS feeds). e.g.
+        An identifier unique to a document in a Collection or a Post (useful in RSS feeds). e.g.
         <code>/2008/12/14/my-post</code>
+        <code>/my-collection/my-document</code>
 
       </p></td>
     </tr>

data/site/docs/windows/index.html

@@ -4,13 +4,13 @@
 <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.5.2">
+  <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.2.3 -->
+  <!-- Begin Jekyll SEO tag v2.3.0 -->
 <title>Jekyll on Windows | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Jekyll on Windows">
 <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
 <meta property="og:url" content="https://jekyllrb.com/docs/windows/">
 <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-08-12T13:36:54-07:00">
+<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">
-{"@context":"http://schema.org","@type":"BlogPosting","headline":"Jekyll on Windows","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"While Windows is not an officially-supported platform, it can be used to run Jekyll with the proper tweaks. This page aims to collect some of the general knowledge and lessons that have been unearthed by Windows users.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/windows/"},"url":"https://jekyllrb.com/docs/windows/"}</script>
+{"name":null,"description":"While Windows is not an officially-supported platform, it can be used to run Jekyll with the proper tweaks. This page aims to collect some of the general knowledge and lessons that have been unearthed by Windows users.","url":"https://jekyllrb.com/docs/windows/","headline":"Jekyll on Windows","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/windows/"},"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -299,54 +299,40 @@
 
 <p>First let’s make sure all our packages / repositories are up to date. Open a new Command Prompt instance, and type the following:</p>
 
-<div class="highlighter-rouge">
-<pre class="highlight"><code>bash
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>bash
+</code></pre></div></div>
 <p>Your Command Prompt instance should now be a Bash instance. Now we must update our repo lists and packages.</p>
 
-<div class="highlighter-rouge">
-<pre class="highlight"><code>sudo apt-get update -y &amp;&amp; sudo apt-get upgrade -y
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo apt-get update -y &amp;&amp; sudo apt-get upgrade -y
+</code></pre></div></div>
 <p>Now we can install Ruby. To do this we will use a repository from <a href="https://www.brightbox.com/docs/ruby/ubuntu/">BrightBox</a>, which hosts optimized versions of Ruby for Ubuntu.</p>
 
-<div class="highlighter-rouge">
-<pre class="highlight"><code>sudo apt-add-repository ppa:brightbox/ruby-ng
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo apt-add-repository ppa:brightbox/ruby-ng
 sudo apt-get update
 sudo apt-get install ruby2.3 ruby2.3-dev build-essential
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <p>Next let’s update our Ruby gems:</p>
 
-<div class="highlighter-rouge">
-<pre class="highlight"><code>sudo gem update
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo gem update
+</code></pre></div></div>
 
 <p>Now all that is left to do is install Jekyll.</p>
 
-<div class="highlighter-rouge">
-<pre class="highlight"><code>sudo gem install jekyll bundler
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo gem install jekyll bundler
+</code></pre></div></div>
 
 <p>Check if Jekyll installed properly by running:</p>
 
-<div class="highlighter-rouge">
-<pre class="highlight"><code>jekyll -v
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jekyll -v
+</code></pre></div></div>
 
 <p><strong>And that’s it!</strong></p>
 
 <p>To start a new project named <code class="highlighter-rouge">my_blog</code>, just run:</p>
 
-<div class="highlighter-rouge">
-<pre class="highlight"><code>jekyll new my_blog
-</code></pre>
-</div>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jekyll new my_blog
+</code></pre></div></div>
 
 <p>You can make sure time management is working properly by inspecting your <code class="highlighter-rouge">_posts</code> folder. You should see a markdown file with the current date in the filename.</p>
 
@@ -421,16 +407,14 @@ sudo apt-get install ruby2.3 ruby2.3-dev build-essential
 
 <p><code class="language-ruby highlighter-rouge"><span class="n">choco</span> <span class="n">install</span> <span class="n">libiconv</span> <span class="o">-</span><span class="no">Source</span> <span class="s2">"https://www.nuget.org/api/v2/"</span></code></p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code> <span class="n">gem</span> <span class="n">install</span> <span class="n">nokogiri</span> <span class="o">--^</span>
-   <span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">xml2</span><span class="o">-</span><span class="kp">include</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libxml2</span><span class="o">.</span><span class="mi">2</span><span class="o">.</span><span class="mi">7</span><span class="o">.</span><span class="mi">8</span><span class="o">.</span><span class="mi">7</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="kp">include</span><span class="o">^</span>
-   <span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">xml2</span><span class="o">-</span><span class="n">lib</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libxml2</span><span class="p">.</span><span class="nf">redist</span><span class="o">.</span><span class="mi">2</span><span class="o">.</span><span class="mi">7</span><span class="o">.</span><span class="mi">8</span><span class="o">.</span><span class="mi">7</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="n">bin</span><span class="p">\</span><span class="n">v110</span><span class="p">\</span><span class="n">x64</span><span class="p">\</span><span class="no">Release</span><span class="p">\</span><span class="n">dynamic</span><span class="p">\</span><span class="n">cdecl</span><span class="o">^</span>
-   <span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">iconv</span><span class="o">-</span><span class="kp">include</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libiconv</span><span class="o">.</span><span class="mi">1</span><span class="o">.</span><span class="mi">14</span><span class="o">.</span><span class="mi">0</span><span class="o">.</span><span class="mi">11</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="kp">include</span><span class="o">^</span>
-   <span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">iconv</span><span class="o">-</span><span class="n">lib</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libiconv</span><span class="p">.</span><span class="nf">redist</span><span class="o">.</span><span class="mi">1</span><span class="o">.</span><span class="mi">14</span><span class="o">.</span><span class="mi">0</span><span class="o">.</span><span class="mi">11</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="n">bin</span><span class="p">\</span><span class="n">v110</span><span class="p">\</span><span class="n">x64</span><span class="p">\</span><span class="no">Release</span><span class="p">\</span><span class="n">dynamic</span><span class="p">\</span><span class="n">cdecl</span><span class="o">^</span>
-   <span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">xslt</span><span class="o">-</span><span class="kp">include</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libxslt</span><span class="o">.</span><span class="mi">1</span><span class="o">.</span><span class="mi">1</span><span class="o">.</span><span class="mi">28</span><span class="o">.</span><span class="mi">0</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="kp">include</span><span class="o">^</span>
-   <span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">xslt</span><span class="o">-</span><span class="n">lib</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libxslt</span><span class="p">.</span><span class="nf">redist</span><span class="o">.</span><span class="mi">1</span><span class="o">.</span><span class="mi">1</span><span class="o">.</span><span class="mi">28</span><span class="o">.</span><span class="mi">0</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="n">bin</span><span class="p">\</span><span class="n">v110</span><span class="p">\</span><span class="n">x64</span><span class="p">\</span><span class="no">Release</span><span class="p">\</span><span class="n">dynamic</span>
-</code></pre>
-</div>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="n">gem</span> <span class="n">install</span> <span class="n">nokogiri</span> <span class="o">--^</span>
+   <span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">xml2</span><span class="o">-</span><span class="kp">include</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libxml2</span><span class="o">.</span><span class="mf">2.7</span><span class="o">.</span><span class="mf">8.7</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="kp">include</span><span class="o">^</span>
+   <span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">xml2</span><span class="o">-</span><span class="n">lib</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libxml2</span><span class="p">.</span><span class="nf">redist</span><span class="o">.</span><span class="mf">2.7</span><span class="o">.</span><span class="mf">8.7</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="n">bin</span><span class="p">\</span><span class="n">v110</span><span class="p">\</span><span class="n">x64</span><span class="p">\</span><span class="no">Release</span><span class="p">\</span><span class="n">dynamic</span><span class="p">\</span><span class="n">cdecl</span><span class="o">^</span>
+   <span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">iconv</span><span class="o">-</span><span class="kp">include</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libiconv</span><span class="o">.</span><span class="mf">1.14</span><span class="o">.</span><span class="mf">0.11</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="kp">include</span><span class="o">^</span>
+   <span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">iconv</span><span class="o">-</span><span class="n">lib</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libiconv</span><span class="p">.</span><span class="nf">redist</span><span class="o">.</span><span class="mf">1.14</span><span class="o">.</span><span class="mf">0.11</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="n">bin</span><span class="p">\</span><span class="n">v110</span><span class="p">\</span><span class="n">x64</span><span class="p">\</span><span class="no">Release</span><span class="p">\</span><span class="n">dynamic</span><span class="p">\</span><span class="n">cdecl</span><span class="o">^</span>
+   <span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">xslt</span><span class="o">-</span><span class="kp">include</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libxslt</span><span class="o">.</span><span class="mf">1.1</span><span class="o">.</span><span class="mf">28.0</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="kp">include</span><span class="o">^</span>
+   <span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">xslt</span><span class="o">-</span><span class="n">lib</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libxslt</span><span class="p">.</span><span class="nf">redist</span><span class="o">.</span><span class="mf">1.1</span><span class="o">.</span><span class="mf">28.0</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="n">bin</span><span class="p">\</span><span class="n">v110</span><span class="p">\</span><span class="n">x64</span><span class="p">\</span><span class="no">Release</span><span class="p">\</span><span class="n">dynamic</span>
+</code></pre></div></div>
 
 <h4 id="install-github-pages">Install github-pages</h4>
 
@@ -441,11 +425,9 @@ sudo apt-get install ruby2.3 ruby2.3-dev build-essential
   <li>Copy &amp; paste the two lines into the file:</li>
 </ul>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="n">source</span> <span class="s1">'https://rubygems.org'</span>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">source</span> <span class="s1">'https://rubygems.org'</span>
 <span class="n">gem</span> <span class="s1">'github-pages'</span><span class="p">,</span> <span class="ss">group: :jekyll_plugins</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <ul>
   <li>
@@ -474,10 +456,8 @@ Jekyll. This is especially relevant when you’re running Jekyll on Windows.</p>
 
 <p>Additionally, you might need to change the code page of the console window to UTF-8 in case you get a “Liquid Exception: Incompatible character encoding” error during the site generation process. It can be done with the following command:</p>
 
-<div class="language-sh highlighter-rouge">
-<pre class="highlight"><code><span class="gp">$ </span>chcp 65001
-</code></pre>
-</div>
+<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>chcp 65001
+</code></pre></div></div>
 
 <h2 id="time-zone-management">Time-Zone Management</h2>
 
@@ -487,11 +467,9 @@ Though Windows users could alternatively define their blog’s timezone by setti
 <p>Jekyll now uses a rubygem to internally configure Timezone based on established <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones">IANA Timezone Database</a>.
 While ‘new’ blogs created with Jekyll v3.4 and greater, will have the following added to their ‘Gemfile’ by default, existing sites <em>will</em> have to update their ‘Gemfile’ (and installed) to enable development on Windows:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="c1"># Windows does not include zoneinfo files, so bundle the tzinfo-data gem</span>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1"># Windows does not include zoneinfo files, so bundle the tzinfo-data gem</span>
 <span class="n">gem</span> <span class="s1">'tzinfo-data'</span><span class="p">,</span> <span class="ss">platforms: </span><span class="p">[</span><span class="ss">:mingw</span><span class="p">,</span> <span class="ss">:mswin</span><span class="p">,</span> <span class="ss">:x64_mingw</span><span class="p">,</span> <span class="ss">:jruby</span><span class="p">]</span>
-</code></pre>
-</div>
+</code></pre></div></div>
 
 <h2 id="auto-regeneration">Auto Regeneration</h2>
 
@@ -499,10 +477,10 @@ While ‘new’ blogs created with Jekyll v3.4 and greater, will have the follow
 
 <p>Add the following to the Gemfile for your site if you have issues with auto-regeneration on Windows alone:</p>
 
-<div class="language-ruby highlighter-rouge">
-<pre class="highlight"><code><span class="n">gem</span> <span class="s1">'wdm'</span><span class="p">,</span> <span class="s1">'~&gt; 0.1.0'</span> <span class="k">if</span> <span class="no">Gem</span><span class="p">.</span><span class="nf">win_platform?</span>
-</code></pre>
-</div>
+<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">gem</span> <span class="s1">'wdm'</span><span class="p">,</span> <span class="s1">'~&gt; 0.1.1'</span> <span class="k">if</span> <span class="no">Gem</span><span class="p">.</span><span class="nf">win_platform?</span>
+</code></pre></div></div>
+
+<p>You may first have to download and install the <a href="https://rubyinstaller.org/downloads/">Ruby DevKit</a> by following <a href="https://github.com/oneclick/rubyinstaller/wiki/Development-Kit">the instructions here</a>.</p>