jekyll-docs 3.7.3 → 3.8.0

data/site/docs/plugins/index.html

@@ -4,16 +4,17 @@
 <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.7.3">
+  <meta name="generator" content="Jekyll v3.8.0">
   <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
   <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
-  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
+  <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
+  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
   <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css">
   <link rel="stylesheet" href="/css/screen.css">
   <link rel="icon" type="image/x-icon" href="/favicon.ico">
   <!-- Begin Jekyll SEO tag v2.4.0 -->
 <title>Plugins | Jekyll • Simple, blog-aware, static sites</title>
-<meta name="generator" content="Jekyll v3.7.3">
+<meta name="generator" content="Jekyll v3.8.0">
 <meta property="og:title" content="Plugins">
 <meta property="og:locale" content="en_US">
 <meta name="description" content="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.">
@@ -22,12 +23,12 @@
 <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="2018-03-27T03:44:17-07:00">
+<meta property="article:published_time" content="2018-05-01T13:26:35-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">
-{"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Plugins","dateModified":"2018-03-27T03:44:17-07:00","datePublished":"2018-03-27T03:44:17-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.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/plugins/"},"@type":"BlogPosting","url":"https://jekyllrb.com/docs/plugins/","@context":"http://schema.org"}</script>
+{"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.","@type":"BlogPosting","url":"https://jekyllrb.com/docs/plugins/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Plugins","dateModified":"2018-05-01T13:26:35-07:00","datePublished":"2018-05-01T13:26:35-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/plugins/"},"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -72,7 +73,7 @@
     <div class="meta hide-on-mobiles">
       <ul>
         <li>
-          <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.2">v3.7.2</a>
+          <a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.0">v3.8.0</a>
         </li>
         <li>
           <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -392,7 +393,11 @@ the <code class="highlighter-rouge">plugins:</code> key in your site’s config
   <li><a href="#hooks">Hooks</a></li>
 </ol>
 
-<p>See the bottom of the page for a <a href="#available-plugins">list of available plugins</a></p>
+<p>See the bottom of the page for a <a href="#available-plugins">list of available plugins</a>.</p>
+
+<p>For further information on how to develop your own plugins, check out the <a href="https://github.com/Shopify/liquid/wiki/Liquid-for-Programmers">Liquid documentation</a> as well.</p>
+
+<p>If you never developed a Jekyll plugin <a href="https://ayastreb.me/writing-a-jekyll-plugin/">check this useful wrap-up</a> by <a href="https://github.com/ayastreb" class="user-mention">@ayastreb</a> to get started.</p>
 
 <h2 id="generators">Generators</h2>
 
@@ -1039,13 +1044,6 @@ rendering all the site (useful for sitemaps, feeds, etc).</p>
 
 <ul>
   <li>
-<a href="https://gist.github.com/707909">ArchiveGenerator by Ilkka Laukkanen</a>: Uses <a href="https://gist.github.com/707020">this archive page</a> to generate archives.</li>
-  <li>
-<a href="https://gist.github.com/642739">LESS.js Generator by Andy Fowler</a>: Renders
-LESS.js files during generation.</li>
-  <li>
-<a href="https://gist.github.com/449491">Version Reporter by Blake Smith</a>: Creates a version.html file containing the Jekyll version.</li>
-  <li>
 <a href="https://github.com/kinnetica/jekyll-plugins">Sitemap.xml Generator by Michael Levin</a>: Generates a sitemap.xml file by traversing all of the available posts and pages.</li>
   <li>
 <a href="https://github.com/PascalW/jekyll_indextank">Full-text search by Pascal Widdershoven</a>: Adds full-text search to your Jekyll site with a plugin and a bit of JavaScript.</li>
@@ -1076,8 +1074,6 @@ LESS.js files during generation.</li>
   <li>
 <a href="https://github.com/ivantsepp/jekyll-git_metadata">Jekyll::GitMetadata by Ivan Tse</a>: Expose Git metadata for your templates.</li>
   <li>
