jekyll-docs 3.5.2 → 3.6.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (127) hide show
  1. checksums.yaml +4 -4
  2. data/site/404.html +3 -3
  3. data/site/community/index.html +5 -5
  4. data/site/docs/assets/index.html +14 -22
  5. data/site/docs/code_of_conduct/index.html +730 -0
  6. data/site/docs/collections/index.html +65 -80
  7. data/site/docs/conduct/index.html +4 -4
  8. data/site/docs/configuration/index.html +130 -156
  9. data/site/docs/continuous-integration/buddyworks/index.html +14 -16
  10. data/site/docs/continuous-integration/circleci/index.html +13 -21
  11. data/site/docs/continuous-integration/index.html +5 -5
  12. data/site/docs/continuous-integration/travis-ci/index.html +45 -73
  13. data/site/docs/contributing/index.html +10 -10
  14. data/site/docs/datafiles/index.html +37 -53
  15. data/site/docs/deployment-methods/index.html +54 -64
  16. data/site/docs/drafts/index.html +6 -8
  17. data/site/docs/extras/index.html +8 -12
  18. data/site/docs/frontmatter/index.html +10 -14
  19. data/site/docs/github-pages/index.html +10 -14
  20. data/site/docs/history/index.html +539 -440
  21. data/site/docs/home/index.html +4 -4
  22. data/site/docs/includes/index.html +42 -70
  23. data/site/docs/installation/index.html +23 -37
  24. data/site/docs/maintaining/affinity-team-captain/index.html +4 -4
  25. data/site/docs/maintaining/avoiding-burnout/index.html +4 -4
  26. data/site/docs/maintaining/becoming-a-maintainer/index.html +4 -4
  27. data/site/docs/maintaining/index.html +4 -4
  28. data/site/docs/maintaining/merging-a-pull-request/index.html +6 -8
  29. data/site/docs/maintaining/reviewing-a-pull-request/index.html +4 -4
  30. data/site/docs/maintaining/special-labels/index.html +4 -4
  31. data/site/docs/maintaining/triaging-an-issue/index.html +4 -4
  32. data/site/docs/migrations/index.html +4 -4
  33. data/site/docs/pages/index.html +8 -12
  34. data/site/docs/pagination/index.html +13 -21
  35. data/site/docs/permalinks/index.html +43 -34
  36. data/site/docs/plugins/index.html +51 -79
  37. data/site/docs/posts/index.html +26 -48
  38. data/site/docs/quickstart/index.html +6 -8
  39. data/site/docs/resources/index.html +45 -21
  40. data/site/docs/sites/index.html +4 -4
  41. data/site/docs/static-files/index.html +12 -16
  42. data/site/docs/structure/index.html +6 -8
  43. data/site/docs/templates/index.html +36 -68
  44. data/site/docs/themes/index.html +32 -49
  45. data/site/docs/troubleshooting/index.html +44 -82
  46. data/site/docs/upgrading/0-to-2/index.html +7 -9
  47. data/site/docs/upgrading/2-to-3/index.html +19 -31
  48. data/site/docs/upgrading/index.html +4 -4
  49. data/site/docs/usage/index.html +20 -30
  50. data/site/docs/variables/index.html +26 -10
  51. data/site/docs/windows/index.html +36 -58
  52. data/site/feed.xml +47 -53
  53. data/site/help/index.html +3 -3
  54. data/site/index.html +3 -3
  55. data/site/latest_version.txt +1 -1
  56. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +16 -8
  57. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +16 -8
  58. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +16 -8
  59. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +16 -8
  60. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +16 -8
  61. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +16 -8
  62. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +16 -8
  63. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +16 -8
  64. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +16 -8
  65. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +16 -8
  66. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +16 -8
  67. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +16 -8
  68. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +16 -8
  69. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +16 -8
  70. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +16 -8
  71. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +16 -8
  72. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +16 -8
  73. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +16 -8
  74. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +16 -8
  75. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +16 -8
  76. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +16 -8
  77. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +16 -8
  78. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +16 -8
  79. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +16 -8
  80. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +16 -8
  81. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +16 -8
  82. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +16 -8
  83. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +16 -8
  84. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +16 -8
  85. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +16 -8
  86. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +16 -8
  87. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +16 -8
  88. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +16 -8
  89. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +17 -9
  90. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +16 -8
  91. data/site/news/2015/10/26/jekyll-3-0-released/index.html +16 -8
  92. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +16 -8
  93. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +16 -8
  94. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +16 -8
  95. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +16 -8
  96. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +16 -8
  97. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +16 -8
  98. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +16 -8
  99. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +20 -12
  100. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +16 -8
  101. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +16 -8
  102. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +16 -8
  103. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +16 -8
  104. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +16 -8
  105. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +16 -8
  106. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +16 -8
  107. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +16 -8
  108. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +16 -8
  109. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +16 -8
  110. data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +16 -8
  111. data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +16 -8
  112. data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +27 -29
  113. data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +23 -17
  114. data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +20 -14
  115. data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +21 -13
  116. data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +18 -10
  117. data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +573 -0
  118. data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +565 -0
  119. data/site/news/index.html +122 -48
  120. data/site/news/releases/index.html +122 -48
  121. data/site/sitemap.xml +64 -52
  122. data/site/tutorials/convert-site-to-jekyll/index.html +80 -138
  123. data/site/tutorials/custom-404-page/index.html +13 -21
  124. data/site/tutorials/home/index.html +4 -4
  125. data/site/tutorials/navigation/index.html +144 -180
  126. data/site/tutorials/orderofinterpretation/index.html +27 -45
  127. metadata +8 -5
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Themes | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Themes">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/themes/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Themes","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"Jekyll has an extensive theme system that allows you to leverage community-maintained templates and styles to customize your site’s presentation. Jekyll themes package up layouts, includes, and stylesheets in a way that can be overridden by your site’s content.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/themes/"},"url":"https://jekyllrb.com/docs/themes/"}</script>
28
+ {"name":null,"description":"Jekyll has an extensive theme system that allows you to leverage community-maintained templates and styles to customize your site’s presentation. Jekyll themes package up layouts, includes, and stylesheets in a way that can be overridden by your site’s content.","url":"https://jekyllrb.com/docs/themes/","headline":"Themes","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-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/themes/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -297,16 +297,14 @@
297
297
 
298
298
  <p>In the case of Minima, you see only the following files in your Jekyll site directory:</p>
299
299
 
300
- <div class="highlighter-rouge">
301
- <pre class="highlight"><code>├── Gemfile
300
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>├── Gemfile
302
301
  ├── Gemfile.lock
303
302
  ├── _config.yml
304
303
  ├── _posts
305
304
  │ └── 2016-12-04-welcome-to-jekyll.markdown
306
305
  ├── about.md
307
306
  └── index.md
308
- </code></pre>
309
- </div>
307
+ </code></pre></div></div>
310
308
 
311
309
  <p>The <code class="highlighter-rouge">Gemfile</code> and <code class="highlighter-rouge">Gemfile.lock</code> files are used by Bundler to keep track of the required gems and gem versions you need to build your Jekyll site.</p>
312
310
 
@@ -336,17 +334,16 @@
336
334
  <p>Open the theme’s directory in Finder or Explorer:</p>
337
335
 
338
336
  <div class="language-shell highlighter-rouge">
339
- <pre class="highlight"><code><span class="c"># On MacOS</span>
337
+ <div class="highlight"><pre class="highlight"><code><span class="c"># On MacOS</span>
340
338
  open <span class="k">$(</span>bundle show minima<span class="k">)</span>
341
339
  <span class="c"># On Windows</span>
342
340
  explorer /usr/local/lib/ruby/gems/2.3.0/gems/minima-2.1.0
343
- </code></pre>
344
- </div>
341
+ </code></pre></div> </div>
345
342
 
346
343
  <p>A Finder or Explorer window opens showing the theme’s files and directories. The Minima theme gem contains these files:</p>
347
344
 
348
345
  <div class="highlighter-rouge">
349
- <pre class="highlight"><code> ├── LICENSE.txt
346
+ <div class="highlight"><pre class="highlight"><code> ├── LICENSE.txt
350
347
  ├── README.md
351
348
  ├── _includes
352
349
  │   ├── disqus_comments.html
@@ -371,8 +368,7 @@ explorer /usr/local/lib/ruby/gems/2.3.0/gems/minima-2.1.0
371
368
  │   └── minima.scss
372
369
  └── assets
373
370
  └── main.scss
374
- </code></pre>
375
- </div>
371
+ </code></pre></div> </div>
376
372
  </li>
377
373
  </ol>
378
374
 
@@ -423,33 +419,29 @@ explorer /usr/local/lib/ruby/gems/2.3.0/gems/minima-2.1.0
423
419
  <p>Add the theme to your site’s <code class="highlighter-rouge">Gemfile</code>:</p>
424
420
 
425
421
  <div class="language-sh highlighter-rouge">
426
- <pre class="highlight"><code>gem <span class="s2">"jekyll-theme-awesome"</span>
427
- </code></pre>
428
- </div>
422
+ <div class="highlight"><pre class="highlight"><code>gem <span class="s2">"jekyll-theme-awesome"</span>
423
+ </code></pre></div> </div>
429
424
  </li>
430
425
  <li>
431
426
  <p>Install the theme:</p>
432
427
 
433
428
  <div class="language-sh highlighter-rouge">
434
- <pre class="highlight"><code>bundle install
435
- </code></pre>
436
- </div>
429
+ <div class="highlight"><pre class="highlight"><code>bundle install
430
+ </code></pre></div> </div>
437
431
  </li>
438
432
  <li>
439
433
  <p>Add the following to your site’s <code class="highlighter-rouge">_config.yml</code> to activate the theme:</p>
440
434
 
441
435
  <div class="language-sh highlighter-rouge">
442
- <pre class="highlight"><code>theme: jekyll-theme-awesome
443
- </code></pre>
444
- </div>
436
+ <div class="highlight"><pre class="highlight"><code>theme: jekyll-theme-awesome
437
+ </code></pre></div> </div>
445
438
  </li>
446
439
  <li>
447
440
  <p>Build your site:</p>
448
441
 
449
442
  <div class="language-sh highlighter-rouge">
450
- <pre class="highlight"><code>bundle <span class="nb">exec </span>jekyll serve
451
- </code></pre>
452
- </div>
443
+ <div class="highlight"><pre class="highlight"><code>bundle <span class="nb">exec </span>jekyll serve
444
+ </code></pre></div> </div>
453
445
  </li>
454
446
  </ol>
455
447
 
@@ -465,8 +457,7 @@ explorer /usr/local/lib/ruby/gems/2.3.0/gems/minima-2.1.0
465
457
 
466
458
  <p>Here is an example:</p>
467
459
 
468
- <div class="language-sh highlighter-rouge">
469
- <pre class="highlight"><code>jekyll new-theme jekyll-theme-awesome
460
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jekyll new-theme jekyll-theme-awesome
470
461
  create /path/to/jekyll-theme-awesome/_layouts
471
462
  create /path/to/jekyll-theme-awesome/_includes
472
463
  create /path/to/jekyll-theme-awesome/_sass
@@ -481,8 +472,7 @@ explorer /usr/local/lib/ruby/gems/2.3.0/gems/minima-2.1.0
481
472
  create /path/to/jekyll-theme-awesome/.gitignore
482
473
  Your new Jekyll theme, jekyll-theme-awesome, is ready <span class="k">for </span>you <span class="k">in</span> /path/to/jekyll-theme-awesome!
483
474
  For <span class="nb">help </span>getting started, <span class="nb">read</span> /path/to/jekyll-theme-awesome/README.md.
484
- </code></pre>
485
- </div>
475
+ </code></pre></div></div>
486
476
 
487
477
  <p>Add your template files in the corresponding folders. Then complete the <code class="highlighter-rouge">.gemspec</code> and the README files according to your needs.</p>
488
478
 
@@ -509,18 +499,14 @@ For <span class="nb">help </span>getting started, <span class="nb">read</span> /
509
499
 
510
500
  <p>Your theme’s stylesheets should be placed in your theme’s <code class="highlighter-rouge">_sass</code> folder, again, just as you would when authoring a Jekyll site.</p>
511
501
 
512
- <div class="highlighter-rouge">
513
- <pre class="highlight"><code>_sass
502
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>_sass
514
503
  ├── jekyll-theme-awesome.scss
515
- </code></pre>
516
- </div>
504
+ </code></pre></div></div>
517
505
 
518
506
  <p>Your theme’s styles can be included in the user’s stylesheet using the <code class="highlighter-rouge">@import</code> directive.</p>
519
507
 
520
- <div class="language-css highlighter-rouge">
521
- <pre class="highlight"><code><span class="k">@import</span> <span class="s1">"{{ site.theme }}"</span><span class="p">;</span>
522
- </code></pre>
523
- </div>
508
+ <div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">@import</span> <span class="s1">"{{ site.theme }}"</span><span class="p">;</span>
509
+ </code></pre></div></div>
524
510
 
525
511
  <h3 id="theme-gem-dependencies">Theme-gem dependencies</h3>
526
512
 
@@ -551,27 +537,24 @@ For <span class="nb">help </span>getting started, <span class="nb">read</span> /
551
537
  <p>First, you need to have it in a git repository:</p>
552
538
 
553
539
  <div class="language-sh highlighter-rouge">
554
- <pre class="highlight"><code>git init <span class="c"># Only the first time</span>
555
- git add -A
556
- git commit -m <span class="s2">"Init commit"</span>
557
- </code></pre>
558
- </div>
540
+ <div class="highlight"><pre class="highlight"><code>git init <span class="c"># Only the first time</span>
541
+ git add <span class="nt">-A</span>
542
+ git commit <span class="nt">-m</span> <span class="s2">"Init commit"</span>
543
+ </code></pre></div> </div>
559
544
  </li>
560
545
  <li>
561
546
  <p>Next, package your theme, by running the following command, replacing <code class="highlighter-rouge">jekyll-theme-awesome</code> with the name of your theme:</p>
562
547
 
563
548
  <div class="language-sh highlighter-rouge">
564
- <pre class="highlight"><code>gem build jekyll-theme-awesome.gemspec
565
- </code></pre>
566
- </div>
549
+ <div class="highlight"><pre class="highlight"><code>gem build jekyll-theme-awesome.gemspec
550
+ </code></pre></div> </div>
567
551
  </li>
568
552
  <li>
569
553
  <p>Finally, push your packaged theme up to the RubyGems service, by running the following command, again replacing <code class="highlighter-rouge">jekyll-theme-awesome</code> with the name of your theme:</p>
570
554
 
571
555
  <div class="language-sh highlighter-rouge">
572
- <pre class="highlight"><code>gem push jekyll-theme-awesome-<span class="k">*</span>.gem
573
- </code></pre>
574
- </div>
556
+ <div class="highlight"><pre class="highlight"><code>gem push jekyll-theme-awesome-<span class="k">*</span>.gem
557
+ </code></pre></div> </div>
575
558
  </li>
576
559
  <li>
577
560
  <p>To release a new version of your theme, update the version number in the gemspec file, ( <code class="highlighter-rouge">jekyll-theme-awesome.gemspec</code> in this example ), and then repeat Steps 1 - 3 above. We recommend that you follow <a href="http://semver.org/">Semantic Versioning</a> while bumping your theme-version.</p>
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Troubleshooting | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Troubleshooting">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/troubleshooting/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Troubleshooting","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","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.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/troubleshooting/"},"url":"https://jekyllrb.com/docs/troubleshooting/"}</script>
28
+ {"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-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-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>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -306,24 +306,18 @@ that might be of help. If the problem you’re experiencing isn’t covered belo
306
306
  the header files for compiling extension modules for Ruby 2.x This
307
307
  can be done on Ubuntu or Debian by running:</p>
308
308
 
309
- <div class="language-sh highlighter-rouge">
310
- <pre class="highlight"><code>sudo apt-get install ruby2.3-dev
311
- </code></pre>
312
- </div>
309
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>apt-get install ruby2.3-dev
310
+ </code></pre></div></div>
313
311
 
314
312
  <p>On Red Hat, CentOS, and Fedora systems you can do this by running:</p>
315
313
 
316
- <div class="language-sh highlighter-rouge">
317
- <pre class="highlight"><code>sudo yum install ruby-devel
318
- </code></pre>
319
- </div>
314
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>yum install ruby-devel
315
+ </code></pre></div></div>
320
316
 
321
317
  <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>
322
318
 
323
- <div class="language-sh highlighter-rouge">
324
- <pre class="highlight"><code>sudo dnf install redhat-rpm-config
325
- </code></pre>
326
- </div>
319
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>dnf install redhat-rpm-config
320
+ </code></pre></div></div>
327
321
 
328
322
  <p>On Ubuntu if you get stuck after <code class="highlighter-rouge">bundle exec jekyll serve</code> and see error
329
323
  messages like <code class="highlighter-rouge">Could not locate Gemfile</code> or <code class="highlighter-rouge">.bundle/ directory</code>, it’s likely
@@ -331,61 +325,47 @@ because all requirements have not been fully met. Recent stock Ubuntu
331
325
  distributions require the installation of both the <code class="highlighter-rouge">ruby</code> and <code class="highlighter-rouge">ruby-all-dev</code>
332
326
  packages:</p>
333
327
 
334
- <div class="language-sh highlighter-rouge">
335
- <pre class="highlight"><code>sudo apt-get install ruby ruby-all-dev
336
- </code></pre>
337
- </div>
328
+ <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
329
+ </code></pre></div></div>
338
330
 
339
331
  <p>On <a href="https://www.nearlyfreespeech.net/">NearlyFreeSpeech</a> you need to run the
340
332
  following commands before installing Jekyll:</p>
341
333
 
342
- <div class="language-sh highlighter-rouge">
343
- <pre class="highlight"><code><span class="nb">export </span><span class="nv">GEM_HOME</span><span class="o">=</span>/home/private/gems
334
+ <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
344
335
  <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/
345
336
  <span class="nb">export </span><span class="nv">PATH</span><span class="o">=</span><span class="nv">$PATH</span>:/home/private/gems/bin
346
337
  <span class="nb">export </span><span class="nv">RB_USER_INSTALL</span><span class="o">=</span><span class="s1">'true'</span>
347
- </code></pre>
348
- </div>
338
+ </code></pre></div></div>
349
339
 
350
340
  <p>To install RubyGems on Gentoo:</p>
351
341
 
352
- <div class="language-sh highlighter-rouge">
353
- <pre class="highlight"><code>sudo emerge -av dev-ruby/rubygems
354
- </code></pre>
355
- </div>
342
+ <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
343
+ </code></pre></div></div>
356
344
 
357
345
  <p>On Windows, you may need to install <a href="https://wiki.github.com/oneclick/rubyinstaller/development-kit">RubyInstaller
358
346
  DevKit</a>.</p>
359
347
 
360
348
  <p>On Android (with Termux) you can install all requirements by running:</p>
361
349
 
362
- <div class="language-sh highlighter-rouge">
363
- <pre class="highlight"><code>apt update <span class="o">&amp;&amp;</span> apt install libffi-dev clang ruby-dev make
364
- </code></pre>
365
- </div>
350
+ <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
351
+ </code></pre></div></div>
366
352
 
367
353
  <p>On macOS, you may need to update RubyGems (using <code class="highlighter-rouge">sudo</code> only if necessary):</p>
368
354
 
369
- <div class="language-sh highlighter-rouge">
370
- <pre class="highlight"><code>sudo gem update --system
371
- </code></pre>
372
- </div>
355
+ <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>
356
+ </code></pre></div></div>
373
357
 
374
358
  <p>If you still have issues, you can download and install new Command Line
375
359
  Tools (such as <code class="highlighter-rouge">gcc</code>) using the following command:</p>
376
360
 
377
- <div class="language-sh highlighter-rouge">
378
- <pre class="highlight"><code>xcode-select --install
379
- </code></pre>
380
- </div>
361
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>xcode-select <span class="nt">--install</span>
362
+ </code></pre></div></div>
381
363
 
382
364
  <p>which may allow you to install native gems using this command (again using
383
365
  <code class="highlighter-rouge">sudo</code> only if necessary):</p>
384
366
 
385
- <div class="language-sh highlighter-rouge">
386
- <pre class="highlight"><code>sudo gem install jekyll
387
- </code></pre>
388
- </div>
367
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>gem install jekyll
368
+ </code></pre></div></div>
389
369
 
390
370
  <p>Note that upgrading macOS does not automatically upgrade Xcode itself
391
371
  (that can be done separately via the App Store), and having an out-of-date
@@ -401,25 +381,19 @@ longer available. Given these changes, there are a couple of simple ways to get
401
381
  up and running. One option is to change the location where the gem will be
402
382
  installed (again using <code class="highlighter-rouge">sudo</code> only if necessary):</p>
403
383
 
404
- <div class="language-sh highlighter-rouge">
405
- <pre class="highlight"><code>sudo gem install -n /usr/local/bin jekyll
406
- </code></pre>
407
- </div>
384
+ <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
385
+ </code></pre></div></div>
408
386
 
409
387
  <p>Alternatively, Homebrew can be installed and used to set up Ruby. This can be
410
388
  done as follows:</p>
411
389
 
412
- <div class="language-sh highlighter-rouge">
413
- <pre class="highlight"><code>ruby -e <span class="s2">"</span><span class="k">$(</span>curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install<span class="k">)</span><span class="s2">"</span>
414
- </code></pre>
415
- </div>
390
+ <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>
391
+ </code></pre></div></div>
416
392
 
417
393
  <p>Once Homebrew is installed, the second step is easy:</p>
418
394
 
419
- <div class="language-sh highlighter-rouge">
420
- <pre class="highlight"><code>brew install ruby
421
- </code></pre>
422
- </div>
395
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>brew install ruby
396
+ </code></pre></div></div>
423
397
 
424
398
  <p>Advanced users (with more complex needs) may find it helpful to choose one of a
425
399
  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
@@ -428,17 +402,13 @@ which to install Jekyll.</p>
428
402
  <p>If you elect to use one of the above methods to install Ruby, it might be
429
403
  necessary to modify your <code class="highlighter-rouge">$PATH</code> variable using the following command:</p>
430
404
 
431
- <div class="language-sh highlighter-rouge">
432
- <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>
433
- </code></pre>
434
- </div>
405
+ <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>
406
+ </code></pre></div></div>
435
407
 
436
408
  <p>GUI apps can modify the <code class="highlighter-rouge">$PATH</code> as follows:</p>
437
409
 
438
- <div class="language-sh highlighter-rouge">
439
- <pre class="highlight"><code>launchctl setenv PATH <span class="s2">"/usr/local/bin:</span><span class="nv">$PATH</span><span class="s2">"</span>
440
- </code></pre>
441
- </div>
410
+ <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>
411
+ </code></pre></div></div>
442
412
 
443
413
  <p>Either of these approaches are useful because <code class="highlighter-rouge">/usr/local</code> is considered a
444
414
  “safe” location on systems which have SIP enabled, they avoid potential
@@ -462,24 +432,18 @@ in order to have the <code class="highlighter-rouge">jekyll</code> executable be
462
432
 
463
433
  <p>If you are using base-url option like:</p>
464
434
 
465
- <div class="language-sh highlighter-rouge">
466
- <pre class="highlight"><code>jekyll serve --baseurl <span class="s1">'/blog'</span>
467
- </code></pre>
468
- </div>
435
+ <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>
436
+ </code></pre></div></div>
469
437
 
470
438
  <p>… then make sure that you access the site at:</p>
471
439
 
472
- <div class="language-sh highlighter-rouge">
473
- <pre class="highlight"><code>http://localhost:4000/blog/index.html
474
- </code></pre>
475
- </div>
440
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:4000/blog/index.html
441
+ </code></pre></div></div>
476
442
 
477
443
  <p>It won’t work to just access:</p>
478
444
 
479
- <div class="language-sh highlighter-rouge">
480
- <pre class="highlight"><code>http://localhost:4000/blog
481
- </code></pre>
482
- </div>
445
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:4000/blog
446
+ </code></pre></div></div>
483
447
 
484
448
  <h2 id="configuration-problems">Configuration problems</h2>
485
449
 
@@ -509,14 +473,12 @@ problems.</p>
509
473
 
510
474
  <h3 id="liquid">Liquid</h3>
511
475
 
512
- <p>The latest version, version 2.0, seems to break the use of <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span></code> in
513
- templates. Unlike previous versions, using <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span></code> in 2.0 triggers the
476
+ <p>The latest version, version 2.0, seems to break the use of <code class="highlighter-rouge">{{</code> in
477
+ templates. Unlike previous versions, using <code class="highlighter-rouge">{{</code> in 2.0 triggers the
514
478
  following error:</p>
515
479
 
516
- <div class="language-sh highlighter-rouge">
517
- <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>
518
- </code></pre>
519
- </div>
480
+ <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>
481
+ </code></pre></div></div>
520
482
 
521
483
  <h3 id="excerpts">Excerpts</h3>
522
484
 
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Upgrading from 0.x to 2.x | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Upgrading from 0.x to 2.x">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/docs/upgrading/0-to-2/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Upgrading from 0.x to 2.x","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","description":"Upgrading from an older version of Jekyll? A few things have changed in 1.0 and 2.0 that you’ll want to know about.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/upgrading/0-to-2/"},"url":"https://jekyllrb.com/docs/upgrading/0-to-2/"}</script>
28
+ {"name":null,"description":"Upgrading from an older version of Jekyll? A few things have changed in 1.0 and 2.0 that you’ll want to know about.","url":"https://jekyllrb.com/docs/upgrading/0-to-2/","headline":"Upgrading from 0.x to 2.x","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-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/upgrading/0-to-2/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -292,10 +292,8 @@ and 2.0 that you’ll want to know about.</p>
292
292
 
293
293
  <p>Before we dive in, go ahead and fetch the latest version of Jekyll:</p>
294
294
 
295
- <div class="language-sh highlighter-rouge">
296
- <pre class="highlight"><code><span class="gp">$ </span>gem update jekyll
297
- </code></pre>
298
- </div>
295
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>gem update jekyll
296
+ </code></pre></div></div>
299
297
 
300
298
  <div class="note feature">
301
299
  <h5>Diving in</h5>
@@ -413,7 +411,7 @@ such as previewing locally before pushing to GitHub Pages. Jekyll 1.0 makes
413
411
  that easier with the new <code class="highlighter-rouge">--baseurl</code> flag. To take advantage of this
414
412
  feature, first add the production <code class="highlighter-rouge">baseurl</code> to your site’s <code class="highlighter-rouge">_config.yml</code>
415
413
  file. Then, throughout the site, simply prefix relative URLs
416
- with <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">site.baseurl</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></code>.
414
+ with <code class="highlighter-rouge">{{ site.baseurl }}</code>.
417
415
  When you’re ready to preview your site locally, pass along the <code class="highlighter-rouge">--baseurl</code>
418
416
  flag with your local baseurl (most likely <code class="highlighter-rouge">/</code>) to <code class="highlighter-rouge">jekyll serve</code> and Jekyll
419
417
  will swap in whatever you’ve passed along, ensuring all your links work as