jekyll-docs 3.4.3 → 3.5.1

data/site/docs/sites/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>Sites using Jekyll - Jekyll • Simple, blog-aware, static sites</title>
+  <!-- Begin Jekyll SEO tag v2.2.3 -->
+<title>Sites using Jekyll | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Sites using Jekyll">
+<meta property="og:locale" content="en_US">
 <meta name="description" content="It’s interesting to see what designs and features others have come up with. Below are some Jekyll-powered blogs which were hand-picked for learning purposes.">
 <meta property="og:description" content="It’s interesting to see what designs and features others have come up with. Below are some Jekyll-powered blogs which were hand-picked for learning purposes.">
 <link rel="canonical" href="https://jekyllrb.com/docs/sites/">
 <meta property="og:url" content="https://jekyllrb.com/docs/sites/">
 <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": "Sites using Jekyll",
-"datePublished": "2017-03-22T08:08:47-07:00",
-"description": "It’s interesting to see what designs and features others have come up with. Below are some Jekyll-powered blogs which were hand-picked for learning purposes.",
-"publisher": {"@type": "Organization",
-"logo": {"@type": "ImageObject",
-"url": "https://jekyllrb.com/img/logo-2x.png"}},
-"url": "https://jekyllrb.com/docs/sites/"}</script>
+{"@context":"http://schema.org","@type":"BlogPosting","headline":"Sites using Jekyll","datePublished":"2017-07-17T13:16:40-07:00","dateModified":"2017-07-17T13:16:40-07:00","description":"It’s interesting to see what designs and features others have come up with. Below are some Jekyll-powered blogs which were hand-picked for learning purposes.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/sites/"},"url":"https://jekyllrb.com/docs/sites/"}</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>
 
   
@@ -304,6 +301,9 @@ learning purposes.</p>
   <li>
 <a href="https://rsms.me/">Rasmus Andersson</a>
   (<a href="https://github.com/rsms/rsms.github.com">source</a>)</li>
+  <li>
+<a href="https://mvvmcross.github.io/MvvmCross/">MvvmCross</a>
+  (<a href="https://github.com/MvvmCross/MvvmCross/tree/master/docs">source</a>)</li>
 </ul>
 
 <p>If you would like to explore more examples, you can find a list of sites
@@ -395,6 +395,9 @@ and their sources on the <a href="https://github.com/jekyll/jekyll/wiki/Sites">
   
 
   
+  
+
+  
   
 
   
@@ -440,6 +443,10 @@ and their sources on the <a href="https://github.com/jekyll/jekyll/wiki/Sites">
 
   
   
+  <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
+
+  
+  
   <li class=""><a href="/docs/usage/">Basic Usage</a></li>
 
   

data/site/docs/static-files/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>Static Files - Jekyll • Simple, blog-aware, static sites</title>
+  <!-- Begin Jekyll SEO tag v2.2.3 -->
+<title>Static Files | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Static Files">
+<meta property="og:locale" content="en_US">
 <meta name="description" content="In addition to renderable and convertible content, we also have static files.">
 <meta property="og:description" content="In addition to renderable and convertible content, we also have static files.">
 <link rel="canonical" href="https://jekyllrb.com/docs/static-files/">
 <meta property="og:url" content="https://jekyllrb.com/docs/static-files/">
 <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": "Static Files",
-"datePublished": "2017-03-22T08:08:47-07:00",
-"description": "In addition to renderable and convertible content, we also have static files.",
-"publisher": {"@type": "Organization",
-"logo": {"@type": "ImageObject",
-"url": "https://jekyllrb.com/img/logo-2x.png"}},
-"url": "https://jekyllrb.com/docs/static-files/"}</script>
+{"@context":"http://schema.org","@type":"BlogPosting","headline":"Static Files","datePublished":"2017-07-17T13:16:40-07:00","dateModified":"2017-07-17T13:16:40-07:00","description":"In addition to renderable and convertible content, we also have static files.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/static-files/"},"url":"https://jekyllrb.com/docs/static-files/"}</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>
 
   
@@ -353,6 +350,39 @@ following metadata:</p>
 </table>
 </div>
 