-<a href="https://gist.github.com/snrbrnjna/422a4b7e017192c284b3">Jekyll Http Basic Auth Plugin</a>: Plugin to manage http basic auth for jekyll generated pages and directories.</li>
-  <li>
 <a href="https://github.com/merlos/jekyll-auto-image">Jekyll Auto Image by Merlos</a>: Gets the first image of a post. Useful to list your posts with images or to add <a href="https://dev.twitter.com/cards/overview">twitter cards</a> to your site.</li>
   <li>
 <a href="https://github.com/codeinpink/jekyll-portfolio-generator">Jekyll Portfolio Generator by Shannon Babincsak</a>: Generates project pages and computes related projects out of project data files.</li>
@@ -1103,6 +1099,10 @@ LESS.js files during generation.</li>
 <a href="https://github.com/ibrado/jekyll-stickyposts">Stickyposts</a>: Moves or copies (pins) posts marked <code class="highlighter-rouge">sticky: true</code> to the top of the list. Perfect for keeping important announcements on the home page, or giving collections a descriptive entry. Paginator friendly.</li>
   <li>
 <a href="https://github.com/ibrado/jekyll-paginate-content">Jekyll::Paginate::Content</a>: Content paginator in the style of jekyll-paginator-v2 that splits pages, posts, and collection entries into several pages. Specify a separator or use HTML &lt;h1&gt; etc. headers. Automatic splitting, single-page view, pager/trail, self-adjusting links, multipage TOC, SEO support.</li>
+  <li>
+<a href="https://github.com/amedia/premonition">Premonition</a>: Adds block-styled side content to your page. For example summary, notes, hints or warning boxes.</li>
+  <li>
+<a href="https://github.com/ericcornelissen/jekyll-fontello">jekyll-fontello</a>: A Jekyll plugin that automatically downloads your webfont from Fontello.</li>
 </ul>
 
 <h4 id="converters-1">Converters</h4>
@@ -1115,32 +1115,12 @@ LESS.js files during generation.</li>
   <li>
 <a href="https://github.com/slim-template/jekyll-slim">Slim plugin</a>: Slim converter and includes for Jekyll with support for Liquid tags.</li>
   <li>
-<a href="https://gist.github.com/517556">HAML plugin by Sam Z</a>: HAML converter for Jekyll.</li>
-  <li>
-<a href="https://gist.github.com/481456">HAML-Sass Converter by Adam Pearson</a>: Simple HAML-Sass converter for Jekyll. <a href="https://gist.github.com/528642">Fork</a> by Sam X.</li>
-  <li>
-<a href="https://gist.github.com/960150">Sass SCSS Converter by Mark Wolfe</a>: Sass converter which uses the new CSS compatible syntax, based Sam X’s fork above.</li>
-  <li>
-<a href="https://gist.github.com/639920">LESS Converter by Jason Graham</a>: Convert LESS files to CSS.</li>
-  <li>
-<a href="https://gist.github.com/760265">LESS Converter by Josh Brown</a>: Simple LESS converter.</li>
-  <li>
-<a href="https://gist.github.com/449463">Upcase Converter by Blake Smith</a>: An example Jekyll converter.</li>
-  <li>
-<a href="https://gist.github.com/959938">CoffeeScript Converter by phaer</a>: A <a href="http://coffeescript.org">CoffeeScript</a> to Javascript converter.</li>
-  <li>
 <a href="https://github.com/olov/jekyll-references">Markdown References by Olov Lassus</a>: Keep all your markdown reference-style link definitions in one _references.md file.</li>
   <li>
-<a href="https://gist.github.com/988201">Stylus Converter</a>: Convert .styl to .css.</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/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>
-  <li>
-<a href="https://gist.github.com/abhiyerra/7377603">Org-mode Converter</a>: Org-mode converter for Jekyll.</li>
-  <li>
 <a href="https://github.com/mvdbos/kramdown-with-pygments">Customized Kramdown Converter</a>: Enable Pygments syntax highlighting for Kramdown-parsed fenced code blocks.</li>
   <li>
 <a href="https://github.com/TheFox/jekyll-bigfootnotes">Bigfootnotes Plugin</a>: Enables big footnotes for Kramdown.</li>
