jekyll-docs 3.3.1 → 3.4.0

data/site/docs/plugins/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/plugins/">
 <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": "Plugins",
-"datePublished": "2017-01-20T13:17:57-08:00",
+"datePublished": "2017-03-22T08:06:48-07:00",
 "description": "Jekyll has a plugin system with hooks that allow you to create custom generated content specific to your site. You can run custom code for your site without having to modify the Jekyll source itself.",
 "publisher": {"@type": "Organization",
 "logo": {"@type": "ImageObject",
@@ -192,6 +192,10 @@
 
   
   
+  <option value="/docs/includes/">Includes</option>
+
+  
+  
   <option value="/docs/permalinks/">Permalinks</option>
 
   
@@ -1086,6 +1090,8 @@ LESS.js files during generation.</li>
 <a href="https://github.com/juusaw/amp-jekyll">AMP-Jekyll by Juuso Mikkonen</a>: Generate <a href="https://www.ampproject.org">Accelerated Mobile Pages</a> of Jekyll posts.</li>
   <li>
 <a href="https://github.com/alexivkin/Jekyll-Art-Gallery-Plugin">Jekyll Art Gallery plugin</a>: An advanced art/photo gallery generation plugin for creating galleries from a set of image folders. Supports image tagging, thumbnails, sorting, image rotation, post-processing (remove EXIF, add watermark), multiple collections and much more.</li>
+  <li>
+<a href="https://github.com/developmentseed/jekyll-ga">jekyll-ga</a>: A Jekyll plugin that downloads Google Analytics data and adds it to posts. Useful for making a site that lists “most popular” content. <a href="https://developmentseed.org/blog/google-analytics-jekyll-plugin/">Read the introduction</a> post on the developmentSEED blog.</li>
 </ul>
 
 <h4 id="converters-1">Converters</h4>
@@ -1120,8 +1126,6 @@ LESS.js files during generation.</li>
   <li>
 <a href="https://github.com/xdissent/jekyll-rst">ReStructuredText Converter</a>: Converts ReST documents to HTML with Pygments syntax highlighting.</li>
   <li>
-<a href="https://github.com/dsanson/jekyll-pandoc-plugin">Jekyll-pandoc-plugin</a>: Use pandoc for rendering markdown.</li>
-  <li>
 <a href="https://github.com/fauno/jekyll-pandoc-multiple-formats">Jekyll-pandoc-multiple-formats</a> by <a href="https://github.com/edsl">edsl</a>: Use pandoc to generate your site in multiple formats. Supports pandoc’s markdown extensions.</li>
   <li>
 <a href="https://gist.github.com/1472645">Transform Layouts</a>: Allows HAML layouts (you need a HAML Converter plugin for this to work).</li>
@@ -1143,7 +1147,7 @@ LESS.js files during generation.</li>
 
 <ul>
   <li>
-<a href="https://github.com/MattHall/truncatehtml">Truncate HTML</a> by <a href="http://codebeef.com">Matt Hall</a>: A Jekyll filter that truncates HTML while preserving markup structure.</li>
+<a href="https://github.com/MattHall/truncatehtml">Truncate HTML</a> by <a href="https://codebeef.com/">Matt Hall</a>: A Jekyll filter that truncates HTML while preserving markup structure.</li>
   <li>
 <a href="https://github.com/LawrenceWoodman/domain_name-liquid_filter">Domain Name Filter by Lawrence Woodman</a>: Filters the input text so that just the domain name is left.</li>
   <li>
@@ -1186,6 +1190,12 @@ LESS.js files during generation.</li>
 <a href="https://github.com/vwochnik/jekyll-email-protect">Jekyll Email Protect</a>: Email protection liquid filter for Jekyll</li>
   <li>
 <a href="https://github.com/mattg/jekyll-uglify-filter">Jekyll Uglify Filter</a>: A Liquid filter that runs your JavaScript through UglifyJS.</li>
+  <li>
+<a href="https://github.com/sparanoid/match_regex">match_regex</a>: A Liquid filter to perform regex match.</li>
+  <li>
+<a href="https://github.com/sparanoid/replace_regex">replace_regex</a>: A Liquid filter to perform regex replace.</li>
+  <li>
+<a href="https://rubygems.org/gems/jekyll-money">Jekyll Money</a>: A Jekyll plugin for dealing with money. Because we all have to at some point.</li>
 </ul>
 
 <h4 id="tags-1">Tags</h4>
@@ -1244,7 +1254,7 @@ LESS.js files during generation.</li>
   <li>
 <a href="https://gist.github.com/Yexiaoxing/5891929">Youku and Tudou Embed</a>: Liquid plugin for embedding Youku and Tudou videos.</li>
   <li>
-<a href="https://github.com/sectore/jekyll-swfobject">Jekyll-swfobject</a>: Liquid plugin for embedding Adobe Flash files (.swf) using <a href="http://code.google.com/p/swfobject/">SWFObject</a>.</li>
+<a href="https://github.com/sectore/jekyll-swfobject">Jekyll-swfobject</a>: Liquid plugin for embedding Adobe Flash files (.swf) using <a href="https://github.com/swfobject/swfobject">SWFObject</a>.</li>
   <li>
 <a href="https://github.com/robwierzbowski/jekyll-picture-tag">Jekyll Picture Tag</a>: Easy responsive images for Jekyll. Based on the proposed <a href="https://html.spec.whatwg.org/multipage/embedded-content.html#the-picture-element"><code class="highlighter-rouge">&lt;picture&gt;</code></a> element, polyfilled with Scott Jehl’s <a href="https://github.com/scottjehl/picturefill">Picturefill</a>.</li>
   <li>
@@ -1264,7 +1274,7 @@ LESS.js files during generation.</li>
   <li>
 <a href="https://gist.github.com/23maverick23/8532525">jekyll-font-awesome</a>: Quickly and easily add Font Awesome icons to your posts.</li>
   <li>
-<a href="https://gist.github.com/tobru/9171700">Lychee Gallery Tag</a> by <a href="https://github.com/tobru">tobru</a>: Include <a href="http://lychee.electerious.com/">Lychee</a> albums into a post. For an introduction, see <a href="https://tobrunet.ch/articles/jekyll-meets-lychee-a-liquid-tag-plugin/">Jekyll meets Lychee - A Liquid Tag plugin</a>
+<a href="https://gist.github.com/tobru/9171700">Lychee Gallery Tag</a> by <a href="https://github.com/tobru">tobru</a>: Include <a href="https://lychee.electerious.com/">Lychee</a> albums into a post. For an introduction, see <a href="https://tobrunet.ch/articles/jekyll-meets-lychee-a-liquid-tag-plugin/">Jekyll meets Lychee - A Liquid Tag plugin</a>
 </li>
   <li>
 <a href="https://github.com/callmeed/jekyll-image-set">Image Set/Gallery Tag</a> by <a href="https://github.com/callmeed">callmeed</a>: Renders HTML for an image gallery from a folder in your Jekyll site. Just pass it a folder name and class/tag options.</li>
@@ -1275,11 +1285,11 @@ LESS.js files during generation.</li>
   <li>
 <a href="https://github.com/rob-murray/jekyll-version-plugin">Jekyll Project Version Tag</a>: A Liquid tag plugin that renders a version identifier for your Jekyll site sourced from the git repository containing your code.</li>
   <li>
-<a href="https://github.com/AlessandroLorenzi/piwigo_gallery">Piwigo Gallery</a> by <a href="http://www.alorenzi.eu/">Alessandro Lorenzi</a>: Jekyll plugin to generate thumbnails from a Piwigo gallery and display them with a Liquid tag</li>
+<a href="https://github.com/AlessandroLorenzi/piwigo_gallery">Piwigo Gallery</a> by <a href="http://blog.alorenzi.eu/">Alessandro Lorenzi</a>: Jekyll plugin to generate thumbnails from a Piwigo gallery and display them with a Liquid tag</li>
   <li>
 <a href="https://github.com/tmthrgd/jekyll-plugins">mathml.rb</a> by Tom Thorogood: A plugin to convert TeX mathematics into MathML for display.</li>
   <li>
-<a href="https://github.com/aarongustafson/jekyll-webmention_io">webmention_io.rb</a> by <a href="http://aaron-gustafson.com/">Aaron Gustafson</a>: A plugin to enable <a href="http://indiewebcamp.com/webmention">webmention</a> integration using <a href="http://webmention.io">Webmention.io</a>. Includes an optional JavaScript for updating webmentions automatically between publishes and, if available, in realtime using WebSockets.</li>
+<a href="https://github.com/aarongustafson/jekyll-webmention_io">webmention_io.rb</a> by <a href="http://aaron-gustafson.com/">Aaron Gustafson</a>: A plugin to enable <a href="https://indieweb.org/webmention">webmention</a> integration using <a href="https://webmention.io/">Webmention.io</a>. Includes an optional JavaScript for updating webmentions automatically between publishes and, if available, in realtime using WebSockets.</li>
   <li>
 <a href="https://github.com/lkorth/jekyll-500px-embed">Jekyll 500px Embed</a> by Luke Korth. A Liquid tag plugin that embeds <a href="https://500px.com/">500px</a> photos.</li>
   <li>
@@ -1322,7 +1332,7 @@ LESS.js files during generation.</li>
   <li>
 <a href="https://github.com/recurser/jekyll-plugins">Jekyll Plugins by Recursive Design</a>: Plugins to generate Project pages from GitHub readmes, a Category page, and a Sitemap generator.</li>
   <li>
-<a href="https://github.com/flatterline/jekyll-plugins">Company website and blog plugins</a> by Flatterline, a <a href="http://flatterline.com/">Ruby on Rails development company</a>: Portfolio/project page generator, team/individual page generator, an author bio liquid tag for use on posts, and a few other smaller plugins.</li>
+<a href="https://github.com/flatterline/jekyll-plugins">Company website and blog plugins</a> by Flatterline, a Ruby on Rails development company: Portfolio/project page generator, team/individual page generator, an author bio liquid tag for use on posts, and a few other smaller plugins.</li>
   <li>
 <a href="https://github.com/aucor/jekyll-plugins">Jekyll plugins by Aucor</a>: Plugins for trimming unwanted newlines/whitespace and sorting pages by weight attribute.</li>
 </ul>
@@ -1359,7 +1369,7 @@ LESS.js files during generation.</li>
   <li>
 <a href="https://github.com/moshen/jekyll-asset_bundler">Jekyll-asset_bundler</a>: Bundles and minifies JavaScript and CSS.</li>
   <li>
-<a href="http://ixti.net/jekyll-assets/">Jekyll-assets</a> by <a href="https://github.com/ixti">ixti</a>: Rails-alike assets pipeline (write assets in CoffeeScript, Sass, LESS etc; specify dependencies for automatic bundling using simple declarative comments in assets; minify and compress; use JST templates; cache bust; and many-many more).</li>
+<a href="http://jekyll.github.io/jekyll-assets/">Jekyll-assets</a> by <a href="https://github.com/ixti">ixti</a>: Rails-alike assets pipeline (write assets in CoffeeScript, Sass, LESS etc; specify dependencies for automatic bundling using simple declarative comments in assets; minify and compress; use JST templates; cache bust; and many-many more).</li>
   <li>
 <a href="https://github.com/kitsched/japr">JAPR</a>: Jekyll Asset Pipeline Reborn - Powerful asset pipeline for Jekyll that collects, converts and compresses JavaScript and CSS assets.</li>
   <li>
@@ -1408,6 +1418,14 @@ LESS.js files during generation.</li>
 <a href="https://github.com/ashmaroli/jekyll-data">jekyll-data</a>: Read data files within Jekyll Theme Gems.</li>
   <li>
 <a href="https://github.com/snaptortoise/jekyll-pinboard-plugin">jekyll-pinboard</a>: Access your Pinboard bookmarks within your Jekyll theme.</li>
+  <li>
+<a href="https://github.com/mpchadwick/jekyll-migrate-permalink">jekyll-migrate-permalink</a>: Adds a <code class="highlighter-rouge">migrate-permalink</code> sub-command to help deal with side effects of changing your permalink.</li>
+  <li>
+<a href="https://github.com/robcrocombe/jekyll-post">Jekyll-Post</a>: A CLI tool to easily draft, edit, and publish Jekyll posts.</li>
+  <li>
+<a href="https://github.com/muratayusuke/jekyll-numbered-headings">jekyll-numbered-headings</a>: Adds ordered number to headings.</li>
+  <li>
+<a href="https://github.com/mpchadwick/jekyll-pre-commit">jekyll-pre-commit</a>: A framework for running checks against your posts using a git pre-commit hook before you publish them.</li>
 </ul>
 
 <h4 id="editors">Editors</h4>
@@ -1494,6 +1512,9 @@ new posts and run <code class="highlighter-rouge">jekyll build</code> all withou
   
 
   
+  
+
+  
   
 
   
@@ -1607,6 +1628,10 @@ new posts and run <code class="highlighter-rouge">jekyll build</code> all withou
 
   
   
+  <li class=""><a href="/docs/includes/">Includes</a></li>
+
+  
+  
   <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
 
   
@@ -1755,7 +1780,7 @@ new posts and run <code class="highlighter-rouge">jekyll build</code> all withou
 </script>
 
   
-  <!-- Gauges (http://gaug.es/) -->
+  <!-- Gauges (http://get.gaug.es/) -->
   <script>
     var _gauges = _gauges || [];
     (function() {
@@ -1772,7 +1797,7 @@ new posts and run <code class="highlighter-rouge">jekyll build</code> all withou
 
 
 
-  <!-- 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/posts/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/posts/">
 <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": "Writing posts",
-"datePublished": "2017-01-20T13:17:57-08:00",
+"datePublished": "2017-03-22T08:06:48-07:00",
 "description": "One of Jekyll’s best aspects is that it is “blog aware”. What does this mean, exactly? Well, simply put, it means that blogging is baked into Jekyll’s functionality. If you write articles and publish them online, you can publish and maintain a blog simply by managing a folder of text-files on your computer. Compared to the hassle of configuring and maintaining databases and web-based CMS systems, this will be a welcome change!",
 "publisher": {"@type": "Organization",
 "logo": {"@type": "ImageObject",
@@ -192,6 +192,10 @@
 
   
   
+  <option value="/docs/includes/">Includes</option>
+
+  
+  
   <option value="/docs/permalinks/">Permalinks</option>
 
   
@@ -397,6 +401,25 @@ variable in a post.</p>
   </p>
 </div>
 
+<h2 id="a-typical-post">A typical post</h2>
+
+<p>Jekyll can handle many different iterations of the idea you might associate with a “post,” however a standard blog style post, including an Title, Layout, Publishing Date, and Categories might look like this:</p>
+
+<div class="highlighter-rouge">
+<pre class="highlight"><code>---
+layout: post
+title:  "Welcome to Jekyll!"
+date:   2015-11-17 16:16:01 -0600
+categories: jekyll update
+---
+You’ll find this post in your `_posts` directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run `bundle exec jekyll serve`, which launches a web server and auto-regenerates your site when a file is updated.
+
+To add new posts, simply add a file in the `_posts` directory that follows the convention `YYYY-MM-DD-name-of-post.ext` and includes the necessary front matter. Take a look at the source for this post to get an idea about how it works.
+
+</code></pre>
+</div>
+<p>Everything in between the first and second <code class="highlighter-rouge">---</code> are part of the YAML Front Matter, and everything after the second <code class="highlighter-rouge">---</code> will be rendered with Markdown and show up as “Content.”</p>
+
 <h2 id="displaying-an-index-of-posts">Displaying an index of posts</h2>
 
 <p>It’s all well and good to have posts in a folder, but a blog is no use unless
@@ -666,6 +689,10 @@ site.</p>
 
   
   
+  <li class=""><a href="/docs/includes/">Includes</a></li>
+
+  
+  
   <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
 
   
@@ -814,7 +841,7 @@ site.</p>
 </script>
 
   
-  <!-- Gauges (http://gaug.es/) -->
+  <!-- Gauges (http://get.gaug.es/) -->
   <script>
     var _gauges = _gauges || [];
     (function() {
@@ -831,7 +858,7 @@ site.</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),

data/site/docs/quickstart/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>Quick-start guide - Jekyll • Simple, blog-aware, static sites</title>
 <meta property="og:title" content="Quick-start guide">
-<meta name="description" content="For the impatient, here’s how to get a boilerplate Jekyll site up and running.">
-<meta property="og:description" content="For the impatient, here’s how to get a boilerplate Jekyll site up and running.">
+<meta name="description" content="If you already have a full Ruby development environment with all headers and RubyGems installed (see Jekyll’s requirements), you can create a new Jekyll site by doing the following:">
+<meta property="og:description" content="If you already have a full Ruby development environment with all headers and RubyGems installed (see Jekyll’s requirements), you can create a new Jekyll site by doing the following:">
 <link rel="canonical" href="https://jekyllrb.com/docs/quickstart/">
 <meta property="og:url" content="https://jekyllrb.com/docs/quickstart/">
 <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": "Quick-start guide",
-"datePublished": "2017-01-20T13:17:57-08:00",
-"description": "For the impatient, here’s how to get a boilerplate Jekyll site up and running.",
+"datePublished": "2017-03-22T08:06:48-07:00",
+"description": "If you already have a full Ruby development environment with all headers and RubyGems installed (see Jekyll’s requirements), you can create a new Jekyll site by doing the following:",
 "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,28 +290,59 @@
             <a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/quickstart.md"><i class="fa fa-pencil"></i>  Improve this page</a>
           </div>
           <h1>Quick-start guide</h1>
-          <p>For the impatient, here’s how to get a boilerplate Jekyll site up and running.</p>
+          <p>If you already have a full <a href="https://www.ruby-lang.org/en/downloads/">Ruby</a> development environment with all headers and <a href="https://rubygems.org/pages/download">RubyGems</a> installed (see Jekyll’s <a href="/docs/installation/#requirements/">requirements</a>), you can create a new Jekyll site by doing the following:</p>
 
 <div class="language-sh highlighter-rouge">
-<pre class="highlight"><code>~ <span class="nv">$ </span>gem install jekyll bundler
+<pre class="highlight"><code><span class="c"># Install Jekyll and Bundler gems through RubyGems</span>
+~ <span class="nv">$ </span>gem install jekyll bundler
+
+<span class="c"># Create a new Jekyll site at ./myblog</span>
 ~ <span class="nv">$ </span>jekyll new myblog
+
+<span class="c"># Change into your new directory</span>
 ~ <span class="nv">$ </span><span class="nb">cd </span>myblog
+
+<span class="c"># Build the site on the preview server</span>
 ~/myblog <span class="nv">$ </span>bundle <span class="nb">exec </span>jekyll serve
-<span class="c"># =&gt; Now browse to http://localhost:4000</span>
+
+<span class="c"># Now browse to http://localhost:4000</span>
 </code></pre>
 </div>
 
-<p>The <code class="highlighter-rouge">jekyll new</code> command now automatically initiates <code class="highlighter-rouge">bundle install</code> and installs the dependencies required. To skip this, pass <code class="highlighter-rouge">--skip-bundle</code> option like so <code class="highlighter-rouge">jekyll new myblog --skip-bundle</code>.</p>
+<p>If you encounter any unexpected errors during the above, please refer to the already-mentioned <a href="/docs/installation/#requirements/">requirements</a> page, as you might be missing development headers or other prerequisites.</p>
 
-<p>If you wish to install jekyll into an existing directory, you can do so by running <code class="highlighter-rouge">jekyll new .</code> from within the directory instead of creating a new one. If the existing directory isn’t empty, you’ll also have to pass the <code class="highlighter-rouge">--force</code> option like so <code class="highlighter-rouge">jekyll new . --force</code>.</p>
+<h2 id="about-bundler">About Bundler</h2>
 
-<p>That’s nothing, though. The real magic happens when you start creating blog
-posts, using the front matter to control templates and layouts, and taking
-advantage of all the awesome configuration options Jekyll makes available.</p>
+<p><code class="highlighter-rouge">gem install jekyll bundler</code> installs the <a href="https://rubygems.org/gems/jekyll/">jekyll</a> and <a href="https://rubygems.org/gems/bundler">bundler</a> gems through <a href="https://rubygems.org/">RubyGems</a>. You need only to install the gems one time — not every time you create a new Jekyll project. Here are some additional details:</p>
 
-<p>If you’re running into problems, ensure you have all the <a href="/docs/installation/">requirements
-installed</a>.</p>
+<ul>
+  <li>
+<code class="highlighter-rouge">bundler</code> is a gem that manages other Ruby gems. It makes sure your gems and gem versions are compatible, and that you have all necessary dependencies each gem requires.</li>
+  <li>
+    <p>The <code class="highlighter-rouge">Gemfile</code> and <code class="highlighter-rouge">Gemfile.lock</code> files inform Bundler about the gem requirements in your site. If your site doesn’t have these Gemfiles, you can omit <code class="highlighter-rouge">bundle exec</code> and just run <code class="highlighter-rouge">jekyll serve</code>.</p>
+  </li>
+  <li>When you run <code class="highlighter-rouge">bundle exec jekyll serve</code>, Bundler uses the gems and versions as specified in <code class="highlighter-rouge">Gemfile.lock</code> to ensure your Jekyll site builds with no compatibility or dependency conflicts.</li>
+</ul>
 
+<h2 id="options-for-creating-a-new-site-with-jekyll">Options for creating a new site with Jekyll</h2>
+
+<p><code class="highlighter-rouge">jekyll new &lt;PATH&gt;</code> installs a new Jekyll site at the path specified (relative to current directory). In this case, Jekyll will be installed in a directory called <code class="highlighter-rouge">myblog</code>. Here are some additional details:</p>
+
+<ul>
+  <li>To install the Jekyll site into the directory you’re currently in, run <code class="highlighter-rouge">jekyll new .</code> If the existing directory isn’t empty, you can pass the <code class="highlighter-rouge">--force</code> option with <code class="highlighter-rouge">jekyll new . --force</code>.</li>
+  <li>
+<code class="highlighter-rouge">jekyll new</code> automatically initiates <code class="highlighter-rouge">bundle install</code> to install the dependencies required. (If you don’t want Bundler to install the gems, use <code class="highlighter-rouge">jekyll new myblog --skip-bundle</code>.)</li>
+  <li>By default, the Jekyll site installed by <code class="highlighter-rouge">jekyll new</code> uses a gem-based theme called <a href="https://github.com/jekyll/minima">Minima</a>. With <a href="../themes">gem-based themes</a>, some of the directories and files are stored in the theme-gem, hidden from your immediate view.</li>
+  <li>We recommend setting up Jekyll with a gem-based theme but if you want to start with a blank slate, use <code class="highlighter-rouge">jekyll new myblog --blank</code>
+</li>
+  <li>To learn about other parameters you can include with <code class="highlighter-rouge">jekyll new</code>, type <code class="highlighter-rouge">jekyll new --help</code>.</li>
+</ul>
+
+<p class="note info">When in doubt, use the <code>help</code> command to remind you of all available options and usage, it also works with the <code>new</code>, <code>build</code> and <code>serve</code> subcommands, e.g. <code>jekyll help new</code> or <code>jekyll help build</code>.</p>
+
+<h2 id="next-steps">Next steps</h2>
+
+<p>Building a Jekyll site with the default theme is just the first step. The real magic happens when you start creating blog posts, using the front matter to control templates and layouts, and taking advantage of all the awesome configuration options Jekyll makes available.</p>
 
           
 
@@ -429,6 +464,10 @@ installed</a>.</p>
 
   
   
+  <li class=""><a href="/docs/includes/">Includes</a></li>
+
+  
+  
   <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
 
   
@@ -577,7 +616,7 @@ installed</a>.</p>
 </script>
 
   
-  <!-- Gauges (http://gaug.es/) -->
+  <!-- Gauges (http://get.gaug.es/) -->
   <script>
     var _gauges = _gauges || [];
     (function() {
@@ -594,7 +633,7 @@ installed</a>.</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),

data/site/docs/resources/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/resources/">
 <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": "Resources",
-"datePublished": "2017-01-20T13:17:57-08:00",
+"datePublished": "2017-03-22T08:06:48-07:00",
 "description": "Jekyll’s growing use is producing a wide variety of tutorials, frameworks, extensions, examples, and other resources that can be very helpful. Below is a collection of links to some of the most popular Jekyll resources.",
 "publisher": {"@type": "Organization",
 "logo": {"@type": "ImageObject",
@@ -192,6 +192,10 @@
 
   
   
+  <option value="/docs/includes/">Includes</option>
+
+  
+  
   <option value="/docs/permalinks/">Permalinks</option>
 
   
@@ -294,11 +298,11 @@
   <li>
 <a href="http://jekyll.tips">Jekyll Tips</a> is a set of resources created by <a href="https://cloudcannon.com">CloudCannon</a> to help folks get up and running with Jekyll. They cover all skill levels, and even include some great video tutorials.</li>
   <li>
-<a href="http://cheat.jekyll.tips">Jekyll Cheatsheet</a> is a single-page resource for Jekyll filters, variables, and the like.</li>
+<a href="http://jekyll.tips/jekyll-cheat-sheet/">Jekyll Cheatsheet</a> is a single-page resource for Jekyll filters, variables, and the like.</li>
   <li><a href="http://jmcglone.com/guides/github-pages/">“Creating and Hosting a Personal Site on GitHub”</a></li>
-  <li><a href="http://www.smashingmagazine.com/2014/08/01/build-blog-jekyll-github-pages/">‘Build A Blog With Jekyll And GitHub Pages’ on Smashing Magazine</a></li>
+  <li><a href="https://www.smashingmagazine.com/2014/08/01/build-blog-jekyll-github-pages/">‘Build A Blog With Jekyll And GitHub Pages’ on Smashing Magazine</a></li>
   <li>Publishing to GitHub Pages? <a href="/docs/github-pages/">Check out our documentation page for just that purpose</a>.</li>
-  <li><a href="http://metajack.im/2009/01/23/blogging-with-git-emacs-and-jekyll/">Blogging with Git, Emacs and Jekyll</a></li>
+  <li><a href="https://metajack.im/2009/01/23/blogging-with-git-emacs-and-jekyll/">Blogging with Git, Emacs and Jekyll</a></li>
   <li><a href="https://gist.github.com/jedschneider/2890453">Tips for working with GitHub Pages Integration</a></li>
 </ul>
 
@@ -307,9 +311,9 @@
 <ul>
   <li>Use a saas service as a backend for forms (contact forms, hiring forms, etc.)
     <ul>
-      <li><a href="http://formspree.io/">Formspree (also open source)</a></li>
+      <li><a href="https://formspree.io/">Formspree (also open source)</a></li>
       <li><a href="https://formkeep.com/guides/contact-form-jekyll?utm_source=github&amp;utm_medium=jekyll-docs&amp;utm_campaign=contact-form-jekyll">FormKeep</a></li>
-      <li><a href="http://getsimpleform.com/">Simple Form</a></li>
+      <li><a href="https://getsimpleform.com/">Simple Form</a></li>
       <li><a href="https://www.formingo.co/guides/jekyll?utm_source=github&amp;utm_medium=jekyll-docs&amp;utm_campaign=Jekyll%20Documentation">Formingo</a></li>
     </ul>
   </li>
@@ -434,6 +438,9 @@
   
 
   
+  
+
+  
   
 
   
@@ -547,6 +554,10 @@
 
   
   
+  <li class=""><a href="/docs/includes/">Includes</a></li>
+
+  
+  
   <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
 
   
@@ -695,7 +706,7 @@
 </script>
 
   
-  <!-- Gauges (http://gaug.es/) -->
+  <!-- Gauges (http://get.gaug.es/) -->
   <script>
     var _gauges = _gauges || [];
     (function() {
@@ -712,7 +723,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),