+<p>Note that in the above table, <code class="highlighter-rouge">file</code> can be anything. It’s simply an arbitrarily set variable used in your own logic (such as in a for loop). It isn’t a global site or page variable.</p>
+
+<h2 id="add-front-matter-to-static-files">Add front matter to static files</h2>
+
+<p>Although you can’t directly add front matter values to static files, you can set front matter values through the <a href="../configuration/#front-matter-defaults">defaults property</a> in your configuration file. When Jekyll builds the site, it will use the front matter values you set.</p>
+
+<p>Here’s an example:</p>
+
+<p>In your <code class="highlighter-rouge">_config.yml</code> file, add the following values to the <code class="highlighter-rouge">defaults</code> property:</p>
+
+<div class="language-yaml highlighter-rouge">
+<pre class="highlight"><code><span class="s">defaults</span><span class="pi">:</span>
+  <span class="pi">-</span> <span class="s">scope</span><span class="pi">:</span>
+      <span class="s">path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">assets/img"</span>
+    <span class="s">values</span><span class="pi">:</span>
+      <span class="s">image</span><span class="pi">:</span> <span class="s">true</span>
+</code></pre>
+</div>
+
+<p>This assumes that your Jekyll site has a folder path of <code class="highlighter-rouge">assets/img</code> where  you have images (static files) stored. When Jekyll builds the site, it will treat each image as if it had the front matter value of <code class="highlighter-rouge">image: true</code>.</p>
+
+<p>Suppose you want to list all your image assets as contained in <code class="highlighter-rouge">assets/img</code>. You could use this for loop to look in the <code class="highlighter-rouge">static_files</code> object and get all static files that have this front matter property:</p>
+
+<div class="language-liquid highlighter-rouge">
+<pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">assign</span><span class="w"> </span><span class="nv">image_files</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">static_files</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">"image"</span><span class="p">,</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="p">%}</span>
+<span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span>myimage<span class="w"> </span>in<span class="w"> </span>image_files<span class="w"> </span><span class="p">%}</span>
+  <span class="p">{{</span><span class="w"> </span><span class="nv">myimage</span><span class="p">.</span><span class="nv">path</span><span class="w"> </span><span class="p">}}</span>
+<span class="p">{%</span><span class="w"> </span><span class="nt">endfor</span><span class="w"> </span><span class="p">%}</span>
+</code></pre>
+</div>
+
+<p>When you build your site, the output will list the path to each file that meets this front matter condition.</p>
+
           
 
 
@@ -387,6 +417,9 @@ following metadata:</p>
   
 
   
+  
+
+  
   
 
   
@@ -432,6 +465,10 @@ following metadata:</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/structure/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>Directory structure - Jekyll • Simple, blog-aware, static sites</title>
+  <!-- Begin Jekyll SEO tag v2.2.3 -->
+<title>Directory structure | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Directory structure">
+<meta property="og:locale" content="en_US">
 <meta name="description" content="Jekyll is, at its core, a text transformation engine. The concept behind the system is this: you give it text written in your favorite markup language, be that Markdown, Textile, or just plain HTML, and it churns that through a layout or a series of layout files. Throughout that process you can tweak how you want the site URLs to look, what data gets displayed in the layout, and more. This is all done through editing text files; the static web site is the final product.">
 <meta property="og:description" content="Jekyll is, at its core, a text transformation engine. The concept behind the system is this: you give it text written in your favorite markup language, be that Markdown, Textile, or just plain HTML, and it churns that through a layout or a series of layout files. Throughout that process you can tweak how you want the site URLs to look, what data gets displayed in the layout, and more. This is all done through editing text files; the static web site is the final product.">
 <link rel="canonical" href="https://jekyllrb.com/docs/structure/">
 <meta property="og:url" content="https://jekyllrb.com/docs/structure/">
 <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": "Directory structure",