@@ -1160,12 +1140,8 @@ LESS.js files during generation.</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>
-<a href="https://gist.github.com/731597">Summarize Filter by Mathieu Arnold</a>: Remove markup after a <code class="highlighter-rouge">&lt;div id="extended"&gt;</code> tag.</li>
-  <li>
 <a href="https://github.com/SaswatPadhi/jekyll_smilify">Smilify</a> by <a href="https://github.com/SaswatPadhi">SaswatPadhi</a>: Convert text emoticons in your content to themeable smiley pics.</li>
   <li>
-<a href="https://gist.github.com/zachleat/5792681">Read in X Minutes</a> by <a href="https://github.com/zachleat">zachleat</a>: Estimates the reading time of a string (for blog post content).</li>
-  <li>
 <a href="https://github.com/markets/jekyll-timeago">Jekyll-timeago</a>: Converts a time value to the time ago in words.</li>
   <li>
 <a href="https://github.com/bdesham/pluralize">pluralize</a>: Easily combine a number and a word into a grammatically-correct amount like “1 minute” or “2 minute<strong>s</strong>”.</li>
@@ -1201,6 +1177,8 @@ LESS.js files during generation.</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>
+  <li>
+<a href="https://github.com/codecalm/jekyll-random">jekyll-random</a> by <a href="https://nodecalm.net">codecalm</a>: A Jekyll plugin that generates pseudo-random data. Very useful when you want to generate a large amount of random data.</li>
 </ul>
 
 <h4 id="tags-1">Tags</h4>
@@ -1215,26 +1193,8 @@ LESS.js files during generation.</li>
   <li>
 <a href="https://github.com/christianhellsten/jekyll-plugins">Delicious Plugin by Christian Hellsten</a>: Fetches and renders bookmarks from delicious.com.</li>
   <li>
-<a href="https://gist.github.com/480380">Ultraviolet Plugin by Steve Alex</a>: Jekyll tag for the <a href="https://github.com/grosser/ultraviolet">Ultraviolet</a> code highligher.</li>
-  <li>
-<a href="https://gist.github.com/710577">Tag Cloud Plugin by Ilkka Laukkanen</a>: Generate a tag cloud that links to tag pages.</li>
-  <li>
-<a href="https://gist.github.com/730347">GIT Tag by Alexandre Girard</a>: Add Git activity inside a list.</li>
-  <li>
-<a href="https://gist.github.com/834610">MathJax Liquid Tags by Jessy Cowan-Sharp</a>: Simple liquid tags for Jekyll that convert inline math and block equations to the appropriate MathJax script tags.</li>
-  <li>
-<a href="https://gist.github.com/1027674">Non-JS Gist Tag by Brandon Tilley</a> A Liquid tag that embeds Gists and shows code for non-JavaScript enabled browsers and readers.</li>
-  <li>
-<a href="https://gist.github.com/449509">Render Time Tag by Blake Smith</a>: Displays the time a Jekyll page was generated.</li>
-  <li>
-<a href="https://gist.github.com/912466">Status.net/OStatus Tag by phaer</a>: Displays the notices in a given status.net/ostatus feed.</li>
-  <li>
 <a href="https://github.com/robb/jekyll-embedly-client">Embed.ly client by Robert Böhnke</a>: Autogenerate embeds from URLs using oEmbed.</li>
   <li>
-<a href="https://gist.github.com/2290195">Logarithmic Tag Cloud</a>: Flexible. Logarithmic distribution. Documentation inline.</li>
-  <li>
-<a href="https://gist.github.com/1455726">oEmbed Tag by Tammo van Lessen</a>: Enables easy content embedding (e.g. from YouTube, Flickr, Slideshare) via oEmbed.</li>
-  <li>
 <a href="https://github.com/tsmango/jekyll_flickr_set_tag">FlickrSetTag by Thomas Mango</a>: Generates image galleries from Flickr sets.</li>
   <li>
 <a href="https://github.com/scottwb/jekyll-tweet-tag">Tweet Tag by Scott W. Bradley</a>: Liquid tag for <a href="https://dev.twitter.com/docs/embedded-tweets">Embedded Tweets</a> using Twitter’s shortcodes.</li>
