RubyGems - jekyll-docs - Versions diffs - 3.6.1.0 → 3.6.2 - Mend

jekyll-docs 3.6.1.0 → 3.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (253) hide show

checksums.yaml +4 -4
data/lib/jekyll.rb +195 -0
data/lib/jekyll/cleaner.rb +110 -0
data/lib/jekyll/collection.rb +230 -0
data/lib/jekyll/command.rb +78 -0
data/lib/jekyll/commands/build.rb +102 -0
data/lib/jekyll/commands/clean.rb +43 -0
data/lib/jekyll/commands/doctor.rb +153 -0
data/lib/jekyll/commands/help.rb +34 -0
data/lib/jekyll/commands/new.rb +156 -0
data/lib/jekyll/commands/new_theme.rb +40 -0
data/lib/jekyll/commands/serve.rb +245 -0
data/lib/jekyll/commands/serve/servlet.rb +62 -0
data/lib/jekyll/configuration.rb +410 -0
data/lib/jekyll/converter.rb +54 -0
data/lib/jekyll/converters/identity.rb +23 -0
data/lib/jekyll/converters/markdown.rb +104 -0
data/lib/jekyll/converters/markdown/kramdown_parser.rb +123 -0
data/lib/jekyll/converters/markdown/rdiscount_parser.rb +35 -0
data/lib/jekyll/converters/markdown/redcarpet_parser.rb +108 -0
data/lib/jekyll/converters/smartypants.rb +36 -0
data/lib/jekyll/convertible.rb +251 -0
data/lib/jekyll/deprecator.rb +52 -0
data/lib/jekyll/document.rb +507 -0
data/lib/jekyll/drops/collection_drop.rb +22 -0
data/lib/jekyll/drops/document_drop.rb +69 -0
data/lib/jekyll/drops/drop.rb +214 -0
data/lib/jekyll/drops/excerpt_drop.rb +15 -0
data/lib/jekyll/drops/jekyll_drop.rb +33 -0
data/lib/jekyll/drops/site_drop.rb +47 -0
data/lib/jekyll/drops/static_file_drop.rb +13 -0
data/lib/jekyll/drops/unified_payload_drop.rb +25 -0
data/lib/jekyll/drops/url_drop.rb +88 -0
data/lib/jekyll/entry_filter.rb +123 -0
data/lib/jekyll/errors.rb +20 -0
data/lib/jekyll/excerpt.rb +126 -0
data/lib/jekyll/external.rb +74 -0
data/lib/jekyll/filters.rb +430 -0
data/lib/jekyll/filters/grouping_filters.rb +65 -0
data/lib/jekyll/filters/url_filters.rb +60 -0
data/lib/jekyll/frontmatter_defaults.rb +197 -0
data/lib/jekyll/generator.rb +5 -0
data/lib/jekyll/hooks.rb +104 -0
data/lib/jekyll/layout.rb +62 -0
data/lib/jekyll/liquid_extensions.rb +24 -0
data/lib/jekyll/liquid_renderer.rb +49 -0
data/lib/jekyll/liquid_renderer/file.rb +56 -0
data/lib/jekyll/liquid_renderer/table.rb +96 -0
data/lib/jekyll/log_adapter.rb +147 -0
data/lib/jekyll/mime.types +825 -0
data/lib/jekyll/page.rb +187 -0
data/lib/jekyll/plugin.rb +98 -0
data/lib/jekyll/plugin_manager.rb +113 -0
data/lib/jekyll/publisher.rb +23 -0
data/lib/jekyll/reader.rb +134 -0
data/lib/jekyll/readers/collection_reader.rb +22 -0
data/lib/jekyll/readers/data_reader.rb +77 -0
data/lib/jekyll/readers/layout_reader.rb +71 -0
data/lib/jekyll/readers/page_reader.rb +25 -0
data/lib/jekyll/readers/post_reader.rb +72 -0
data/lib/jekyll/readers/static_file_reader.rb +25 -0
data/lib/jekyll/readers/theme_assets_reader.rb +49 -0
data/lib/jekyll/regenerator.rb +201 -0
data/lib/jekyll/related_posts.rb +52 -0
data/lib/jekyll/renderer.rb +269 -0
data/lib/jekyll/site.rb +472 -0
data/lib/jekyll/static_file.rb +162 -0
data/lib/jekyll/stevenson.rb +61 -0
data/lib/jekyll/tags/highlight.rb +141 -0
data/lib/jekyll/tags/include.rb +215 -0
data/lib/jekyll/tags/link.rb +37 -0
data/lib/jekyll/tags/post_url.rb +103 -0
data/lib/jekyll/theme.rb +68 -0
data/lib/jekyll/theme_builder.rb +119 -0
data/lib/jekyll/url.rb +161 -0
data/lib/jekyll/utils.rb +340 -0
data/lib/jekyll/utils/ansi.rb +59 -0
data/lib/jekyll/utils/exec.rb +27 -0
data/lib/jekyll/utils/platforms.rb +82 -0
data/lib/jekyll/utils/rouge.rb +21 -0
data/lib/jekyll/utils/win_tz.rb +75 -0
data/lib/jekyll/version.rb +5 -0
data/lib/site_template/404.html +24 -0
data/lib/site_template/_config.yml +43 -0
data/lib/site_template/_posts/0000-00-00-welcome-to-jekyll.markdown.erb +25 -0
data/lib/site_template/about.md +18 -0
data/lib/site_template/index.md +6 -0
data/lib/theme_template/CODE_OF_CONDUCT.md.erb +74 -0
data/lib/theme_template/Gemfile +4 -0
data/lib/theme_template/LICENSE.txt.erb +21 -0
data/lib/theme_template/README.md.erb +52 -0
data/lib/theme_template/_layouts/default.html +1 -0
data/lib/theme_template/_layouts/page.html +5 -0
data/lib/theme_template/_layouts/post.html +5 -0
data/lib/theme_template/example/_config.yml.erb +1 -0
data/lib/theme_template/example/_post.md +12 -0
data/lib/theme_template/example/index.html +14 -0
data/lib/theme_template/example/style.scss +7 -0
data/lib/theme_template/gitignore.erb +5 -0
data/lib/theme_template/theme.gemspec.erb +19 -0
metadata +103 -156
data/lib/jekyll-docs.rb +0 -31
data/site/404.html +0 -153
data/site/CNAME +0 -1
data/site/community/index.html +0 -299
data/site/conduct/index.html +0 -10
data/site/css/screen.css +0 -1
data/site/docs/assets/index.html +0 -724
data/site/docs/code_of_conduct/index.html +0 -730
data/site/docs/collections/index.html +0 -1097
data/site/docs/conduct/index.html +0 -744
data/site/docs/configuration/index.html +0 -1403
data/site/docs/continuous-integration/buddyworks/index.html +0 -726
data/site/docs/continuous-integration/circleci/index.html +0 -757
data/site/docs/continuous-integration/index.html +0 -681
data/site/docs/continuous-integration/travis-ci/index.html +0 -891
data/site/docs/contributing/index.html +0 -863
data/site/docs/datafiles/index.html +0 -780
data/site/docs/deployment-methods/index.html +0 -875
data/site/docs/drafts/index.html +0 -636
data/site/docs/extras/index.html +0 -689
data/site/docs/frontmatter/index.html +0 -821
data/site/docs/github-pages/index.html +0 -819
data/site/docs/history/index.html +0 -3955
data/site/docs/home/index.html +0 -644
data/site/docs/includes/index.html +0 -800
data/site/docs/index.html +0 -10
data/site/docs/installation/index.html +0 -732
data/site/docs/maintaining/affinity-team-captain/index.html +0 -706
data/site/docs/maintaining/avoiding-burnout/index.html +0 -709
data/site/docs/maintaining/becoming-a-maintainer/index.html +0 -717
data/site/docs/maintaining/index.html +0 -713
data/site/docs/maintaining/merging-a-pull-request/index.html +0 -747
data/site/docs/maintaining/reviewing-a-pull-request/index.html +0 -725
data/site/docs/maintaining/special-labels/index.html +0 -705
data/site/docs/maintaining/triaging-an-issue/index.html +0 -735
data/site/docs/migrations/index.html +0 -647
data/site/docs/pages/index.html +0 -695
data/site/docs/pagination/index.html +0 -870
data/site/docs/permalinks/index.html +0 -1035
data/site/docs/plugins/index.html +0 -1800
data/site/docs/posts/index.html +0 -858
data/site/docs/quickstart/index.html +0 -650
data/site/docs/resources/index.html +0 -769
data/site/docs/sites/index.html +0 -702
data/site/docs/static-files/index.html +0 -720
data/site/docs/structure/index.html +0 -822
data/site/docs/templates/index.html +0 -1208
data/site/docs/themes/index.html +0 -935
data/site/docs/troubleshooting/index.html +0 -916
data/site/docs/upgrading/0-to-2/index.html +0 -826
data/site/docs/upgrading/2-to-3/index.html +0 -824
data/site/docs/upgrading/index.html +0 -693
data/site/docs/usage/index.html +0 -705
data/site/docs/variables/index.html +0 -1048
data/site/docs/windows/index.html +0 -799
data/site/favicon.ico +0 -0
data/site/feed.xml +0 -372
data/site/fonts/FontAwesome.eot +0 -0
data/site/fonts/FontAwesome.svg +0 -12
data/site/fonts/FontAwesome.ttf +0 -0
data/site/fonts/FontAwesome.woff +0 -0
data/site/github.html +0 -10
data/site/help/index.html +0 -244
data/site/icomoon-selection.json +0 -96
data/site/img/article-footer.png +0 -0
data/site/img/footer-arrow.png +0 -0
data/site/img/footer-logo.png +0 -0
data/site/img/jekyll-sticker.jpg +0 -0
data/site/img/jekylllayoutconcept.png +0 -0
data/site/img/logo-2x.png +0 -0
data/site/img/logo-rss.png +0 -0
data/site/img/octojekyll.png +0 -0
data/site/index.html +0 -267
data/site/issues.html +0 -10
data/site/js/html5shiv.min.js +0 -4
data/site/js/respond.min.js +0 -5
data/site/latest_version.txt +0 -1
data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +0 -570
data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +0 -570
data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +0 -571
data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +0 -568
data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +0 -570
data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +0 -569
data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +0 -565
data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +0 -565
data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +0 -572
data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +0 -566
data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +0 -564
data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +0 -599
data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +0 -568
data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +0 -583
data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +0 -565
data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +0 -564
data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +0 -573
data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +0 -564
data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +0 -569
data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +0 -585
data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +0 -565
data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +0 -567
data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +0 -582
data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +0 -579
data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +0 -568
data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +0 -588
data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +0 -574
data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +0 -597
data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +0 -575
data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +0 -565
data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +0 -572
data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +0 -567
data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +0 -568
data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +0 -588
data/site/news/2015/02/26/introducing-jekyll-talk/index.html +0 -563
data/site/news/2015/10/26/jekyll-3-0-released/index.html +0 -592
data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +0 -576
data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +0 -566
data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +0 -599
data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +0 -583
data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +0 -578
data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +0 -569
data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +0 -565
data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +0 -571
data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +0 -566
data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +0 -572
data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +0 -576
data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +0 -564
data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +0 -566
data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +0 -567
data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +0 -676
data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +0 -571
data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +0 -566
data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +0 -645
data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +0 -569
data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +0 -592
data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +0 -649
data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +0 -598
data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +0 -594
data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +0 -589
data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +0 -569
data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +0 -573
data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +0 -565
data/site/news/index.html +0 -3609
data/site/news/releases/index.html +0 -3344
data/site/philosophy.html +0 -46
data/site/readme.md +0 -23
data/site/robots.txt +0 -1
data/site/sitemap.xml +0 -485
data/site/tutorials/convert-site-to-jekyll/index.html +0 -793
data/site/tutorials/custom-404-page/index.html +0 -358
data/site/tutorials/home/index.html +0 -323
data/site/tutorials/index.html +0 -10
data/site/tutorials/navigation/index.html +0 -872
data/site/tutorials/orderofinterpretation/index.html +0 -441