-"datePublished": "2017-03-22T08:08:47-07:00",
-"description": "Jekyll is, at its core, a text transformation engine. The concept behind the system is this: you give it text written in your favorite markup language, be that Markdown, Textile, or just plain HTML, and it churns that through a layout or a series of layout files. Throughout that process you can tweak how you want the site URLs to look, what data gets displayed in the layout, and more. This is all done through editing text files; the static web site is the final product.",
-"publisher": {"@type": "Organization",
-"logo": {"@type": "ImageObject",
-"url": "https://jekyllrb.com/img/logo-2x.png"}},
-"url": "https://jekyllrb.com/docs/structure/"}</script>
+{"@context":"http://schema.org","@type":"BlogPosting","headline":"Directory structure","datePublished":"2017-07-17T13:16:40-07:00","dateModified":"2017-07-17T13:16:40-07:00","description":"Jekyll is, at its core, a text transformation engine. The concept behind the system is this: you give it text written in your favorite markup language, be that Markdown, Textile, or just plain HTML, and it churns that through a layout or a series of layout files. Throughout that process you can tweak how you want the site URLs to look, what data gets displayed in the layout, and more. This is all done through editing text files; the static web site is the final product.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/structure/"},"url":"https://jekyllrb.com/docs/structure/"}</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>
 
   
@@ -520,6 +517,9 @@ product.</p>
   
 
   
+  
+
+  
   
 
   
@@ -565,6 +565,10 @@ product.</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/templates/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>Templates - Jekyll • Simple, blog-aware, static sites</title>
+  <!-- Begin Jekyll SEO tag v2.2.3 -->
+<title>Templates | Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Templates">
+<meta property="og:locale" content="en_US">
 <meta name="description" content="Jekyll uses the Liquid templating language to process templates. All of the standard Liquid tags and filters are supported. Jekyll even adds a few handy filters and tags of its own to make common tasks easier.">
 <meta property="og:description" content="Jekyll uses the Liquid templating language to process templates. All of the standard Liquid tags and filters are supported. Jekyll even adds a few handy filters and tags of its own to make common tasks easier.">
 <link rel="canonical" href="https://jekyllrb.com/docs/templates/">
 <meta property="og:url" content="https://jekyllrb.com/docs/templates/">
 <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": "Templates",
-"datePublished": "2017-03-22T08:08:47-07:00",
-"description": "Jekyll uses the Liquid templating language to process templates. All of the standard Liquid tags and filters are supported. Jekyll even adds a few handy filters and tags of its own to make common tasks easier.",
-"publisher": {"@type": "Organization",
-"logo": {"@type": "ImageObject",
-"url": "https://jekyllrb.com/img/logo-2x.png"}},
-"url": "https://jekyllrb.com/docs/templates/"}</script>
+{"@context":"http://schema.org","@type":"BlogPosting","headline":"Templates","datePublished":"2017-07-17T13:16:40-07:00","dateModified":"2017-07-17T13:16:40-07:00","description":"Jekyll uses the Liquid templating language to process templates. All of the standard Liquid tags and filters are supported. Jekyll even adds a few handy filters and tags of its own to make common tasks easier.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/templates/"},"url":"https://jekyllrb.com/docs/templates/"}</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>
 
   
@@ -291,8 +288,8 @@
           </div>
           <h1>Templates</h1>
           <p>Jekyll uses the <a href="https://shopify.github.io/liquid/">Liquid</a> templating language to
-process templates. All of the standard Liquid <a href="https://shopify.github.io/liquid/tags/">tags</a> and
-<a href="https://shopify.github.io/liquid/filters/">filters</a> are
+process templates. All of the standard Liquid <a href="https://shopify.github.io/liquid/tags/control-flow/">tags</a> and
+<a href="https://shopify.github.io/liquid/filters/abs/">filters</a> are
 supported. Jekyll even adds a few handy filters and tags of its own to make
 common tasks easier.</p>
 