@@ -1243,26 +1203,16 @@ LESS.js files during generation.</li>
   <li>
 <a href="https://github.com/rustygeldmacher/jekyll-contentblocks">Jekyll-contentblocks</a>: Lets you use Rails-like content_for tags in your templates, for passing content from your posts up to your layouts.</li>
   <li>
-<a href="https://gist.github.com/1805814">Generate YouTube Embed</a> by <a href="https://github.com/joelverhagen">joelverhagen</a>: Jekyll plugin which allows you to embed a YouTube video in your page with the YouTube ID. Optionally specify width and height dimensions. Like “oEmbed Tag” but just for YouTube.</li>
-  <li>
 <a href="https://github.com/okeeblow/jekyll-beastiepress">Jekyll-beastiepress</a>: FreeBSD utility tags for Jekyll sites.</li>
   <li>
-<a href="https://gist.github.com/1895282">Jsonball</a>: Reads json files and produces maps for use in Jekyll files.</li>
-  <li>
 <a href="https://github.com/pablooliveira/bibjekyll">Bibjekyll</a>: Render BibTeX-formatted bibliographies/citations included in posts and pages using bibtex2html.</li>
   <li>
 <a href="https://github.com/archome/jekyll-citation">Jekyll-citation</a>: Render BibTeX-formatted bibliographies/citations included in posts and pages (pure Ruby).</li>
   <li>
 <a href="https://github.com/ericdfields/Jekyll-Dribbble-Set-Tag">Jekyll Dribbble Set Tag</a>: Builds Dribbble image galleries from any user.</li>
   <li>
-<a href="https://gist.github.com/2218470">Debbugs</a>: Allows posting links to Debian BTS easily.</li>
-  <li>
-<a href="https://gist.github.com/2403522">Jekyll-devonly_tag</a>: A block tag for including markup only during development.</li>
-  <li>
 <a href="https://github.com/redwallhp/JekyllGalleryTag">JekyllGalleryTag</a> by <a href="https://github.com/redwallhp">redwallhp</a>: Generates thumbnails from a directory of images and displays them in a grid.</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="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>
@@ -1281,11 +1231,6 @@ LESS.js files during generation.</li>
   <li>
 <a href="https://github.com/GSI/jekyll_quick_man">Jekyll Quick Man</a> by <a href="https://github.com/GSI">GSI</a>: Tag that renders pretty links to man page sources on the internet.</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="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>
   <li>
 <a href="https://github.com/lmullen/jekyll_figure">jekyll_figure</a>: Generate figures and captions with links to the figure in a variety of formats</li>
@@ -1346,6 +1291,10 @@ plugin to generate publication lists from <a href="https://www.bibsonomy.org/">B
 <a href="https://github.com/kacperduras/disqus-for-jekyll">disqus-for-jekyll</a>: A Jekyll plugin to view the comments powered by Disqus.</li>
   <li>
 <a href="https://github.com/kacperduras/jekyll-html">jekyll-html</a>: A Jekyll plugin to use HTML tags in Jekyll pages, posts and collections.</li>
+  <li>
+<a href="https://github.com/rriemann/jekyll-onebox">jekyll-onebox</a>: Liquid tag for displaying HTML previews (embeds) for links to popular domains. Plugin is based on <a href="https://github.com/discourse/onebox">Onebox</a> that powers link previews in <a href="http://github.com/discourse/discourse">Discourse</a> forums.</li>
+  <li>
+<a href="https://github.com/kacperduras/jekyll-w2m">jekyll-w2m</a>: A Jekyll plugin to liberate content from Microsoft Word documents (powered by <a href="https://github.com/benbalter/word-to-markdown">word-to-markdown</a>).</li>
 </ul>
 
 <h4 id="collections">Collections</h4>