data/site/docs/troubleshooting/index.html DELETED Viewed

@@ -1,916 +0,0 @@
-<!DOCTYPE HTML>
-<html lang="en-US">
-<head>
-<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.6.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.3.0 -->
-<title>Troubleshooting | Jekyll • Simple, blog-aware, static sites</title>
-<meta property="og:title" content="Troubleshooting">
-<meta property="og:locale" content="en_US">
-<meta name="description" content="If you ever run into problems installing or using Jekyll, here are a few tips that might be of help. If the problem you’re experiencing isn’t covered below, please check out our other help resources as well.">
-<meta property="og:description" content="If you ever run into problems installing or using Jekyll, here are a few tips that might be of help. If the problem you’re experiencing isn’t covered below, please check out our other help resources as well.">
-<link rel="canonical" href="https://jekyllrb.com/docs/troubleshooting/">
-<meta property="og:url" content="https://jekyllrb.com/docs/troubleshooting/">
-<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-10-24T09:09:24-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">
-{"name":null,"description":"If you ever run into problems installing or using Jekyll, here are a few tips that might be of help. If the problem you’re experiencing isn’t covered below, please check out our other help resources as well.","url":"https://jekyllrb.com/docs/troubleshooting/","headline":"Troubleshooting","dateModified":"2017-10-24T09:09:24-07:00","datePublished":"2017-10-24T09:09:24-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/troubleshooting/"},"@context":"http://schema.org"}</script>
-<!-- End Jekyll SEO tag -->
-  <!--[if lt IE 9]>
-  <script src="/js/html5shiv.min.js"></script>
-  <script src="/js/respond.min.js"></script>
-  <![endif]-->
-</head>
-<body class="wrap">
-  <header>
-  <nav class="mobile-nav show-on-mobiles">
-    <ul>
-  <li class="">
-    <a href="/">Home</a>
-  </li>
-  <li class="current">
-    <a href="/docs/home/">Docs</a>
-  </li>
-  <li class="">
-    <a href="/news/">News</a>
-  </li>
-  <li class="">
-    <a href="/community/">Community</a>
-  </li>
-  <li class="">
-    <a href="/help/">Help</a>
-  </li>
-  <li>
-    <a href="https://github.com/jekyll/jekyll">GitHub</a>
-  </li>
-</ul>
-  </nav>
-  <div class="grid">
-    <div class="unit one-third center-on-mobiles">
-      <h1>
-        <a href="/">
-          <span class="sr-only">Jekyll</span>
-          <img src="/img/logo-2x.png" width="249" height="115" alt="Jekyll Logo">
-        </a>
-      </h1>
-    </div>
-    <nav class="main-nav unit two-thirds hide-on-mobiles">
-      <ul>
-  <li class="">
-    <a href="/">Home</a>
-  </li>
-  <li class="current">
-    <a href="/docs/home/">Docs</a>
-  </li>
-  <li class="">
-    <a href="/news/">News</a>
-  </li>
-  <li class="">
-    <a href="/community/">Community</a>
-  </li>
-  <li class="">
-    <a href="/help/">Help</a>
-  </li>
-  <li>
-    <a href="https://github.com/jekyll/jekyll">GitHub</a>
-  </li>
-</ul>
-    </nav>
-  </div>
-</header>
-    <section class="docs">
-    <div class="grid">
-      <div class="docs-nav-mobile unit whole show-on-mobiles">
-  <select onchange="if (this.value) window.location.href=this.value">
-    <option value="">Navigate the docs…</option>
-    <optgroup label="Getting Started">
-  <option value="/docs/home/">Welcome</option>
-  <option value="/docs/quickstart/">Quick-start guide</option>
-  <option value="/docs/installation/">Installation</option>
-  <option value="/docs/windows/">Jekyll on Windows</option>
-  <option value="/docs/usage/">Basic Usage</option>
-  <option value="/docs/structure/">Directory structure</option>
-  <option value="/docs/configuration/">Configuration</option>
-    </optgroup>
-    <optgroup label="Your Content">
-  <option value="/docs/frontmatter/">Front Matter</option>
-  <option value="/docs/posts/">Writing posts</option>
-  <option value="/docs/drafts/">Working with drafts</option>
-  <option value="/docs/pages/">Creating pages</option>
-  <option value="/docs/static-files/">Static Files</option>
-  <option value="/docs/variables/">Variables</option>
-  <option value="/docs/collections/">Collections</option>
-  <option value="/docs/datafiles/">Data Files</option>
-  <option value="/docs/assets/">Assets</option>
-  <option value="/docs/migrations/">Blog migrations</option>
-    </optgroup>
-    <optgroup label="Customization">
-  <option value="/docs/templates/">Templates</option>
-  <option value="/docs/includes/">Includes</option>
-  <option value="/docs/permalinks/">Permalinks</option>
-  <option value="/docs/pagination/">Pagination</option>
-  <option value="/docs/plugins/">Plugins</option>
-  <option value="/docs/themes/">Themes</option>
-  <option value="/docs/extras/">Extras</option>
-    </optgroup>
-    <optgroup label="Deployment">
-  <option value="/docs/github-pages/">GitHub Pages</option>
-  <option value="/docs/deployment-methods/">Deployment methods</option>
-  <option value="/docs/continuous-integration/">Continuous Integration</option>
-    </optgroup>
-    <optgroup label="Miscellaneous">
-  <option value="/docs/troubleshooting/">Troubleshooting</option>
-  <option value="/docs/sites/">Sites using Jekyll</option>
-  <option value="/docs/resources/">Resources</option>
-  <option value="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
-  <option value="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
-    </optgroup>
-    <optgroup label="Meta">
-  <option value="/docs/contributing/">Contributing</option>
-  <option value="/docs/maintaining/">Maintaining Jekyll</option>
-  <option value="/docs/conduct/">Code of Conduct</option>
-  <option value="/docs/history/">History</option>
-    </optgroup>
-  </select>
-</div>
-      <div class="unit four-fifths">
-        <article>
-          <div class="improve right hide-on-mobiles">
-            <a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/troubleshooting.md"><i class="fa fa-pencil"></i>  Improve this page</a>
-          </div>
-          <h1>Troubleshooting</h1>
-          <p>If you ever run into problems installing or using Jekyll, here are a few tips
-that might be of help. If the problem you’re experiencing isn’t covered below,
-<strong>please <a href="/help/">check out our other help resources</a></strong> as well.</p>
-<ul>
-  <li><a href="#installation-problems">Installation Problems</a></li>
-  <li><a href="#problems-running-jekyll">Problems running Jekyll</a></li>
-  <li><a href="#base-url-problems">Base-URL Problems</a></li>
-  <li><a href="#configuration-problems">Configuration problems</a></li>
-  <li><a href="#markup-problems">Markup Problems</a></li>
-  <li><a href="#production-problems">Production Problems</a></li>
-</ul>
-<h2 id="installation-problems">Installation Problems</h2>
-<p>If you encounter errors during gem installation, you may need to install
-the header files for compiling extension modules for Ruby 2.x This
-can be done on Ubuntu or Debian by running:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>apt-get install ruby2.3-dev
-</code></pre></div></div>
-<p>On Red Hat, CentOS, and Fedora systems you can do this by running:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>yum install ruby-devel
-</code></pre></div></div>
-<p>If you installed the above - specifically on Fedora 23 - but the extensions would still not compile, you are probably running a Fedora image that misses the <code class="highlighter-rouge">redhat-rpm-config</code> package. To solve this, simply run:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>dnf install redhat-rpm-config
-</code></pre></div></div>
-<p>On Ubuntu if you get stuck after <code class="highlighter-rouge">bundle exec jekyll serve</code> and see error
-messages like <code class="highlighter-rouge">Could not locate Gemfile</code> or <code class="highlighter-rouge">.bundle/ directory</code>, it’s likely
-because all requirements have not been fully met. Recent stock Ubuntu
-distributions require the installation of both the <code class="highlighter-rouge">ruby</code> and <code class="highlighter-rouge">ruby-all-dev</code>
-packages:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>apt-get install ruby ruby-all-dev
-</code></pre></div></div>
-<p>On <a href="https://www.nearlyfreespeech.net/">NearlyFreeSpeech</a> you need to run the
-following commands before installing Jekyll:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">export </span><span class="nv">GEM_HOME</span><span class="o">=</span>/home/private/gems
-<span class="nb">export </span><span class="nv">GEM_PATH</span><span class="o">=</span>/home/private/gems:/usr/local/lib/ruby/gems/1.8/
-<span class="nb">export </span><span class="nv">PATH</span><span class="o">=</span><span class="nv">$PATH</span>:/home/private/gems/bin
-<span class="nb">export </span><span class="nv">RB_USER_INSTALL</span><span class="o">=</span><span class="s1">'true'</span>
-</code></pre></div></div>
-<p>To install RubyGems on Gentoo:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>emerge <span class="nt">-av</span> dev-ruby/rubygems
-</code></pre></div></div>
-<p>On Windows, you may need to install <a href="https://wiki.github.com/oneclick/rubyinstaller/development-kit">RubyInstaller
-DevKit</a>.</p>
-<p>On Android (with Termux) you can install all requirements by running:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>apt update <span class="o">&amp;&amp;</span> apt install libffi-dev clang ruby-dev make
-</code></pre></div></div>
-<p>On macOS, you may need to update RubyGems (using <code class="highlighter-rouge">sudo</code> only if necessary):</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>gem update <span class="nt">--system</span>
-</code></pre></div></div>
-<p>If you still have issues, you can download and install new Command Line
-Tools (such as <code class="highlighter-rouge">gcc</code>) using the following command:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>xcode-select <span class="nt">--install</span>
-</code></pre></div></div>
-<p>which may allow you to install native gems using this command (again using
-<code class="highlighter-rouge">sudo</code> only if necessary):</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>gem install jekyll
-</code></pre></div></div>
-<p>Note that upgrading macOS does not automatically upgrade Xcode itself
-(that can be done separately via the App Store), and having an out-of-date
-Xcode.app can interfere with the command line tools downloaded above. If
-you run into this issue, upgrade Xcode and install the upgraded Command
-Line Tools.</p>
-<h3 id="jekyll--mac-os-x-1011">Jekyll &amp; Mac OS X 10.11</h3>
-<p>With the introduction of System Integrity Protection, several directories
-that were previously writable are now considered system locations and are no
-longer available. Given these changes, there are a couple of simple ways to get
-up and running. One option is to change the location where the gem will be
-installed (again using <code class="highlighter-rouge">sudo</code> only if necessary):</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>gem install <span class="nt">-n</span> /usr/local/bin jekyll
-</code></pre></div></div>
-<p>Alternatively, Homebrew can be installed and used to set up Ruby. This can be
-done as follows:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ruby <span class="nt">-e</span> <span class="s2">"</span><span class="k">$(</span>curl <span class="nt">-fsSL</span> https://raw.githubusercontent.com/Homebrew/install/master/install<span class="k">)</span><span class="s2">"</span>
-</code></pre></div></div>
-<p>Once Homebrew is installed, the second step is easy:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>brew install ruby
-</code></pre></div></div>
-<p>Advanced users (with more complex needs) may find it helpful to choose one of a
-number of Ruby version managers (<a href="https://rvm.io">RVM</a>, <a href="http://rbenv.org">rbenv</a>, <a href="https://github.com/postmodern/chruby">chruby</a>, <a href="https://github.com/rvm/rvm/blob/master/docs/alt.md">etc</a>.) in
-which to install Jekyll.</p>
-<p>If you elect to use one of the above methods to install Ruby, it might be
-necessary to modify your <code class="highlighter-rouge">$PATH</code> variable using the following command:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">export </span><span class="nv">PATH</span><span class="o">=</span>/usr/local/bin:<span class="nv">$PATH</span>
-</code></pre></div></div>
-<p>GUI apps can modify the <code class="highlighter-rouge">$PATH</code> as follows:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>launchctl setenv PATH <span class="s2">"/usr/local/bin:</span><span class="nv">$PATH</span><span class="s2">"</span>
-</code></pre></div></div>
-<p>Either of these approaches are useful because <code class="highlighter-rouge">/usr/local</code> is considered a
-“safe” location on systems which have SIP enabled, they avoid potential
-conflicts with the version of Ruby included by Apple, and it keeps Jekyll and
-its dependencies in a sandboxed environment. This also has the added
-benefit of not requiring <code class="highlighter-rouge">sudo</code> when you want to add or remove a gem.</p>
-<h3 id="could-not-find-a-javascript-runtime-execjsruntimeunavailable">Could not find a JavaScript runtime. (ExecJS::RuntimeUnavailable)</h3>
-<p>This error can occur during the installation of <code class="highlighter-rouge">jekyll-coffeescript</code> when
-you don’t have a proper JavaScript runtime. To solve this, either install
-<code class="highlighter-rouge">execjs</code> and <code class="highlighter-rouge">therubyracer</code> gems, or install <code class="highlighter-rouge">nodejs</code>. Check out
-<a href="https://github.com/jekyll/jekyll/issues/2327">issue #2327</a> for more info.</p>
-<h2 id="problems-running-jekyll">Problems running Jekyll</h2>
-<p>On Debian or Ubuntu, you may need to add <code class="highlighter-rouge">/var/lib/gems/1.8/bin/</code> to your path
-in order to have the <code class="highlighter-rouge">jekyll</code> executable be available in your Terminal.</p>
-<h2 id="base-url-problems">Base-URL Problems</h2>
-<p>If you are using base-url option like:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jekyll serve <span class="nt">--baseurl</span> <span class="s1">'/blog'</span>
-</code></pre></div></div>
-<p>… then make sure that you access the site at:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:4000/blog/index.html
-</code></pre></div></div>
-<p>It won’t work to just access:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:4000/blog
-</code></pre></div></div>
-<h2 id="configuration-problems">Configuration problems</h2>
-<p>The order of precedence for conflicting <a href="../configuration/">configuration settings</a>
-is as follows:</p>
-<ol>
-  <li>Command-line flags</li>
-  <li>Configuration file settings</li>
-  <li>Defaults</li>
-</ol>
-<p>That is: defaults are overridden by options specified in <code class="highlighter-rouge">_config.yml</code>,
-and flags specified at the command-line will override all other settings
-specified elsewhere.</p>
-<p><strong>Note: From v3.3.0 onward, Jekyll does not process <code class="highlighter-rouge">node_modules</code> and certain subdirectories within <code class="highlighter-rouge">vendor</code>, by default. But, by having an <code class="highlighter-rouge">exclude:</code> array defined explicitly in the config file overrides this default setting, which results in some users to encounter an error in building the site, with the following error message:</strong></p>
-<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>    ERROR: YOUR SITE COULD NOT BE BUILT:
-    ------------------------------------
-    Invalid date '&lt;%= Time.now.strftime('%Y-%m-%d %H:%M:%S %z') %&gt;':
-    Document 'vendor/bundle/gems/jekyll-3.4.3/lib/site_template/_posts/0000-00-00-welcome-to-jekyll.markdown.erb'
-    does not have a valid date in the YAML front matter.
-</code></pre></div></div>
-<p>Simply adding <code class="highlighter-rouge">vendor/bundle</code> to the <code class="highlighter-rouge">exclude:</code> list will solve this problem but will lead to having other sub-directories under <code class="highlighter-rouge">/vendor/</code> (and also <code class="highlighter-rouge">/node_modules/</code>, if present) be processed to the destination folder <code class="highlighter-rouge">_site</code>.</p>
-<p>The proper solution is to incorporate the default setting for <code class="highlighter-rouge">exclude:</code> rather than override it completely:</p>
-<p>For versions upto <code class="highlighter-rouge">v3.4.3</code>, the <code class="highlighter-rouge">exclude:</code> setting must look like following:</p>
-<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">exclude</span><span class="pi">:</span>
-  <span class="pi">-</span> <span class="s">Gemfile</span>
-  <span class="pi">-</span> <span class="s">Gemfile.lock</span>
-  <span class="pi">-</span> <span class="s">node_modules</span>
-  <span class="pi">-</span> <span class="s">vendor/bundle/</span>
-  <span class="pi">-</span> <span class="s">vendor/cache/</span>
-  <span class="pi">-</span> <span class="s">vendor/gems/</span>
-  <span class="pi">-</span> <span class="s">vendor/ruby/</span>
-  <span class="pi">-</span> <span class="s">any_additional_item</span> <span class="c1"># any user-specific listing goes at the end</span>
-</code></pre></div></div>
-<p>From <code class="highlighter-rouge">v3.5</code> onward, <code class="highlighter-rouge">Gemfile</code> and <code class="highlighter-rouge">Gemfile.lock</code> are also excluded by default. So, in most cases there is no need to define another <code class="highlighter-rouge">exclude:</code> array in the config file. So an existing definition can either be modified as above, or removed completely, or simply commented out to enable easy edits in future.</p>
-<h2 id="markup-problems">Markup Problems</h2>
-<p>The various markup engines that Jekyll uses may have some issues. This
-page will document them to help others who may run into the same
-problems.</p>
-<h3 id="liquid">Liquid</h3>
-<p>The latest version, version 2.0, seems to break the use of <code class="highlighter-rouge">{{</code> in
-templates. Unlike previous versions, using <code class="highlighter-rouge">{{</code> in 2.0 triggers the
-following error:</p>
-<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="s1">'{{'</span> was not properly terminated with regexp: /<span class="se">\}\}</span>/  <span class="o">(</span>Liquid::SyntaxError<span class="o">)</span>
-</code></pre></div></div>
-<h3 id="excerpts">Excerpts</h3>
-<p>Since v1.0.0, Jekyll has had automatically-generated post excerpts. Since
-v1.1.0, Jekyll also passes these excerpts through Liquid, which can cause
-strange errors where references don’t exist or a tag hasn’t been closed. If you
-run into these errors, try setting <code class="highlighter-rouge">excerpt_separator: ""</code> in your
-<code class="highlighter-rouge">_config.yml</code>, or set it to some nonsense string.</p>
-<h2 id="production-problems">Production Problems</h2>
-<p>If you run into an issue that a static file can’t be found in your
-production environment during build since v3.2.0 you should set your
-<a href="../configuration/#specifying-a-jekyll-environment-at-build-time">environment to <code class="highlighter-rouge">production</code></a>.
-The issue is caused by trying to copy a non-existing symlink.</p>
-<div class="note">
-  <h5>Please report issues you encounter!</h5>
-  <p>
-  If you come across a bug, please <a href="https://github.com/jekyll/jekyll-help/issues/new">create an issue</a>
-  on GitHub describing the problem and any work-arounds you find so we can
-  document it here for others.
-  </p>
-</div>
-    <div class="section-nav">
-      <div class="left align-right">
-            <a href="/docs/continuous-integration/" class="prev">Back</a>
-      </div>
-      <div class="right align-left">
-            <a href="/docs/sites/" class="next">Next</a>
-      </div>
-    </div>
-    <div class="clear"></div>
-        </article>
-      </div>
-      <div class="unit one-fifth hide-on-mobiles">
-  <aside>
-    <h4>Getting Started</h4>
-    <ul>
-  <li class=""><a href="/docs/home/">Welcome</a></li>
-  <li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
-  <li class=""><a href="/docs/installation/">Installation</a></li>
-  <li class=""><a href="/docs/windows/">Jekyll on Windows</a></li>
-  <li class=""><a href="/docs/usage/">Basic Usage</a></li>
-  <li class=""><a href="/docs/structure/">Directory structure</a></li>
-  <li class=""><a href="/docs/configuration/">Configuration</a></li>
-</ul>
-    <h4>Your Content</h4>
-    <ul>
-  <li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
-  <li class=""><a href="/docs/posts/">Writing posts</a></li>
-  <li class=""><a href="/docs/drafts/">Working with drafts</a></li>
-  <li class=""><a href="/docs/pages/">Creating pages</a></li>
-  <li class=""><a href="/docs/static-files/">Static Files</a></li>
-  <li class=""><a href="/docs/variables/">Variables</a></li>
-  <li class=""><a href="/docs/collections/">Collections</a></li>
-  <li class=""><a href="/docs/datafiles/">Data Files</a></li>
-  <li class=""><a href="/docs/assets/">Assets</a></li>
-  <li class=""><a href="/docs/migrations/">Blog migrations</a></li>
-</ul>
-    <h4>Customization</h4>
-    <ul>
-  <li class=""><a href="/docs/templates/">Templates</a></li>
-  <li class=""><a href="/docs/includes/">Includes</a></li>
-  <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
-  <li class=""><a href="/docs/pagination/">Pagination</a></li>
-  <li class=""><a href="/docs/plugins/">Plugins</a></li>
-  <li class=""><a href="/docs/themes/">Themes</a></li>
-  <li class=""><a href="/docs/extras/">Extras</a></li>
-</ul>
-    <h4>Deployment</h4>
-    <ul>
-  <li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
-  <li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
-  <li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
-</ul>
-    <h4>Miscellaneous</h4>
-    <ul>
-  <li class="current"><a href="/docs/troubleshooting/">Troubleshooting</a></li>
-  <li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
-  <li class=""><a href="/docs/resources/">Resources</a></li>
-  <li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
-  <li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
-</ul>
-    <h4>Meta</h4>
-    <ul>
-  <li class=""><a href="/docs/contributing/">Contributing</a></li>
-  <li class=""><a href="/docs/maintaining/">Maintaining Jekyll</a></li>
-  <li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
-  <li class=""><a href="/docs/history/">History</a></li>
-</ul>
-  </aside>
-</div>
-      <div class="clear"></div>
-    </div>
-  </section>
-  <footer>
-  <div class="grid">
-    <div class="unit one-third center-on-mobiles">
-      <p>The contents of this website are <br>© 2017 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
-    </div>
-    <div class="unit two-thirds align-right center-on-mobiles">
-      <p>
-        Proudly hosted by
-        <a href="https://github.com">
-          <img src="/img/footer-logo.png" width="100" height="30" alt="GitHub • Social coding">
-        </a>
-      </p>
-    </div>
-  </div>
-</footer>
-  <script>
-  var anchorForId = function (id) {
-    var anchor = document.createElement("a");
-    anchor.className = "header-link";
-    anchor.href      = "#" + id;
-    anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
-    anchor.title = "Permalink";
-    return anchor;
-  };
-  var linkifyAnchors = function (level, containingElement) {
-    var headers = containingElement.getElementsByTagName("h" + level);
-    for (var h = 0; h < headers.length; h++) {
-      var header = headers[h];
-      if (typeof header.id !== "undefined" && header.id !== "") {
-        header.appendChild(anchorForId(header.id));
-      }
-    }
-  };
-  document.onreadystatechange = function () {
-    if (this.readyState === "complete") {
-      var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
-      if (!contentBlock) {
-        return;
-      }
-      for (var level = 1; level <= 6; level++) {
-        linkifyAnchors(level, contentBlock);
-      }
-    }
-  };
-</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.parentNode.insertBefore(l,L)}(window,document,'script','ga');
-    ga('create', 'UA-50755011-1', 'jekyllrb.com');
-    ga('send', 'pageview');
-  </script>
-</body>
-</html>