@@ -467,15 +464,15 @@ common tasks easier.</p>
         <p class="name"><strong>CGI Escape</strong></p>
         <p>
           CGI escape a string for use in a URL. Replaces any special characters
-          with appropriate %XX replacements.
+          with appropriate <code>%XX</code> replacements. CGI escape normally replaces a space with a plus <code>+</code> sign.
         </p>
       </td>
       <td class="align-center">
         <p>
-         <code class="filter">{{ "foo,bar;baz?" | cgi_escape }}</code>
+         <code class="filter">{{ "foo, bar; baz?" | cgi_escape }}</code>
         </p>
         <p>
-          <code class="output">foo%2Cbar%3Bbaz%3F</code>
+          <code class="output">foo%2C+bar%3B+baz%3F</code>
         </p>
       </td>
     </tr>
@@ -483,15 +480,15 @@ common tasks easier.</p>
       <td>
         <p class="name"><strong>URI Escape</strong></p>
         <p>
-          URI escape a string.
+          Percent encodes any special characters in a URI. URI escape normally replaces a space with <code>%20</code>. <a href="https://en.wikipedia.org/wiki/Percent-encoding#Types_of_URI_characters">Reserved characters</a> will not be escaped.
         </p>
       </td>
       <td class="align-center">
         <p>
-         <code class="filter">{{ "foo, bar \baz?" | uri_escape }}</code>
+         <code class="filter">{{ "http://foo.com/?q=foo, \bar?" | uri_escape }}</code>
         </p>
         <p>
-          <code class="output">foo,%20bar%20%5Cbaz?</code>
+          <code class="output">http://foo.com/?q=foo,%20%5Cbar?</code>
         </p>
       </td>
     </tr>
@@ -845,7 +842,7 @@ with public or secret gists:</p>
 
 <p>The path to the post, page, or collection is defined as the path relative to the root directory (where your config file is) to the file, not the path from your existing page to the other page.</p>
 
-<p>For example, suppose you’re creating a link <code class="highlighter-rouge">page_a.md</code> (stored in <code class="highlighter-rouge">pages/folder1/folder2</code>) to <code class="highlighter-rouge">page_b.md</code> (stored in  <code class="highlighter-rouge">pages/folder1</code>). Your path in the link would not be <code class="highlighter-rouge">../page_b.html</code>. Instead, it would be <code class="highlighter-rouge">/pages/folder1/page_b.md</code>.</p>
+<p>For example, suppose you’re creating a link in <code class="highlighter-rouge">page_a.md</code> (stored in <code class="highlighter-rouge">pages/folder1/folder2</code>) to <code class="highlighter-rouge">page_b.md</code> (stored in  <code class="highlighter-rouge">pages/folder1</code>). Your path in the link would not be <code class="highlighter-rouge">../page_b.html</code>. Instead, it would be <code class="highlighter-rouge">/pages/folder1/page_b.md</code>.</p>
 
 <p>If you’re unsure of the path, add <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">page.path</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></code> to the page and it will display the path.</p>
 
@@ -855,7 +852,7 @@ with public or secret gists:</p>
 
 <h3 id="linking-to-posts">Linking to posts</h3>
 
-<p>If you want like to include a link to a post on your site, the <code class="highlighter-rouge">post_url</code> tag will generate the correct permalink URL for the post you specify.</p>
+<p>If you want to include a link to a post on your site, the <code class="highlighter-rouge">post_url</code> tag will generate the correct permalink URL for the post you specify.</p>
 
 <div class="language-liquid highlighter-rouge">
 <pre class="highlight"><code>
@@ -936,6 +933,9 @@ with public or secret gists:</p>
   
 
   
+  
+
+  
   
 
   
@@ -981,6 +981,10 @@ with public or secret gists:</p>
 
   
   
+  <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
+
+  
+  
   <li class=""><a href="/docs/usage/">Basic Usage</a></li>