@@ -1369,18 +1318,10 @@ plugin to generate publication lists from <a href="https://www.bibsonomy.org/">B
   <li>
 <a href="https://github.com/rsim/blog.rayapps.com/blob/master/_plugins/pygments_cache_patch.rb">Pygments Cache Path by Raimonds Simanovskis</a>: Plugin to cache syntax-highlighted code from Pygments.</li>
   <li>
-<a href="https://gist.github.com/49630">Draft/Publish Plugin by Michael Ivey</a>: Save posts as drafts.</li>
-  <li>
-<a href="https://gist.github.com/490101">Growl Notification Generator by Tate Johnson</a>: Send Jekyll notifications to Growl.</li>
-  <li>
-<a href="https://gist.github.com/525267">Growl Notification Hook by Tate Johnson</a>: Better alternative to the above, but requires his “hook” fork.</li>
-  <li>
 <a href="https://github.com/LawrenceWoodman/related_posts-jekyll_plugin">Related Posts by Lawrence Woodman</a>: Overrides <code class="highlighter-rouge">site.related_posts</code> to use categories to assess relationship.</li>
   <li>
 <a href="https://github.com/toshimaru/jekyll-tagging-related_posts">jekyll-tagging-related_posts</a>: Jekyll related_posts function based on tags (works on Jekyll3).</li>
   <li>
-<a href="https://gist.github.com/88cda643aa7e3b0ca1e5">Tiered Archives by Eli Naeher</a>: Create tiered template variable that allows you to group archives by year and month.</li>
-  <li>
 <a href="https://github.com/blackwinter/jekyll-localization">Jekyll-localization</a>: Jekyll plugin that adds localization features to the rendering engine.</li>
   <li>
 <a href="https://github.com/blackwinter/jekyll-rendering">Jekyll-rendering</a>: Jekyll plugin to provide alternative rendering engines.</li>
@@ -1395,8 +1336,6 @@ plugin to generate publication lists from <a href="https://www.bibsonomy.org/">B
   <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>
-<a href="https://gist.github.com/2758691">File compressor</a> by <a href="https://github.com/mytharcher">mytharcher</a>: Compress HTML and JavaScript files on site build.</li>
-  <li>
 <a href="https://github.com/tkareine/jekyll-minibundle">Jekyll-minibundle</a>: Asset bundling and cache busting using external minification tool of your choice. No gem dependencies.</li>
   <li>
 <a href="https://github.com/JCB-K/singlepage-jekyll">Singlepage-jekyll</a> by <a href="https://github.com/JCB-K">JCB-K</a>: Turns Jekyll into a dynamic one-page website.</li>
@@ -1450,13 +1389,14 @@ plugin to generate publication lists from <a href="https://www.bibsonomy.org/">B
 <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>
   <li>
 <a href="https://github.com/lavas-project/jekyll-pwa">jekyll-pwa-plugin</a>: A plugin provides PWA support for Jekyll. It generates a service worker in Jekyll build process and makes precache and runtime cache available in the runtime with Google Workbox.</li>
+  <li>
+<a href="https://community.algolia.com/jekyll-algolia/">jekyll-algolia</a>: Add fast and relevant search to your Jekyll site through the Algolia API.</li>
 </ul>
 
 <div class="note info">
-  <h5>Jekyll Plugins Wanted</h5>
+  <h5>Submit your gem plugins</h5>
   <p>
-    If you have a Jekyll plugin that you would like to see added to this list,
-    you should <a href="../contributing/">read the contributing page</a> to find
+    You're encouraged to add your Jekyll gem plugins to this list, <a href="../contributing/">read the contributing page</a> to find
     out how to make that happen.
   </p>
 </div>
@@ -1797,28 +1737,11 @@ plugin to generate publication lists from <a href="https://www.bibsonomy.org/">B
 </script>
 
   
