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/github-pages/index.html DELETED Viewed

@@ -1,819 +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>GitHub Pages | Jekyll • Simple, blog-aware, static sites</title>
-<meta property="og:title" content="GitHub Pages">
-<meta property="og:locale" content="en_US">
-<meta name="description" content="GitHub Pages are public web pages for users, organizations, and repositories, that are freely hosted on GitHub’s github.io domain or on a custom domain name of your choice. GitHub Pages are powered by Jekyll behind the scenes, so in addition to supporting regular HTML content, they’re also a great way to host your Jekyll-powered website for free.">
-<meta property="og:description" content="GitHub Pages are public web pages for users, organizations, and repositories, that are freely hosted on GitHub’s github.io domain or on a custom domain name of your choice. GitHub Pages are powered by Jekyll behind the scenes, so in addition to supporting regular HTML content, they’re also a great way to host your Jekyll-powered website for free.">
-<link rel="canonical" href="https://jekyllrb.com/docs/github-pages/">
-<meta property="og:url" content="https://jekyllrb.com/docs/github-pages/">
-<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
-<meta property="og:type" content="article">
-<meta property="article:published_time" content="2017-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":"GitHub Pages are public web pages for users, organizations, and repositories, that are freely hosted on GitHub’s github.io domain or on a custom domain name of your choice. GitHub Pages are powered by Jekyll behind the scenes, so in addition to supporting regular HTML content, they’re also a great way to host your Jekyll-powered website for free.","url":"https://jekyllrb.com/docs/github-pages/","headline":"GitHub Pages","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/github-pages/"},"@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/github-pages.md"><i class="fa fa-pencil"></i>  Improve this page</a>
-          </div>
-          <h1>GitHub Pages</h1>
-          <p><a href="https://pages.github.com">GitHub Pages</a> are public web pages for users,
-organizations, and repositories, that are freely hosted on GitHub’s
-<code class="highlighter-rouge">github.io</code> domain or on a custom domain name of your choice. GitHub Pages are
-powered by Jekyll behind the scenes, so in addition to supporting regular HTML
-content, they’re also a great way to host your Jekyll-powered website for free.</p>
-<p>Never built a website with GitHub Pages before? <a href="http://jmcglone.com/guides/github-pages/">See this marvelous guide by
-Jonathan McGlone to get you up and running</a>.
-This guide will teach you what you need to know about Git, GitHub, and Jekyll to create your very own website on GitHub Pages.</p>
-<h3 id="project-page-url-structure">Project Page URL Structure</h3>
-<p>Sometimes it’s nice to preview your Jekyll site before you push your <code class="highlighter-rouge">gh-pages</code>
-branch to GitHub. However, the subdirectory-like URL structure GitHub uses for
-Project Pages complicates the proper resolution of URLs. In order to assure your site builds properly, use <code class="highlighter-rouge">site.github.url</code> in your URLs.</p>
-<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
-<span class="c">&lt;!-- Useful for styles with static names... --&gt;</span>
-<span class="nt">&lt;link</span> <span class="na">href=</span><span class="s">"{{ site.github.url }}/path/to/css.css"</span> <span class="na">rel=</span><span class="s">"stylesheet"</span><span class="nt">&gt;</span>
-<span class="c">&lt;!-- and for documents/pages whose URLs can change... --&gt;</span>
-[{{ page.title }}]("{{ page.url | prepend: site.github.url }}")
-</code></pre></div></div>
-<p>This way you can preview your site locally from the site root on localhost,
-but when GitHub generates your pages from the gh-pages branch all the URLs
-will resolve properly.</p>
-<h2 id="deploying-jekyll-to-github-pages">Deploying Jekyll to GitHub Pages</h2>
-<p>GitHub Pages work by looking at certain branches of repositories on GitHub.
-There are two basic types available: user/organization pages and project pages.
-The way to deploy these two types of sites are nearly identical, except for a
-few minor details.</p>
-<div class="note protip">
-  <div></div>
-  <h5 id="use-the-github-pages-gem">Use the <code class="highlighter-rouge">github-pages</code> gem</h5>
-  <p>Our friends at GitHub have provided the
-<a href="https://github.com/github/pages-gem">github-pages</a>
-gem which is used to manage Jekyll and its dependencies on
-GitHub Pages. Using it in your projects means that when you deploy
-your site to GitHub Pages, you will not be caught by unexpected
-differences between various versions of the gems. To use the
-currently-deployed version of the gem in your project, add the
-following to your <code class="highlighter-rouge">Gemfile</code>:</p>
-  <div class="code-block">
-    <div></div>
-    <div class="language-ruby highlighter-rouge">
-<div class="highlight"><pre class="highlight"><code><span class="n">source</span> <span class="s1">'https://rubygems.org'</span>
-<span class="nb">require</span> <span class="s1">'json'</span>
-<span class="nb">require</span> <span class="s1">'open-uri'</span>
-<span class="n">versions</span> <span class="o">=</span> <span class="no">JSON</span><span class="p">.</span><span class="nf">parse</span><span class="p">(</span><span class="nb">open</span><span class="p">(</span><span class="s1">'https://pages.github.com/versions.json'</span><span class="p">).</span><span class="nf">read</span><span class="p">)</span>
-<span class="n">gem</span> <span class="s1">'github-pages'</span><span class="p">,</span> <span class="n">versions</span><span class="p">[</span><span class="s1">'github-pages'</span><span class="p">]</span>
-</code></pre></div>    </div>
-  </div>
-  <p>This will ensure that when you run <code class="highlighter-rouge">bundle install</code>, you
-have the correct version of the <code class="highlighter-rouge">github-pages</code> gem.</p>
-  <p>If that fails, simplify it:</p>
-  <div class="code-block">
-    <div></div>
-    <div class="language-ruby highlighter-rouge">
-<div class="highlight"><pre class="highlight"><code><span class="n">source</span> <span class="s1">'https://rubygems.org'</span>
-<span class="n">gem</span> <span class="s1">'github-pages'</span>
-</code></pre></div>    </div>
-  </div>
-  <p>And be sure to run <code class="highlighter-rouge">bundle update</code> often.</p>
-  <p>If you like to install <code class="highlighter-rouge">pages-gem</code> on Windows you can find instructions by Jens Willmer on
-<a href="https://jwillmer.de/blog/tutorial/how-to-install-jekyll-and-pages-gem-on-windows-10-x46#github-pages-and-plugins">how to install github-pages gem on Windows (x64)</a>.</p>
-</div>
-<div class="note info">
-  <h5>Installing <code>github-pages</code> gem on Windows</h5>
-  <p>
-    While Windows is not officially supported, it is possible
-    to install <code>github-pages</code> gem on Windows.
-    Special instructions can be found on our
-    <a href="../windows/#installation">Windows-specific docs page</a>.
-  </p>
-</div>
-<h3 id="user-and-organization-pages">User and Organization Pages</h3>
-<p>User and organization pages live in a special GitHub repository dedicated to
-only the GitHub Pages files. This repository must be named after the account
-name. For example, <a href="https://github.com/mojombo/mojombo.github.io">@mojombo’s user page repository</a> has the name
-<code class="highlighter-rouge">mojombo.github.io</code>.</p>
-<p>Content from the <code class="highlighter-rouge">master</code> branch of your repository will be used to build and
-publish the GitHub Pages site, so make sure your Jekyll site is stored there.</p>
-<div class="note info">
-  <h5>Custom domains do not affect repository names</h5>
-  <p>
-    GitHub Pages are initially configured to live under the
-    <code>username.github.io</code> subdomain, which is why repositories must
-    be named this way <strong>even if a custom domain is being used</strong>.
-  </p>
-</div>
-<h3 id="project-pages">Project Pages</h3>
-<p>Unlike user and organization Pages, Project Pages are kept in the same
-repository as the project they are for, except that the website content is
-stored in a specially named <code class="highlighter-rouge">gh-pages</code> branch or in a <code class="highlighter-rouge">docs</code> folder on the
-<code class="highlighter-rouge">master</code> branch. The content will be rendered using Jekyll, and the output
-will become available under a subpath of your user pages subdomain, such as
-<code class="highlighter-rouge">username.github.io/project</code> (unless a custom domain is specified).</p>
-<p>The Jekyll project repository itself is a perfect example of this branch
-structure—the <a href="https://github.com/jekyll/jekyll">master branch</a> contains the
-actual software project for Jekyll, and the Jekyll website that you’re
-looking at right now is contained in the <a href="https://github.com/jekyll/jekyll/tree/master/docs">docs
-folder</a> of the same repository.</p>
-<p>Please refer to GitHub official documentation on
-<a href="https://help.github.com/articles/user-organization-and-project-pages/">user, organization and project pages</a>
-to see more detailed examples.</p>
-<div class="note warning">
-  <h5>Source Files Must be in the Root Directory</h5>
-  <p>
-    GitHub Pages <a href="https://help.github.com/articles/troubleshooting-github-pages-build-failures#source-setting">overrides</a>
-    the <a href="/docs/configuration/#global-configuration">“Site Source”</a>
-    configuration value, so if you locate your files anywhere other than the
-    root directory, your site may not build correctly.
-  </p>
-</div>
-<div class="note">
-  <h5>GitHub Pages Documentation, Help, and Support</h5>
-  <p>
-    For more information about what you can do with GitHub Pages, as well as for
-    troubleshooting guides, you should check out
-    <a href="https://help.github.com/categories/github-pages-basics/">GitHub’s Pages Help section</a>.
-    If all else fails, you should contact <a href="https://github.com/contact">GitHub Support</a>.
-  </p>
-</div>
-    <div class="section-nav">
-      <div class="left align-right">
-            <a href="/docs/extras/" class="prev">Back</a>
-      </div>
-      <div class="right align-left">
-            <a href="/docs/deployment-methods/" 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="current"><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=""><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>