jekyll-docs 3.3.1 → 3.4.0

data/site/docs/maintaining/reviewing-a-pull-request/index.html

@@ -4,7 +4,7 @@
 <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.3.1">
+  <meta name="generator" content="Jekyll v3.4.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">
@@ -19,7 +19,7 @@
 <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/reviewing-a-pull-request/">
 <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-01-20T13:17:57-08:00">
+<meta property="article:published_time" content="2017-03-22T08:06:48-07:00">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:site" content="@jekyllrb">
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
@@ -27,7 +27,7 @@
 {"@context": "http://schema.org",
 "@type": "BlogPosting",
 "headline": "Reviewing a Pull Request",
-"datePublished": "2017-01-20T13:17:57-08:00",
+"datePublished": "2017-03-22T08:06:48-07:00",
 "description": "This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.",
 "publisher": {"@type": "Organization",
 "logo": {"@type": "ImageObject",
@@ -192,6 +192,10 @@
 
   
   
+  <option value="/docs/includes/">Includes</option>
+
+  
+  
   <option value="/docs/permalinks/">Permalinks</option>
 
   
@@ -432,6 +436,9 @@
 
   
   
+
+  
+  
 
   
   
@@ -527,6 +534,10 @@
 
   
   
+  <li class=""><a href="/docs/includes/">Includes</a></li>
+
+  
+  
   <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
 
   
@@ -675,7 +686,7 @@
 </script>
 
   
-  <!-- Gauges (http://gaug.es/) -->
+  <!-- Gauges (http://get.gaug.es/) -->
   <script>
     var _gauges = _gauges || [];
     (function() {
@@ -692,7 +703,7 @@
 
 
 
-  <!-- Google Analytics (http://google.com/analytics) -->
+  <!-- Google Analytics (https://www.google.com/analytics) -->
   <script>
     !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
     (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),

data/site/docs/maintaining/special-labels/index.html

@@ -4,7 +4,7 @@
 <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.3.1">
+  <meta name="generator" content="Jekyll v3.4.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">
@@ -19,7 +19,7 @@
 <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/special-labels/">
 <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-01-20T13:17:57-08:00">
+<meta property="article:published_time" content="2017-03-22T08:06:48-07:00">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:site" content="@jekyllrb">
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
@@ -27,7 +27,7 @@
 {"@context": "http://schema.org",
 "@type": "BlogPosting",
 "headline": "Special Labels",
-"datePublished": "2017-01-20T13:17:57-08:00",
+"datePublished": "2017-03-22T08:06:48-07:00",
 "description": "This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.",
 "publisher": {"@type": "Organization",
 "logo": {"@type": "ImageObject",
@@ -192,6 +192,10 @@
 
   
   
+  <option value="/docs/includes/">Includes</option>
+
+  
+  
   <option value="/docs/permalinks/">Permalinks</option>
 
   
@@ -408,6 +412,9 @@
 
   
   
+
+  
+  
 
   
   
@@ -503,6 +510,10 @@
 
   
   
+  <li class=""><a href="/docs/includes/">Includes</a></li>
+
+  
+  
   <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
 
   
@@ -651,7 +662,7 @@
 </script>
 
   
-  <!-- Gauges (http://gaug.es/) -->
+  <!-- Gauges (http://get.gaug.es/) -->
   <script>
     var _gauges = _gauges || [];
     (function() {
@@ -668,7 +679,7 @@
 
 
 
-  <!-- Google Analytics (http://google.com/analytics) -->
+  <!-- Google Analytics (https://www.google.com/analytics) -->
   <script>
     !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
     (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),

data/site/docs/maintaining/triaging-an-issue/index.html

@@ -4,7 +4,7 @@
 <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.3.1">
+  <meta name="generator" content="Jekyll v3.4.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">
@@ -19,7 +19,7 @@
 <meta property="og:url" content="https://jekyllrb.com/docs/maintaining/triaging-an-issue/">
 <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-01-20T13:17:57-08:00">
+<meta property="article:published_time" content="2017-03-22T08:06:48-07:00">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:site" content="@jekyllrb">
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
@@ -27,7 +27,7 @@
 {"@context": "http://schema.org",
 "@type": "BlogPosting",
 "headline": "Triaging an Issue",
-"datePublished": "2017-01-20T13:17:57-08:00",
+"datePublished": "2017-03-22T08:06:48-07:00",
 "description": "This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.",
 "publisher": {"@type": "Organization",
 "logo": {"@type": "ImageObject",
@@ -192,6 +192,10 @@
 
   
   
+  <option value="/docs/includes/">Includes</option>
+
+  
+  
   <option value="/docs/permalinks/">Permalinks</option>
 
   
@@ -442,6 +446,9 @@ Jekyll outside of its current capabilities.
 
   
   
+
+  
+  
 
   
   
@@ -537,6 +544,10 @@ Jekyll outside of its current capabilities.
 
   
   
+  <li class=""><a href="/docs/includes/">Includes</a></li>
+
+  
+  
   <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
 
   
@@ -685,7 +696,7 @@ Jekyll outside of its current capabilities.
 </script>
 
   
-  <!-- Gauges (http://gaug.es/) -->
+  <!-- Gauges (http://get.gaug.es/) -->
   <script>
     var _gauges = _gauges || [];
     (function() {
@@ -702,7 +713,7 @@ Jekyll outside of its current capabilities.
 
 
 
-  <!-- Google Analytics (http://google.com/analytics) -->
+  <!-- Google Analytics (https://www.google.com/analytics) -->
   <script>
     !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
     (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),

data/site/docs/migrations/index.html

@@ -4,7 +4,7 @@
 <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.3.1">
+  <meta name="generator" content="Jekyll v3.4.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">
@@ -19,7 +19,7 @@
 <meta property="og:url" content="https://jekyllrb.com/docs/migrations/">
 <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-01-20T13:17:57-08:00">
+<meta property="article:published_time" content="2017-03-22T08:06:48-07:00">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:site" content="@jekyllrb">
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
@@ -27,7 +27,7 @@
 {"@context": "http://schema.org",
 "@type": "BlogPosting",
 "headline": "Blog migrations",
-"datePublished": "2017-01-20T13:17:57-08:00",
+"datePublished": "2017-03-22T08:06:48-07:00",
 "description": "If you’re switching to Jekyll from another blogging system, Jekyll’s importers can help you with the move. To learn more about importing your site to Jekyll, visit our jekyll-import docs site.",
 "publisher": {"@type": "Organization",
 "logo": {"@type": "ImageObject",
@@ -192,6 +192,10 @@
 
   
   
+  <option value="/docs/includes/">Includes</option>
+
+  
+  
   <option value="/docs/permalinks/">Permalinks</option>
 
   
@@ -452,6 +456,10 @@ visit our <a href="https://import.jekyllrb.com/docs/home/"><code class="highligh
 
   
   
+  <li class=""><a href="/docs/includes/">Includes</a></li>
+
+  
+  
   <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
 
   
@@ -600,7 +608,7 @@ visit our <a href="https://import.jekyllrb.com/docs/home/"><code class="highligh
 </script>
 
   
-  <!-- Gauges (http://gaug.es/) -->
+  <!-- Gauges (http://get.gaug.es/) -->
   <script>
     var _gauges = _gauges || [];
     (function() {
@@ -617,7 +625,7 @@ visit our <a href="https://import.jekyllrb.com/docs/home/"><code class="highligh
 
 
 
-  <!-- Google Analytics (http://google.com/analytics) -->
+  <!-- Google Analytics (https://www.google.com/analytics) -->
   <script>
     !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
     (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),

data/site/docs/pages/index.html

@@ -4,7 +4,7 @@
 <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.3.1">
+  <meta name="generator" content="Jekyll v3.4.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">
@@ -13,13 +13,13 @@
   <!-- Begin Jekyll SEO tag v2.1.0 -->
 <title>Creating pages - Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Creating pages">
-<meta name="description" content="In addition to writing posts, another thing you may want to do with your Jekyll site is create static pages. By taking advantage of the way Jekyll copies files and directories, this is easy to do.">
-<meta property="og:description" content="In addition to writing posts, another thing you may want to do with your Jekyll site is create static pages. By taking advantage of the way Jekyll copies files and directories, this is easy to do.">
+<meta name="description" content="In addition to writing posts, you might also want to add static pages (content that isn’t date-based) to your Jekyll site. By taking advantage of the way Jekyll copies files and directories, this is easy to do.">
+<meta property="og:description" content="In addition to writing posts, you might also want to add static pages (content that isn’t date-based) to your Jekyll site. By taking advantage of the way Jekyll copies files and directories, this is easy to do.">
 <link rel="canonical" href="https://jekyllrb.com/docs/pages/">
 <meta property="og:url" content="https://jekyllrb.com/docs/pages/">
 <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-01-20T13:17:57-08:00">
+<meta property="article:published_time" content="2017-03-22T08:06:48-07:00">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:site" content="@jekyllrb">
 <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
@@ -27,8 +27,8 @@
 {"@context": "http://schema.org",
 "@type": "BlogPosting",
 "headline": "Creating pages",
-"datePublished": "2017-01-20T13:17:57-08:00",
-"description": "In addition to writing posts, another thing you may want to do with your Jekyll site is create static pages. By taking advantage of the way Jekyll copies files and directories, this is easy to do.",
+"datePublished": "2017-03-22T08:06:48-07:00",
+"description": "In addition to writing posts, you might also want to add static pages (content that isn’t date-based) to your Jekyll site. By taking advantage of the way Jekyll copies files and directories, this is easy to do.",
 "publisher": {"@type": "Organization",
 "logo": {"@type": "ImageObject",
 "url": "https://jekyllrb.com/img/logo-2x.png"}},
@@ -192,6 +192,10 @@
 
   
   
+  <option value="/docs/includes/">Includes</option>
+
+  
+  
   <option value="/docs/permalinks/">Permalinks</option>
 
   
@@ -286,9 +290,7 @@
             <a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/pages.md"><i class="fa fa-pencil"></i>  Improve this page</a>
           </div>
           <h1>Creating pages</h1>
-          <p>In addition to <a href="../posts/">writing posts</a>, another thing you may want to do
-with your Jekyll site is create static pages. By taking advantage of the way
-Jekyll copies files and directories, this is easy to do.</p>
+          <p>In addition to <a href="../posts/">writing posts</a>, you might also want to add static pages (content that isn’t date-based) to your Jekyll site. By taking advantage of the way Jekyll copies files and directories, this is easy to do.</p>
 
 <h2 id="homepage">Homepage</h2>
 
@@ -310,18 +312,16 @@ homepage of your Jekyll-generated site.</p>
 <h2 id="where-additional-pages-live">Where additional pages live</h2>
 
 <p>Where you put HTML or <a href="https://daringfireball.net/projects/markdown/">Markdown</a>
-files for pages depends on how you want the pages to work.
-There are two main ways of creating pages:</p>
+files for pages depends on how you want the pages to work. There are two main ways of creating pages:</p>
 
 <ul>
   <li>Place named HTML or <a href="https://daringfireball.net/projects/markdown/">Markdown</a>
 files for each page in your site’s root folder.</li>
-  <li>Create a folder in the site’s root for each page, and place an index.html
-or index.md file in each page folder.</li>
+  <li>Place pages inside folders and subfolders named whatever you want.</li>
 </ul>
 
 <p>Both methods work fine (and can be used in conjunction with each other),
-with the only real difference being the resulting URLs.</p>
+with the only real difference being the resulting URLs. By default, pages retain the same folder structure in <code class="highlighter-rouge">_site</code> as they do in the source directory.</p>
 
 <h3 id="named-html-files">Named HTML files</h3>
 
@@ -344,46 +344,25 @@ and associated URLs might look like:</p>
 </code></pre>
 </div>
 
-<h3 id="named-folders-containing-index-html-files">Named folders containing index HTML files</h3>
+<p>If you have a lot of pages, you can organize those pages into subfolders. The same subfolders that are used to group your pages in our project’s source will exist in the <code class="highlighter-rouge">_site</code> folder when your site builds.</p>
 
-<p>There is nothing wrong with the above method. However, some people like to keep
-their URLs free from things like filename extensions. To achieve clean URLs for
-pages using Jekyll, you simply need to create a folder for each top-level page
-you want, and then place an <code class="highlighter-rouge">index.html</code> file in each page’s folder. This way
-the page URL ends up being the folder name, and the web server will serve up
-the respective <code class="highlighter-rouge">index.html</code> file. Here’s an example of what this structure
-might look like:</p>
+<h2 id="flattening-pages-from-subfolders-into-the-root-directory">Flattening pages from subfolders into the root directory</h2>
 
-<div class="language-sh highlighter-rouge">
-<pre class="highlight"><code>.
-├── _config.yml
-├── _includes/
-├── _layouts/
-├── _posts/
-├── _site/
-├── about/
-|   └── index.html  <span class="c"># =&gt; http://example.com/about/</span>
-├── contact/
-|   └── index.html  <span class="c"># =&gt; http://example.com/contact/</span>
-|── other/
-|   └── index.md    <span class="c"># =&gt; http://example.com/other/</span>
-└── index.html      <span class="c"># =&gt; http://example.com/</span>
+<p>If you have pages organized into subfolders in your source folder and want to flatten them in the root folder on build, you must add the <a href="/docs/permalinks/">permalink</a> property directly in your page’s front matter like this:</p>
+
+<div class="highlighter-rouge">
+<pre class="highlight"><code>---
+title: My page
+permalink: mypageurl.html
+---
 </code></pre>
 </div>
 
-<p>This approach may not suit everyone, but for people who like clean URLs it’s
-simple and it works. In the end, the decision is yours!</p>
+<h3 id="named-folders-containing-index-html-files">Named folders containing index HTML files</h3>
+
+<p>If you don’t want file extensions (<code class="highlighter-rouge">.html</code>) to appear in your page URLs (file extensions are the default), you can choose a <a href="../permalinks/#builtinpermalinkstyles">permalink style</a> that has a trailing slash instead of a file extension.</p>
 
-<div class="note">
-  <h5>ProTip™: Use permalink Front Matter Variable</h5>
-  <p>
-    Clean URLs can also be achieved using the <code>permalink</code> front
-    matter variable. In the example above, using the first method, you can
-    get URL <code>http://example.com/other</code> for the file
-    <code>other.md</code> by setting this at the top of the file:
-    <code>permalink: /other</code>
-  </p>
-</div>
+<p>Note if you want to view your site offline <em>without the Jekyll preview server</em>, your browser will need the file extension to display the page, and all assets will need to be relative links that function without the server baseurl.</p>
 
           
 
@@ -529,6 +508,10 @@ simple and it works. In the end, the decision is yours!</p>
 
   
   
+  <li class=""><a href="/docs/includes/">Includes</a></li>
+
+  
+  
   <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
 
   
@@ -677,7 +660,7 @@ simple and it works. In the end, the decision is yours!</p>
 </script>
 
   
-  <!-- Gauges (http://gaug.es/) -->
+  <!-- Gauges (http://get.gaug.es/) -->
   <script>
     var _gauges = _gauges || [];
     (function() {
@@ -694,7 +677,7 @@ simple and it works. In the end, the decision is yours!</p>
 
 
 
-  <!-- Google Analytics (http://google.com/analytics) -->
+  <!-- Google Analytics (https://www.google.com/analytics) -->
   <script>
     !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
     (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),