-  <!-- Gauges (http://get.gaug.es/) -->
-  <script>
-    var _gauges = _gauges || [];
-    (function() {
-      var t   = document.createElement('script');
-      t.type  = 'text/javascript';
-      t.async = true;
-      t.id    = 'gauges-tracker';
-      t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
-      t.src = '//secure.gaug.es/track.js';
-      var s = document.getElementsByTagName('script')[0];
-      s.parentNode.insertBefore(t, s);
-    })();
-  </script>
-
-
-
   <!-- 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),
-    L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
+    L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
     L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
 
     ga('create', 'UA-50755011-1', 'jekyllrb.com');

data/site/docs/posts/index.html

@@ -4,16 +4,17 @@
 <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.7.3">
+  <meta name="generator" content="Jekyll v3.8.0">
   <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
   <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
-  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
+  <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
+  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
   <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css">
   <link rel="stylesheet" href="/css/screen.css">
   <link rel="icon" type="image/x-icon" href="/favicon.ico">
   <!-- Begin Jekyll SEO tag v2.4.0 -->
 <title>Writing posts | Jekyll • Simple, blog-aware, static sites</title>
-<meta name="generator" content="Jekyll v3.7.3">
+<meta name="generator" content="Jekyll v3.8.0">
 <meta property="og:title" content="Writing posts">
 <meta property="og:locale" content="en_US">
 <meta name="description" content="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!">
@@ -22,12 +23,12 @@
 <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="2018-03-27T03:44:17-07:00">
+<meta property="article:published_time" content="2018-05-01T13:26:35-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">
-{"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Writing posts","dateModified":"2018-03-27T03:44:17-07:00","datePublished":"2018-03-27T03:44:17-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!","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/posts/"},"@type":"BlogPosting","url":"https://jekyllrb.com/docs/posts/","@context":"http://schema.org"}</script>
+{"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!","@type":"BlogPosting","url":"https://jekyllrb.com/docs/posts/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Writing posts","dateModified":"2018-05-01T13:26:35-07:00","datePublished":"2018-05-01T13:26:35-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/posts/"},"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -72,7 +73,7 @@
     <div class="meta hide-on-mobiles">
       <ul>
         <li>
-          <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.2">v3.7.2</a>
+          <a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.0">v3.8.0</a>
         </li>
         <li>
           <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -476,13 +477,36 @@ called <code class="highlighter-rouge">blog.html</code> with at least</p>
 
 <p>In this case, the listing pages will be accessible at <code class="highlighter-rouge">{baseurl}/category/blog.html</code></p>
 
-<p>While this example is done with categories, you can easily extend your lists to
-filter by tags or any other variable created with extensions.</p>
+<p>Although categories and tags are very similar, they are used to group posts,
+there are a few differences between them.  Categories and sub-categories create
+hierarchies that, by default, are reflected in the directory structure of your
+site.  A post with the following header</p>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
+<span class="na">layout</span><span class="pi">:</span> <span class="s">post</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">A Trip</span>
+<span class="na">category</span><span class="pi">:</span> <span class="pi">[</span> <span class="nv">blog</span><span class="pi">,</span> <span class="nv">travel</span> <span class="pi">]</span>
+<span class="nn">---</span>
+</code></pre></div></div>
+<p>will be accessible at <code class="highlighter-rouge">{baseurl}/blog/travel/year/month/day/A-Trip.html</code>.  On
+the other hand, a tagged post</p>
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
+<span class="na">layout</span><span class="pi">:</span> <span class="s">post</span>
+<span class="na">title</span><span class="pi">:</span> <span class="s">A Trip</span>
+<span class="na">tags</span><span class="pi">:</span> <span class="pi">[</span> <span class="nv">blog</span><span class="pi">,</span> <span class="nv">travel</span> <span class="pi">]</span>
+<span class="nn">---</span>
+</code></pre></div></div>
+<p>will be saved as <code class="highlighter-rouge">{baseurl}/year/month/day/A-Trip.html</code>.  It is up to you to
+create <code class="highlighter-rouge">{baseurl}/tag/blog.html</code> and <code class="highlighter-rouge">{baseurl}/tag/travel.html</code> the same way as
+described above for categories.</p>
+
+<p>While this example is done with tags and categories, you can easily extend your
+lists to filter by any other variable created with extensions.</p>
 
 <h2 id="post-excerpts">Post excerpts</h2>
 
 <p>Each post automatically takes the first block of text, from the beginning of
