jekyll-docs 3.4.3 → 3.5.1

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

@@ -4,35 +4,28 @@
 <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.4.3">
+  <meta name="generator" content="Jekyll v3.5.1">
   <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.1.0 -->
-<title>Upgrading from 2.x to 3.x - Jekyll • Simple, blog-aware, static sites</title>
+  <!-- Begin Jekyll SEO tag v2.2.3 -->
+<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">
 <meta name="description" content="Upgrading from an older version of Jekyll? A few things have changed in 3.0 that you’ll want to know about.">
 <meta property="og:description" content="Upgrading from an older version of Jekyll? A few things have changed in 3.0 that you’ll want to know about.">
 <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="2017-03-22T08:08:47-07:00">
+<meta property="article:published_time" content="2017-07-17T13:16:40-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-03-22T08:08:47-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"}},
-"url": "https://jekyllrb.com/docs/upgrading/2-to-3/"}</script>
+{"@context":"http://schema.org","@type":"BlogPosting","headline":"Upgrading from 2.x to 3.x","datePublished":"2017-07-17T13:16:40-07:00","dateModified":"2017-07-17T13:16:40-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>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -62,7 +55,7 @@
     <a href="/help/">Help</a>
   </li>
   <li>
-    <a href="https://github.com/jekyll/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a>
+    <a href="https://github.com/jekyll/jekyll">GitHub</a>
   </li>
 </ul>
 
@@ -94,7 +87,7 @@
     <a href="/help/">Help</a>
   </li>
   <li>
-    <a href="https://github.com/jekyll/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a>
+    <a href="https://github.com/jekyll/jekyll">GitHub</a>
   </li>
 </ul>
 
@@ -126,6 +119,10 @@
 
   
   
+  <option value="/docs/windows/">Jekyll on Windows</option>
+
+  
+  
   <option value="/docs/usage/">Basic Usage</option>
 
   
@@ -300,7 +297,7 @@ that you’ll want to know about.</p>
 </code></pre>
 </div>
 
-<p>Please note: Jekyll 3 requires Ruby version &gt;= 2.0.0.</p>
+<p>Please note: Jekyll 3.2 requires Ruby version &gt;= 2.1</p>
 
 <div class="note feature">
   <h5>Diving in</h5>
@@ -532,6 +529,9 @@ https://jekyllrb.com/docs/upgrading/ for more info.
   
 
   
+  
+
+  
   
 
   
@@ -577,6 +577,10 @@ https://jekyllrb.com/docs/upgrading/ for more info.
 
   
   
+  <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
+
+  
+  
   <li class=""><a href="/docs/usage/">Basic Usage</a></li>
 
   

data/site/docs/upgrading/index.html

@@ -4,35 +4,28 @@
 <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.4.3">
+  <meta name="generator" content="Jekyll v3.5.1">
   <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.1.0 -->
-<title>Upgrading - Jekyll • Simple, blog-aware, static sites</title>
+  <!-- Begin Jekyll SEO tag v2.2.3 -->
+<title>Upgrading | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Upgrading">
+<meta property="og:locale" content="en_US">
 <meta name="description" content="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:">
 <meta property="og:description" content="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:">
 <link rel="canonical" href="https://jekyllrb.com/docs/upgrading/">
 <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-03-22T08:08:47-07:00">
+<meta property="article:published_time" content="2017-07-17T13:16:40-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-03-22T08:08:47-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"}},
-"url": "https://jekyllrb.com/docs/upgrading/"}</script>
+{"@context":"http://schema.org","@type":"BlogPosting","headline":"Upgrading","datePublished":"2017-07-17T13:16:40-07:00","dateModified":"2017-07-17T13:16:40-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>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -62,7 +55,7 @@
     <a href="/help/">Help</a>
   </li>
   <li>
-    <a href="https://github.com/jekyll/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a>
+    <a href="https://github.com/jekyll/jekyll">GitHub</a>
   </li>
 </ul>
 
@@ -94,7 +87,7 @@
     <a href="/help/">Help</a>
   </li>
   <li>
-    <a href="https://github.com/jekyll/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a>
+    <a href="https://github.com/jekyll/jekyll">GitHub</a>
   </li>
 </ul>
 
@@ -126,6 +119,10 @@
 
   
   
+  <option value="/docs/windows/">Jekyll on Windows</option>
+
+  
+  
   <option value="/docs/usage/">Basic Usage</option>
 
   
@@ -297,6 +294,9 @@
   <li><a href="/docs/upgrading/2-to-3/">From 2.x to 3.x</a></li>
 </ul>
 
+<p>If you are making a minor update (for example from 3.3.1 to the latest version at the time 3.3.2) run ‘bundle update jekyll’ when in your site directory. 
+If you would like to update all your gems, run ‘bundle update’ when in your site directory.</p>
+
           
 
 
@@ -404,6 +404,9 @@
 
   
   
+
+  
+  
 
   
   
@@ -431,6 +434,10 @@
 
   
   
+  <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
+
+  
+  
   <li class=""><a href="/docs/usage/">Basic Usage</a></li>
 
   

data/site/docs/usage/index.html

@@ -4,35 +4,28 @@
 <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.4.3">
+  <meta name="generator" content="Jekyll v3.5.1">
   <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.1.0 -->
-<title>Basic Usage - Jekyll • Simple, blog-aware, static sites</title>
+  <!-- Begin Jekyll SEO tag v2.2.3 -->
+<title>Basic Usage | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Basic Usage">
+<meta property="og:locale" content="en_US">
 <meta name="description" content="The Jekyll gem makes a jekyll executable available to you in your Terminal window. You can use this command in a number of ways:">
 <meta property="og:description" content="The Jekyll gem makes a jekyll executable available to you in your Terminal window. You can use this command in a number of ways:">
 <link rel="canonical" href="https://jekyllrb.com/docs/usage/">
 <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-03-22T08:08:47-07:00">
+<meta property="article:published_time" content="2017-07-17T13:16:40-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-03-22T08:08:47-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"}},
-"url": "https://jekyllrb.com/docs/usage/"}</script>
+{"@context":"http://schema.org","@type":"BlogPosting","headline":"Basic Usage","datePublished":"2017-07-17T13:16:40-07:00","dateModified":"2017-07-17T13:16:40-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>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -62,7 +55,7 @@
     <a href="/help/">Help</a>
   </li>
   <li>
-    <a href="https://github.com/jekyll/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a>
+    <a href="https://github.com/jekyll/jekyll">GitHub</a>
   </li>
 </ul>
 
@@ -94,7 +87,7 @@
     <a href="/help/">Help</a>
   </li>
   <li>
-    <a href="https://github.com/jekyll/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a>
+    <a href="https://github.com/jekyll/jekyll">GitHub</a>
   </li>
 </ul>
 
@@ -126,6 +119,10 @@
 
   
   
+  <option value="/docs/windows/">Jekyll on Windows</option>
+
+  
+  
   <option value="/docs/usage/">Basic Usage</option>
 
   
@@ -414,13 +411,16 @@ in your <code class="highlighter-rouge">_config.yml</code> file:</p>
   
 
   
+  
+
+  
   
     <div class="section-nav">
       <div class="left align-right">
           
             
             
-            <a href="/docs/installation/" class="prev">Back</a>
+            <a href="/docs/windows/" class="prev">Back</a>
           
       </div>
       <div class="right align-left">
@@ -456,6 +456,10 @@ in your <code class="highlighter-rouge">_config.yml</code> file:</p>
 
   
   
+  <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
+
+  
+  
   <li class="current"><a href="/docs/usage/">Basic Usage</a></li>
 
   

data/site/docs/variables/index.html

@@ -4,35 +4,28 @@
 <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.4.3">
+  <meta name="generator" content="Jekyll v3.5.1">
   <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.1.0 -->
-<title>Variables - Jekyll • Simple, blog-aware, static sites</title>
+  <!-- Begin Jekyll SEO tag v2.2.3 -->
+<title>Variables | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Variables">
+<meta property="og:locale" content="en_US">
 <meta name="description" content="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.">
 <meta property="og:description" content="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.">
 <link rel="canonical" href="https://jekyllrb.com/docs/variables/">
 <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-03-22T08:08:47-07:00">
+<meta property="article:published_time" content="2017-07-17T13:16:40-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-03-22T08:08:47-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"}},
-"url": "https://jekyllrb.com/docs/variables/"}</script>
+{"@context":"http://schema.org","@type":"BlogPosting","headline":"Variables","datePublished":"2017-07-17T13:16:40-07:00","dateModified":"2017-07-17T13:16:40-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>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -62,7 +55,7 @@
     <a href="/help/">Help</a>
   </li>
   <li>
-    <a href="https://github.com/jekyll/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a>
+    <a href="https://github.com/jekyll/jekyll">GitHub</a>
   </li>
 </ul>
 
@@ -94,7 +87,7 @@
     <a href="/help/">Help</a>
   </li>
   <li>
-    <a href="https://github.com/jekyll/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a>
+    <a href="https://github.com/jekyll/jekyll">GitHub</a>
   </li>
 </ul>
 
@@ -126,6 +119,10 @@
 
   
   
+  <option value="/docs/windows/">Jekyll on Windows</option>
+
+  
+  
   <option value="/docs/usage/">Basic Usage</option>
 
   
@@ -728,6 +725,9 @@ following is a reference of the available data.</p>
   
 
   
+  
+
+  
   
 
   
@@ -773,6 +773,10 @@ following is a reference of the available data.</p>
 
   
   
+  <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
+
+  
+  
   <li class=""><a href="/docs/usage/">Basic Usage</a></li>
 
   

data/site/docs/windows/index.html

@@ -4,35 +4,28 @@
 <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.4.3">
+  <meta name="generator" content="Jekyll v3.5.1">
   <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.1.0 -->
-<title>Jekyll on Windows - Jekyll • Simple, blog-aware, static sites</title>
+  <!-- Begin Jekyll SEO tag v2.2.3 -->
+<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">
 <meta name="description" content="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.">
 <meta property="og:description" content="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.">
 <link rel="canonical" href="https://jekyllrb.com/docs/windows/">
 <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-03-22T08:08:47-07:00">
+<meta property="article:published_time" content="2017-07-17T13:16:40-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-03-22T08:08:47-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"}},
-"url": "https://jekyllrb.com/docs/windows/"}</script>
+{"@context":"http://schema.org","@type":"BlogPosting","headline":"Jekyll on Windows","datePublished":"2017-07-17T13:16:40-07:00","dateModified":"2017-07-17T13:16:40-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>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -62,7 +55,7 @@
     <a href="/help/">Help</a>
   </li>
   <li>
-    <a href="https://github.com/jekyll/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a>
+    <a href="https://github.com/jekyll/jekyll">GitHub</a>
   </li>
 </ul>
 
@@ -94,7 +87,7 @@
     <a href="/help/">Help</a>
   </li>
   <li>
-    <a href="https://github.com/jekyll/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a>
+    <a href="https://github.com/jekyll/jekyll">GitHub</a>
   </li>
 </ul>
 
@@ -126,6 +119,10 @@
 
   
   
+  <option value="/docs/windows/">Jekyll on Windows</option>
+
+  
+  
   <option value="/docs/usage/">Basic Usage</option>
 
   
@@ -290,69 +287,99 @@
             <a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/windows.md"><i class="fa fa-pencil"></i>  Improve this page</a>
           </div>
           <h1>Jekyll on Windows</h1>
-          <p>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.</p>
+          <p>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.</p>
 
-<h2 id="installation">Installation</h2>
+<h2 id="installing-jekyll">Installing Jekyll</h2>
 
-<p>A quick way to install Jekyll is to follow the <a href="https://davidburela.wordpress.com/2015/11/28/easily-install-jekyll-on-windows-with-3-command-prompt-entries-and-chocolatey/">installation instructions by David Burela</a>:</p>
+<p>If you are using Windows 10 Anniversary Update, the easiest way to run Jekyll is by <a href="https://msdn.microsoft.com/en-us/commandline/wsl/install_guide">installing</a> the new Bash on Ubuntu on Windows.</p>
 
-<ol>
-  <li>Install a package manager for Windows called <a href="https://chocolatey.org/install">Chocolatey</a>
-</li>
-  <li>Install Ruby via Chocolatey: <code class="highlighter-rouge">choco install ruby -y</code>
-</li>
-  <li>Reopen a command prompt and install Jekyll: <code class="highlighter-rouge">gem install jekyll</code>
-</li>
-</ol>
+<h3 id="installation-via-bash-on-windows-10">Installation via Bash on Windows 10</h3>
 
-<p>Updates in the infrastructure of Ruby may cause SSL errors when attempting to use <code class="highlighter-rouge">gem install</code> with versions of the RubyGems package older than 2.6. (The RubyGems package installed via the Chocolatey tool is version 2.3) If you have installed an older version, you can update the RubyGems package using the directions <a href="http://guides.rubygems.org/ssl-certificate-update/#installing-using-update-packages">here</a>.</p>
+<p><em>Note:</em> You must have <a href="https://msdn.microsoft.com/en-us/commandline/wsl/about">Bash on Ubuntu on Windows</a> enabled.</p>
 
-<p>For a more conventional way of installing Jekyll you can follow this <a href="https://labs.sverrirs.com/jekyll/">complete guide to install Jekyll 3 on Windows by Sverrir Sigmundarson</a>.</p>
+<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>
 
-<h2 id="encoding">Encoding</h2>
+<div class="highlighter-rouge">
+<pre class="highlight"><code>bash
+</code></pre>
+</div>
+<p>Your Command Prompt instance should now be a Bash instance. Now we must update our repo lists and packages.</p>
 
-<p>If you use UTF-8 encoding, make sure that no <code class="highlighter-rouge">BOM</code> header
-characters exist in your files or very, very bad things will happen to
-Jekyll. This is especially relevant if you’re running Jekyll on Windows.</p>
+<div class="highlighter-rouge">
+<pre class="highlight"><code>sudo apt-get update -y &amp;&amp; sudo apt-get upgrade -y
+</code></pre>
+</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>
 
-<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="highlighter-rouge">
+<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>
 
-<div class="language-sh highlighter-rouge">
-<pre class="highlight"><code><span class="gp">$ </span>chcp 65001
+<p>Next let’s update our Ruby gems:</p>
+
+<div class="highlighter-rouge">
+<pre class="highlight"><code>sudo gem update
 </code></pre>
 </div>
 
-<h2 id="timezone-management">Timezone Management</h2>
+<p>Now all that is left to do is install Jekyll.</p>
 
-<p>Since Windows doesn’t have a native source of zoneinfo data, the Ruby Interpreter would not understand IANA Timezones and hence using them had the <code class="highlighter-rouge">TZ</code> environment variable default to UTC/GMT 00:00.
-Though Windows users could alternatively define their blog’s timezone by setting the key to use POSIX format of defining timezones, it wasn’t as user-friendly when it came to having the clock altered to changing DST-rules.</p>
+<div class="highlighter-rouge">
+<pre class="highlight"><code>sudo gem install jekyll bundler
+</code></pre>
+</div>
 
-<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>
+<p>Check if Jekyll installed properly by running:</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>
-<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>
+<div class="highlighter-rouge">
+<pre class="highlight"><code>jekyll -v
 </code></pre>
 </div>
 
-<h2 id="auto-regeneration">Auto-regeneration</h2>
+<p><strong>And that’s it!</strong></p>
 
-<p>As of v1.3.0, Jekyll uses the <code class="highlighter-rouge">listen</code> gem to watch for changes when the
-<code class="highlighter-rouge">--watch</code> switch is specified during a build or serve. While <code class="highlighter-rouge">listen</code> has
-built-in support for UNIX systems, it requires an extra gem for compatibility
-with Windows. Add the following to the Gemfile for your site:</p>
+<p>To start a new project named <code class="highlighter-rouge">my_blog</code>, just run:</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>
+<div class="highlighter-rouge">
+<pre class="highlight"><code>jekyll new my_blog
 </code></pre>
 </div>
 
-<h3 id="how-to-install-github-pages">How to install github-pages</h3>
+<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>
+
+<p><strong>Note:</strong> Bash on Ubuntu on Windows is still under development, so you may run into issues.</p>
+
+<h3 id="installation-via-rubyinstaller">Installation via RubyInstaller</h3>
+
+<p><a href="https://rubyinstaller.org/">RubyInstaller</a> is a self-contained Windows-based installer that includes the Ruby language, an execution environment, important documentation, and more.</p>
+
+<ol>
+  <li>Download and Install a package manager version from <a href="https://rubyinstaller.org/downloads/">RubyInstaller Downloads</a>.</li>
+  <li>Install Jekyll and Bundler via a command prompt window: <code class="highlighter-rouge">gem install jekyll bundler</code>
+</li>
+  <li>Check if Jekyll installed properly: <code class="highlighter-rouge">jekyll -v</code>
+</li>
+</ol>
+
+<h3 id="installation-via-chocolatey">Installation via Chocolatey</h3>
+
+<p>A quick way to install Jekyll using Chocolatey is to follow the <a href="https://davidburela.wordpress.com/2015/11/28/easily-install-jekyll-on-windows-with-3-command-prompt-entries-and-chocolatey/">installation instructions by David Burela</a>:</p>
+
+<ol>
+  <li>Install a package manager for Windows called <a href="https://chocolatey.org/install" title="Package manager for Windows">Chocolatey</a>
+</li>
+  <li>Install Ruby via Chocolatey: <code class="highlighter-rouge">choco install ruby -y</code>
+</li>
+  <li>Reopen a command prompt and install Jekyll: <code class="highlighter-rouge">gem install jekyll</code>
+</li>
+</ol>
+
+<p>Updates in the infrastructure of Ruby may cause SSL errors when attempting to use <code class="highlighter-rouge">gem install</code> with versions of the RubyGems package older than 2.6. (The RubyGems package installed via the Chocolatey tool is version 2.3) If you have installed an older version, you can update the RubyGems package using the directions <a href="http://guides.rubygems.org/ssl-certificate-update/#installing-using-update-packages">here</a>.</p>
+
+<h3 id="installing-github-pages-via-chocolatey">Installing <em>github-pages</em> via Chocolatey</h3>
 
 <p>This section is part of an article written by <a href="https://jwillmer.de/blog/tutorial/how-to-install-jekyll-and-pages-gem-on-windows-10-x46" title="Installation instructions by Jens Willmer">Jens Willmer</a>. To follow the instructions you need to have <a href="https://chocolatey.org/install" title="Package manager for Windows">Chocolatey</a> installed on your system. If you already have a version of Ruby installed you need to uninstall it before you can continue.</p>
 
@@ -427,110 +454,61 @@ with Windows. Add the following to the Gemfile for your site:</p>
 </li>
 </ul>
 
-<p>After this process you should have github-pages installed on your system and you can host your blog again with <code class="highlighter-rouge">jekyll s</code>. <br>
+<p>After this process you should have github-pages installed on your system and you can host your blog again with <code class="highlighter-rouge">jekyll s</code>.
 There will be a warning on startup that you should include <code class="highlighter-rouge">gem 'wdm', '&gt;= 0.1.0' if Gem.win_platform?</code> to your <code class="highlighter-rouge">Gemfile</code> but I could not get <code class="highlighter-rouge">jekyll s</code> working if I include that line so for the moment I ignore that warning.</p>
 
 <p>In the future the installation process of the github-pages should be as simple as the setup of the blog. But as long as the new version of the Nokogiri (<a href="https://github.com/sparklemotion/nokogiri/releases" title="Nokogiri Releases">v1.6.8</a>) is not stable and referenced, it is work to get it up and running on Windows.</p>
 
+<hr>
 
-          
-
-
-
-
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
-
-  
-  
+<p>For a more conventional way of installing Jekyll you can follow this <a href="https://labs.sverrirs.com/jekyll/">complete guide to install Jekyll 3 on Windows by Sverrir Sigmundarson</a>.</p>
 
-  
-  
+<p>Optionally you can use <a href="https://github.com/KeJunMao/fastjekyll#autoinstall-jekyll-for-windows">Autoinstall Jekyll for Windows</a>.</p>
 
-  
-  
+<hr>
 
-  
-  
-
-  
-  
+<h2 id="encoding">Encoding</h2>
 
-  
-  
+<p>If you use UTF-8 encoding, make sure that no <code class="highlighter-rouge">BOM</code> header characters exist in your files or very, very bad things will happen to
+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>
 
-  
-  
+<h2 id="time-zone-management">Time-Zone Management</h2>
 
-  
-  
+<p>Since Windows doesn’t have a native source of zoneinfo data, the Ruby Interpreter would not understand IANA Timezones and hence using them had the <code class="highlighter-rouge">TZ</code> environment variable default to UTC/GMT 00:00.
+Though Windows users could alternatively define their blog’s timezone by setting the key to use POSIX format of defining timezones, it wasn’t as user-friendly when it came to having the clock altered to changing DST-rules.</p>
 
-  
-  
+<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>
+<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>
 
-  
-  
+<h2 id="auto-regeneration">Auto Regeneration</h2>
 
-  
-  
+<p>As of v1.3.0, Jekyll uses the <code class="highlighter-rouge">listen</code> gem to watch for changes when the <code class="highlighter-rouge">--watch</code> switch is specified during a build or serve. While <code class="highlighter-rouge">listen</code> has built-in support for UNIX systems, it may require an extra gem for compatibility with Windows.</p>
 
-  
-  
+<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>
 
-  
-  
+          
 
-  
-  
 
-  
-  
 
-  
-  
 
-  
-  
 
   
   
@@ -543,7 +521,24 @@ There will be a warning on startup that you should include <code class="highligh
 
   
   
-
+    <div class="section-nav">
+      <div class="left align-right">
+          
+            
+            
+            <a href="/docs/installation/" class="prev">Back</a>
+          
+      </div>
+      <div class="right align-left">
+          
+            
+            
+            <a href="/docs/usage/" class="next">Next</a>
+          
+      </div>
+    </div>
+    <div class="clear"></div>
+    
         </article>
       </div>
 
@@ -567,6 +562,10 @@ There will be a warning on startup that you should include <code class="highligh
 
   
   
+  <li class="current"><a href="/docs/windows/">Jekyll on Windows</a></li>
+
+  
+  
   <li class=""><a href="/docs/usage/">Basic Usage</a></li>