-the content to the first occurrence of <code class="highlighter-rouge">excerpt_separator</code>, and sets it as the <code class="highlighter-rouge">post.excerpt</code>.
+the content to the first occurrence of <code class="highlighter-rouge">excerpt_separator</code>, and sets it in the
+post’s data hash.
 Take the above example of an index of posts. Perhaps you want to include
 a little hint about the post’s content by adding the first paragraph of each of
 your posts:</p>
@@ -869,28 +893,11 @@ site.</p>
 </script>
 
   
-  <!-- Gauges (http://get.gaug.es/) -->
-  <script>
-    var _gauges = _gauges || [];
-    (function() {
-      var t   = document.createElement('script');
-      t.type  = 'text/javascript';
-      t.async = true;
-      t.id    = 'gauges-tracker';
-      t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
-      t.src = '//secure.gaug.es/track.js';
-      var s = document.getElementsByTagName('script')[0];
-      s.parentNode.insertBefore(t, s);
-    })();
-  </script>
-
-
-
   <!-- 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),
-    L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
+    L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
     L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
 
     ga('create', 'UA-50755011-1', 'jekyllrb.com');

data/site/docs/quickstart/index.html

@@ -3,16 +3,17 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width,initial-scale=1">
-  <meta name="generator" content="Jekyll v3.7.3">
+  <meta name="generator" content="Jekyll v3.8.0">
   <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
   <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
-  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
+  <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
+  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
   <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
   <link rel="stylesheet" href="/css/screen.css">
   <link rel="icon" type="image/x-icon" href="/favicon.ico">
   <!-- Begin Jekyll SEO tag v2.4.0 -->
 <title>Quick-start guide | Jekyll • Simple, blog-aware, static sites</title>
-<meta name="generator" content="Jekyll v3.7.3" />
+<meta name="generator" content="Jekyll v3.8.0" />
 <meta property="og:title" content="Quick-start guide" />
 <meta property="og:locale" content="en_US" />
 <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:" />
@@ -21,12 +22,12 @@
 <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="2018-03-27T03:44:17-07:00" />
+<meta property="article:published_time" content="2018-05-01T13:26:35-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">
-{"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Quick-start guide","dateModified":"2018-03-27T03:44:17-07:00","datePublished":"2018-03-27T03:44:17-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:","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/quickstart/"},"@type":"BlogPosting","url":"https://jekyllrb.com/docs/quickstart/","@context":"http://schema.org"}</script>
+{"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:","@type":"BlogPosting","url":"https://jekyllrb.com/docs/quickstart/","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"headline":"Quick-start guide","dateModified":"2018-05-01T13:26:35-07:00","datePublished":"2018-05-01T13:26:35-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/quickstart/"},"@context":"http://schema.org"}</script>
 <!-- End Jekyll SEO tag -->
 
   <!--[if lt IE 9]>
@@ -71,7 +72,7 @@
     <div class="meta hide-on-mobiles">
       <ul>
         <li>
-          <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.2">v3.7.2</a>
+          <a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.0">v3.8.0</a>
         </li>
         <li>
           <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -618,28 +619,11 @@ bundle <span class="nb">exec </span>jekyll serve
 </script>
 
   
-  <!-- Gauges (http://get.gaug.es/) -->
-  <script>
-    var _gauges = _gauges || [];
-    (function() {
-      var t   = document.createElement('script');
-      t.type  = 'text/javascript';
-      t.async = true;
-      t.id    = 'gauges-tracker';
-      t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
-      t.src = '//secure.gaug.es/track.js';
-      var s = document.getElementsByTagName('script')[0];
-      s.parentNode.insertBefore(t, s);
-    })();
-  </script>
-
-
-
   <!-- 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),
-    L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
+    L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
     L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
 
     ga('create', 'UA-50755011-1', 'jekyllrb.com');