jekyll-docs 3.3.1 → 3.4.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (125) 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/css/screen.css +7 -6
  5. data/site/docs/assets/index.html +13 -5
  6. data/site/docs/collections/index.html +132 -29
  7. data/site/docs/conduct/index.html +16 -5
  8. data/site/docs/configuration/index.html +26 -8
  9. data/site/docs/continuous-integration/circleci/index.html +761 -0
  10. data/site/docs/continuous-integration/index.html +25 -245
  11. data/site/docs/continuous-integration/travis-ci/index.html +916 -0
  12. data/site/docs/contributing/index.html +41 -5
  13. data/site/docs/datafiles/index.html +14 -6
  14. data/site/docs/deployment-methods/index.html +17 -7
  15. data/site/docs/drafts/index.html +13 -5
  16. data/site/docs/extras/index.html +17 -6
  17. data/site/docs/frontmatter/index.html +13 -5
  18. data/site/docs/github-pages/index.html +68 -47
  19. data/site/docs/history/index.html +132 -9
  20. data/site/docs/home/index.html +13 -5
  21. data/site/docs/includes/index.html +824 -0
  22. data/site/docs/installation/index.html +16 -6
  23. data/site/docs/maintaining/affinity-team-captain/index.html +16 -5
  24. data/site/docs/maintaining/avoiding-burnout/index.html +16 -5
  25. data/site/docs/maintaining/becoming-a-maintainer/index.html +17 -6
  26. data/site/docs/maintaining/index.html +16 -5
  27. data/site/docs/maintaining/merging-a-pull-request/index.html +21 -6
  28. data/site/docs/maintaining/reviewing-a-pull-request/index.html +16 -5
  29. data/site/docs/maintaining/special-labels/index.html +16 -5
  30. data/site/docs/maintaining/triaging-an-issue/index.html +16 -5
  31. data/site/docs/migrations/index.html +13 -5
  32. data/site/docs/pages/index.html +33 -50
  33. data/site/docs/pagination/index.html +16 -5
  34. data/site/docs/permalinks/index.html +148 -66
  35. data/site/docs/plugins/index.html +39 -14
  36. data/site/docs/posts/index.html +32 -5
  37. data/site/docs/quickstart/index.html +57 -18
  38. data/site/docs/resources/index.html +21 -10
  39. data/site/docs/sites/index.html +18 -7
  40. data/site/docs/static-files/index.html +15 -7
  41. data/site/docs/structure/index.html +47 -32
  42. data/site/docs/templates/index.html +85 -89
  43. data/site/docs/themes/index.html +214 -63
  44. data/site/docs/troubleshooting/index.html +16 -5
  45. data/site/docs/upgrading/0-to-2/index.html +16 -5
  46. data/site/docs/upgrading/2-to-3/index.html +17 -6
  47. data/site/docs/upgrading/index.html +16 -5
  48. data/site/docs/usage/index.html +21 -6
  49. data/site/docs/variables/index.html +14 -6
  50. data/site/docs/windows/index.html +35 -10
  51. data/site/feed.xml +41 -22
  52. data/site/fonts/FontAwesome.eot +0 -0
  53. data/site/fonts/FontAwesome.svg +12 -0
  54. data/site/fonts/FontAwesome.ttf +0 -0
  55. data/site/fonts/FontAwesome.woff +0 -0
  56. data/site/help/index.html +3 -3
  57. data/site/icomoon-selection.json +96 -0
  58. data/site/index.html +3 -3
  59. data/site/latest_version.txt +1 -1
  60. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +12 -8
  61. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +11 -7
  62. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +11 -7
  63. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +11 -7
  64. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +11 -7
  65. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +12 -8
  66. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +11 -7
  67. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +11 -7
  68. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +11 -7
  69. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +11 -7
  70. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +11 -7
  71. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +11 -7
  72. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +11 -7
  73. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +11 -7
  74. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +11 -7
  75. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +11 -7
  76. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +11 -7
  77. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +11 -7
  78. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +11 -7
  79. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +11 -7
  80. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +11 -7
  81. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +12 -8
  82. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +12 -8
  83. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +11 -7
  84. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +11 -7
  85. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +11 -7
  86. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +11 -7
  87. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +11 -7
  88. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +11 -7
  89. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +11 -7
  90. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +12 -8
  91. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +11 -7
  92. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +11 -7
  93. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +11 -7
  94. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +11 -7
  95. data/site/news/2015/10/26/jekyll-3-0-released/index.html +11 -7
  96. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +11 -7
  97. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +11 -7
  98. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +11 -7
  99. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +11 -7
  100. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +11 -7
  101. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +11 -7
  102. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +11 -7
  103. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +11 -7
  104. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +11 -8
  105. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +11 -7
  106. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +11 -7
  107. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +11 -7
  108. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +11 -7
  109. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +11 -7
  110. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +11 -7
  111. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +11 -7
  112. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +12 -8
  113. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +12 -8
  114. data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +11 -7
  115. data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +570 -0
  116. data/site/news/index.html +81 -15
  117. data/site/news/releases/index.html +78 -12
  118. data/site/readme.md +9 -2
  119. data/site/sitemap.xml +59 -43
  120. metadata +14 -10
  121. data/site/fonts/fontawesome-webfont.eot +0 -0
  122. data/site/fonts/fontawesome-webfont.svg +0 -640
  123. data/site/fonts/fontawesome-webfont.ttf +0 -0
  124. data/site/fonts/fontawesome-webfont.woff +0 -0
  125. data/site/fonts/fontawesome-webfont.woff2 +0 -0
@@ -4,7 +4,7 @@
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.3.1">
7
+ <meta name="generator" content="Jekyll v3.4.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">
@@ -19,7 +19,7 @@
19
19
  <meta property="og:url" content="https://jekyllrb.com/docs/upgrading/0-to-2/">
20
20
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
21
21
  <meta property="og:type" content="article">
22
- <meta property="article:published_time" content="2017-01-20T13:17:57-08:00">
22
+ <meta property="article:published_time" content="2017-03-22T08:06:48-07:00">
23
23
  <meta name="twitter:card" content="summary">
24
24
  <meta name="twitter:site" content="@jekyllrb">
25
25
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
@@ -27,7 +27,7 @@
27
27
  {"@context": "http://schema.org",
28
28
  "@type": "BlogPosting",
29
29
  "headline": "Upgrading from 0.x to 2.x",
30
- "datePublished": "2017-01-20T13:17:57-08:00",
30
+ "datePublished": "2017-03-22T08:06:48-07:00",
31
31
  "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.",
32
32
  "publisher": {"@type": "Organization",
33
33
  "logo": {"@type": "ImageObject",
@@ -192,6 +192,10 @@
192
192
 
193
193
 
194
194
 
195
+ <option value="/docs/includes/">Includes</option>
196
+
197
+
198
+
195
199
  <option value="/docs/permalinks/">Permalinks</option>
196
200
 
197
201
 
@@ -517,6 +521,9 @@ you’d expect in both environments.</p>
517
521
 
518
522
 
519
523
 
524
+
525
+
526
+
520
527
 
521
528
 
522
529
 
@@ -630,6 +637,10 @@ you’d expect in both environments.</p>
630
637
 
631
638
 
632
639
 
640
+ <li class=""><a href="/docs/includes/">Includes</a></li>
641
+
642
+
643
+
633
644
  <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
634
645
 
635
646
 
@@ -778,7 +789,7 @@ you’d expect in both environments.</p>
778
789
  </script>
779
790
 
780
791
 
781
- <!-- Gauges (http://gaug.es/) -->
792
+ <!-- Gauges (http://get.gaug.es/) -->
782
793
  <script>
783
794
  var _gauges = _gauges || [];
784
795
  (function() {
@@ -795,7 +806,7 @@ you’d expect in both environments.</p>
795
806
 
796
807
 
797
808
 
798
- <!-- Google Analytics (http://google.com/analytics) -->
809
+ <!-- Google Analytics (https://www.google.com/analytics) -->
799
810
  <script>
800
811
  !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
801
812
  (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
@@ -4,7 +4,7 @@
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.3.1">
7
+ <meta name="generator" content="Jekyll v3.4.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">
@@ -19,7 +19,7 @@
19
19
  <meta property="og:url" content="https://jekyllrb.com/docs/upgrading/2-to-3/">
20
20
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
21
21
  <meta property="og:type" content="article">
22
- <meta property="article:published_time" content="2017-01-20T13:17:57-08:00">
22
+ <meta property="article:published_time" content="2017-03-22T08:06:48-07:00">
23
23
  <meta name="twitter:card" content="summary">
24
24
  <meta name="twitter:site" content="@jekyllrb">
25
25
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
@@ -27,7 +27,7 @@
27
27
  {"@context": "http://schema.org",
28
28
  "@type": "BlogPosting",
29
29
  "headline": "Upgrading from 2.x to 3.x",
30
- "datePublished": "2017-01-20T13:17:57-08:00",
30
+ "datePublished": "2017-03-22T08:06:48-07:00",
31
31
  "description": "Upgrading from an older version of Jekyll? A few things have changed in 3.0 that you’ll want to know about.",
32
32
  "publisher": {"@type": "Organization",
33
33
  "logo": {"@type": "ImageObject",
@@ -192,6 +192,10 @@
192
192
 
193
193
 
194
194
 
195
+ <option value="/docs/includes/">Includes</option>
196
+
197
+
198
+
195
199
  <option value="/docs/permalinks/">Permalinks</option>
196
200
 
197
201
 
@@ -393,7 +397,7 @@ error when trying to <strong>serve</strong> or <strong>build</strong>:</p>
393
397
  <div class="language-text highlighter-rouge">
394
398
  <pre class="highlight"><code>Since v3.0, permalinks for pages in subfolders must be relative to the site
395
399
  source directory, not the parent directory. Check
396
- http://jekyllrb.com/docs/upgrading/ for more info.
400
+ https://jekyllrb.com/docs/upgrading/ for more info.
397
401
  </code></pre>
398
402
  </div>
399
403
 
@@ -525,6 +529,9 @@ http://jekyllrb.com/docs/upgrading/ for more info.
525
529
 
526
530
 
527
531
 
532
+
533
+
534
+
528
535
 
529
536
 
530
537
 
@@ -638,6 +645,10 @@ http://jekyllrb.com/docs/upgrading/ for more info.
638
645
 
639
646
 
640
647
 
648
+ <li class=""><a href="/docs/includes/">Includes</a></li>
649
+
650
+
651
+
641
652
  <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
642
653
 
643
654
 
@@ -786,7 +797,7 @@ http://jekyllrb.com/docs/upgrading/ for more info.
786
797
  </script>
787
798
 
788
799
 
789
- <!-- Gauges (http://gaug.es/) -->
800
+ <!-- Gauges (http://get.gaug.es/) -->
790
801
  <script>
791
802
  var _gauges = _gauges || [];
792
803
  (function() {
@@ -803,7 +814,7 @@ http://jekyllrb.com/docs/upgrading/ for more info.
803
814
 
804
815
 
805
816
 
806
- <!-- Google Analytics (http://google.com/analytics) -->
817
+ <!-- Google Analytics (https://www.google.com/analytics) -->
807
818
  <script>
808
819
  !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
809
820
  (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
@@ -4,7 +4,7 @@
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.3.1">
7
+ <meta name="generator" content="Jekyll v3.4.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">
@@ -19,7 +19,7 @@
19
19
  <meta property="og:url" content="https://jekyllrb.com/docs/upgrading/">
20
20
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
21
21
  <meta property="og:type" content="article">
22
- <meta property="article:published_time" content="2017-01-20T13:17:57-08:00">
22
+ <meta property="article:published_time" content="2017-03-22T08:06:48-07:00">
23
23
  <meta name="twitter:card" content="summary">
24
24
  <meta name="twitter:site" content="@jekyllrb">
25
25
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
@@ -27,7 +27,7 @@
27
27
  {"@context": "http://schema.org",
28
28
  "@type": "BlogPosting",
29
29
  "headline": "Upgrading",
30
- "datePublished": "2017-01-20T13:17:57-08:00",
30
+ "datePublished": "2017-03-22T08:06:48-07:00",
31
31
  "description": "Upgrading from an older version of Jekyll? Upgrading to a new major version of Jekyll (e.g. from v2.x to v3.x) may cause some headaches. Take the following guides to aid your upgrade:",
32
32
  "publisher": {"@type": "Organization",
33
33
  "logo": {"@type": "ImageObject",
@@ -192,6 +192,10 @@
192
192
 
193
193
 
194
194
 
195
+ <option value="/docs/includes/">Includes</option>
196
+
197
+
198
+
195
199
  <option value="/docs/permalinks/">Permalinks</option>
196
200
 
197
201
 
@@ -397,6 +401,9 @@
397
401
 
398
402
 
399
403
 
404
+
405
+
406
+
400
407
 
401
408
 
402
409
 
@@ -492,6 +499,10 @@
492
499
 
493
500
 
494
501
 
502
+ <li class=""><a href="/docs/includes/">Includes</a></li>
503
+
504
+
505
+
495
506
  <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
496
507
 
497
508
 
@@ -640,7 +651,7 @@
640
651
  </script>
641
652
 
642
653
 
643
- <!-- Gauges (http://gaug.es/) -->
654
+ <!-- Gauges (http://get.gaug.es/) -->
644
655
  <script>
645
656
  var _gauges = _gauges || [];
646
657
  (function() {
@@ -657,7 +668,7 @@
657
668
 
658
669
 
659
670
 
660
- <!-- Google Analytics (http://google.com/analytics) -->
671
+ <!-- Google Analytics (https://www.google.com/analytics) -->
661
672
  <script>
662
673
  !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
663
674
  (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
@@ -4,7 +4,7 @@
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.3.1">
7
+ <meta name="generator" content="Jekyll v3.4.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">
@@ -19,7 +19,7 @@
19
19
  <meta property="og:url" content="https://jekyllrb.com/docs/usage/">
20
20
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
21
21
  <meta property="og:type" content="article">
22
- <meta property="article:published_time" content="2017-01-20T13:17:57-08:00">
22
+ <meta property="article:published_time" content="2017-03-22T08:06:48-07:00">
23
23
  <meta name="twitter:card" content="summary">
24
24
  <meta name="twitter:site" content="@jekyllrb">
25
25
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
@@ -27,7 +27,7 @@
27
27
  {"@context": "http://schema.org",
28
28
  "@type": "BlogPosting",
29
29
  "headline": "Basic Usage",
30
- "datePublished": "2017-01-20T13:17:57-08:00",
30
+ "datePublished": "2017-03-22T08:06:48-07:00",
31
31
  "description": "The Jekyll gem makes a jekyll executable available to you in your Terminal window. You can use this command in a number of ways:",
32
32
  "publisher": {"@type": "Organization",
33
33
  "logo": {"@type": "ImageObject",
@@ -192,6 +192,10 @@
192
192
 
193
193
 
194
194
 
195
+ <option value="/docs/includes/">Includes</option>
196
+
197
+
198
+
195
199
  <option value="/docs/permalinks/">Permalinks</option>
196
200
 
197
201
 
@@ -343,7 +347,7 @@ preview what the generated site will look like in your browser locally.</p>
343
347
  <span class="gp">$ </span>jekyll serve --detach
344
348
  <span class="c"># =&gt; Same as `jekyll serve` but will detach from the current terminal.</span>
345
349
  <span class="c"># If you need to kill the server, you can `kill -9 1234` where "1234" is the PID.</span>
346
- <span class="c"># If you cannot find the PID, then do, `ps aux | grep jekyll` and kill the instance. [Read more](http://unixhelp.ed.ac.uk/shell/jobz5.html).</span>
350
+ <span class="c"># If you cannot find the PID, then do, `ps aux | grep jekyll` and kill the instance.</span>
347
351
  </code></pre>
348
352
  </div>
349
353
 
@@ -384,6 +388,13 @@ in your <code class="highlighter-rouge">_config.yml</code> file:</p>
384
388
  <p>For more about the possible configuration options, see the
385
389
  <a href="../configuration/">configuration</a> page.</p>
386
390
 
391
+ <div class="note info">
392
+ <h5>Call for help</h5>
393
+ <p>
394
+ The <code>help</code> command is always here to remind you of all available options and usage, and also works with the <code>build</code>, <code>serve</code> and <code>new</code> subcommands, e.g <code>jekyll help new</code> or <code>jekyll help build</code>.
395
+ </p>
396
+ </div>
397
+
387
398
  <p>If you’re interested in browsing these docs on-the-go, install the
388
399
  <code class="highlighter-rouge">jekyll-docs</code> gem and run <code class="highlighter-rouge">jekyll docs</code> in your terminal.</p>
389
400
 
@@ -513,6 +524,10 @@ in your <code class="highlighter-rouge">_config.yml</code> file:</p>
513
524
 
514
525
 
515
526
 
527
+ <li class=""><a href="/docs/includes/">Includes</a></li>
528
+
529
+
530
+
516
531
  <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
517
532
 
518
533
 
@@ -661,7 +676,7 @@ in your <code class="highlighter-rouge">_config.yml</code> file:</p>
661
676
  </script>
662
677
 
663
678
 
664
- <!-- Gauges (http://gaug.es/) -->
679
+ <!-- Gauges (http://get.gaug.es/) -->
665
680
  <script>
666
681
  var _gauges = _gauges || [];
667
682
  (function() {
@@ -678,7 +693,7 @@ in your <code class="highlighter-rouge">_config.yml</code> file:</p>
678
693
 
679
694
 
680
695
 
681
- <!-- Google Analytics (http://google.com/analytics) -->
696
+ <!-- Google Analytics (https://www.google.com/analytics) -->
682
697
  <script>
683
698
  !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
684
699
  (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
@@ -4,7 +4,7 @@
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.3.1">
7
+ <meta name="generator" content="Jekyll v3.4.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">
@@ -19,7 +19,7 @@
19
19
  <meta property="og:url" content="https://jekyllrb.com/docs/variables/">
20
20
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
21
21
  <meta property="og:type" content="article">
22
- <meta property="article:published_time" content="2017-01-20T13:17:57-08:00">
22
+ <meta property="article:published_time" content="2017-03-22T08:06:48-07:00">
23
23
  <meta name="twitter:card" content="summary">
24
24
  <meta name="twitter:site" content="@jekyllrb">
25
25
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
@@ -27,7 +27,7 @@
27
27
  {"@context": "http://schema.org",
28
28
  "@type": "BlogPosting",
29
29
  "headline": "Variables",
30
- "datePublished": "2017-01-20T13:17:57-08:00",
30
+ "datePublished": "2017-03-22T08:06:48-07:00",
31
31
  "description": "Jekyll traverses your site looking for files to process. Any files with YAML front matter are subject to processing. For each of these files, Jekyll makes a variety of data available via the Liquid templating system. The following is a reference of the available data.",
32
32
  "publisher": {"@type": "Organization",
33
33
  "logo": {"@type": "ImageObject",
@@ -192,6 +192,10 @@
192
192
 
193
193
 
194
194
 
195
+ <option value="/docs/includes/">Includes</option>
196
+
197
+
198
+
195
199
  <option value="/docs/permalinks/">Permalinks</option>
196
200
 
197
201
 
@@ -620,7 +624,7 @@ following is a reference of the available data.</p>
620
624
 
621
625
  If you specify front matter in a layout, access that via <code>layout</code>.
622
626
  For example, if you specify <code>class: full_page</code>
623
- in a page’s front matter, that value will be available as
627
+ in a layout’s front matter, that value will be available as
624
628
  <code>layout.class</code> in the layout and its parents.
625
629
 
626
630
  </p>
@@ -837,6 +841,10 @@ following is a reference of the available data.</p>
837
841
 
838
842
 
839
843
 
844
+ <li class=""><a href="/docs/includes/">Includes</a></li>
845
+
846
+
847
+
840
848
  <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
841
849
 
842
850
 
@@ -985,7 +993,7 @@ following is a reference of the available data.</p>
985
993
  </script>
986
994
 
987
995
 
988
- <!-- Gauges (http://gaug.es/) -->
996
+ <!-- Gauges (http://get.gaug.es/) -->
989
997
  <script>
990
998
  var _gauges = _gauges || [];
991
999
  (function() {
@@ -1002,7 +1010,7 @@ following is a reference of the available data.</p>
1002
1010
 
1003
1011
 
1004
1012
 
1005
- <!-- Google Analytics (http://google.com/analytics) -->
1013
+ <!-- Google Analytics (https://www.google.com/analytics) -->
1006
1014
  <script>
1007
1015
  !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
1008
1016
  (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
@@ -4,7 +4,7 @@
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.3.1">
7
+ <meta name="generator" content="Jekyll v3.4.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">
@@ -19,7 +19,7 @@
19
19
  <meta property="og:url" content="https://jekyllrb.com/docs/windows/">
20
20
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
21
21
  <meta property="og:type" content="article">
22
- <meta property="article:published_time" content="2017-01-20T13:17:57-08:00">
22
+ <meta property="article:published_time" content="2017-03-22T08:06:48-07:00">
23
23
  <meta name="twitter:card" content="summary">
24
24
  <meta name="twitter:site" content="@jekyllrb">
25
25
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
@@ -27,7 +27,7 @@
27
27
  {"@context": "http://schema.org",
28
28
  "@type": "BlogPosting",
29
29
  "headline": "Jekyll on Windows",
30
- "datePublished": "2017-01-20T13:17:57-08:00",
30
+ "datePublished": "2017-03-22T08:06:48-07:00",
31
31
  "description": "While Windows is not an officially-supported platform, it can be used to run Jekyll with the proper tweaks. This page aims to collect some of the general knowledge and lessons that have been unearthed by Windows users.",
32
32
  "publisher": {"@type": "Organization",
33
33
  "logo": {"@type": "ImageObject",
@@ -192,6 +192,10 @@
192
192
 
193
193
 
194
194
 
195
+ <option value="/docs/includes/">Includes</option>
196
+
197
+
198
+
195
199
  <option value="/docs/permalinks/">Permalinks</option>
196
200
 
197
201
 
@@ -303,9 +307,9 @@ knowledge and lessons that have been unearthed by Windows users.</p>
303
307
  </li>
304
308
  </ol>
305
309
 
306
- <p>For a more conventional way of installing Jekyll you can follow the <a href="https://labs.sverrirs.com/jekyll/">installation instructions by Sverrir Sigmundarson</a>. These instructions are for newer versions of Ruby 2.2.5 and Jekyll 3.</p>
310
+ <p>Updates in the infrastructure of Ruby may cause SSL errors when attempting to use <code class="highlighter-rouge">gem install</code> with versions of the RubyGems package older than 2.6. (The RubyGems package installed via the Chocolatey tool is version 2.3) If you have installed an older version, you can update the RubyGems package using the directions <a href="http://guides.rubygems.org/ssl-certificate-update/#installing-using-update-packages">here</a>.</p>
307
311
 
308
- <p>For instructions for older versions of Ruby 2.0.0 (<a href="https://github.com/copiousfreetime/hitimes/issues/40">prior to 2.2</a>) and Jekyll 2 and older you should follow the <a href="http://jekyll-windows.juthilo.com/">installation instruction by Julian Thilo</a>.</p>
312
+ <p>For a more conventional way of installing Jekyll you can follow this <a href="https://labs.sverrirs.com/jekyll/">complete guide to install Jekyll 3 on Windows by Sverrir Sigmundarson</a>.</p>
309
313
 
310
314
  <h2 id="encoding">Encoding</h2>
311
315
 
@@ -322,6 +326,20 @@ the site generation process. It can be done with the following command:</p>
322
326
  </code></pre>
323
327
  </div>
324
328
 
329
+ <h2 id="timezone-management">Timezone Management</h2>
330
+
331
+ <p>Since Windows doesn’t have a native source of zoneinfo data, the Ruby Interpreter would not understand IANA Timezones and hence using them had the <code class="highlighter-rouge">TZ</code> environment variable default to UTC/GMT 00:00.
332
+ Though Windows users could alternatively define their blog’s timezone by setting the key to use POSIX format of defining timezones, it wasn’t as user-friendly when it came to having the clock altered to changing DST-rules.</p>
333
+
334
+ <p>Jekyll now uses a rubygem to internally configure Timezone based on established <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones">IANA Timezone Database</a>.
335
+ While ‘new’ blogs created with Jekyll v3.4 and greater, will have the following added to their ‘Gemfile’ by default, existing sites <em>will</em> have to update their ‘Gemfile’ (and installed) to enable development on Windows:</p>
336
+
337
+ <div class="language-ruby highlighter-rouge">
338
+ <pre class="highlight"><code><span class="c1"># Windows does not include zoneinfo files, so bundle the tzinfo-data gem</span>
339
+ <span class="n">gem</span> <span class="s1">'tzinfo-data'</span><span class="p">,</span> <span class="ss">platforms: </span><span class="p">[</span><span class="ss">:mingw</span><span class="p">,</span> <span class="ss">:mswin</span><span class="p">,</span> <span class="ss">:x64_mingw</span><span class="p">,</span> <span class="ss">:jruby</span><span class="p">]</span>
340
+ </code></pre>
341
+ </div>
342
+
325
343
  <h2 id="auto-regeneration">Auto-regeneration</h2>
326
344
 
327
345
  <p>As of v1.3.0, Jekyll uses the <code class="highlighter-rouge">listen</code> gem to watch for changes when the
@@ -336,7 +354,7 @@ with Windows. Add the following to the Gemfile for your site:</p>
336
354
 
337
355
  <h3 id="how-to-install-github-pages">How to install github-pages</h3>
338
356
 
339
- <p>This section is part of an article written by <a href="http://jwillmer.de/blog/tutorial/how-to-install-jekyll-and-pages-gem-on-windows-10-x46" title="Installation instructions by Jens Willmer">Jens Willmer</a>. To follow the instructions you need to have <a href="https://chocolatey.org/install" title="Package manager for Windows">Chocolatey</a> installed on your system. If you already have a version of Ruby installed you need to uninstall it before you can continue.</p>
357
+ <p>This section is part of an article written by <a href="https://jwillmer.de/blog/tutorial/how-to-install-jekyll-and-pages-gem-on-windows-10-x46" title="Installation instructions by Jens Willmer">Jens Willmer</a>. To follow the instructions you need to have <a href="https://chocolatey.org/install" title="Package manager for Windows">Chocolatey</a> installed on your system. If you already have a version of Ruby installed you need to uninstall it before you can continue.</p>
340
358
 
341
359
  <h4 id="install-ruby-and-ruby-development-kit">Install Ruby and Ruby development kit</h4>
342
360
 
@@ -397,8 +415,8 @@ with Windows. Add the following to the Gemfile for your site:</p>
397
415
  </ul>
398
416
 
399
417
  <div class="language-ruby highlighter-rouge">
400
- <pre class="highlight"><code><span class="n">source</span> <span class="s1">'http://rubygems.org'</span>
401
- <span class="n">gem</span> <span class="s1">'github-pages'</span>
418
+ <pre class="highlight"><code><span class="n">source</span> <span class="s1">'https://rubygems.org'</span>
419
+ <span class="n">gem</span> <span class="s1">'github-pages'</span><span class="p">,</span> <span class="ss">group: :jekyll_plugins</span>
402
420
  </code></pre>
403
421
  </div>
404
422
 
@@ -519,6 +537,9 @@ There will be a warning on startup that you should include <code class="highligh
519
537
 
520
538
 
521
539
 
540
+
541
+
542
+
522
543
 
523
544
 
524
545
 
@@ -614,6 +635,10 @@ There will be a warning on startup that you should include <code class="highligh
614
635
 
615
636
 
616
637
 
638
+ <li class=""><a href="/docs/includes/">Includes</a></li>
639
+
640
+
641
+
617
642
  <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
618
643
 
619
644
 
@@ -762,7 +787,7 @@ There will be a warning on startup that you should include <code class="highligh
762
787
  </script>
763
788
 
764
789
 
765
- <!-- Gauges (http://gaug.es/) -->
790
+ <!-- Gauges (http://get.gaug.es/) -->
766
791
  <script>
767
792
  var _gauges = _gauges || [];
768
793
  (function() {
@@ -779,7 +804,7 @@ There will be a warning on startup that you should include <code class="highligh
779
804
 
780
805
 
781
806
 
782
- <!-- Google Analytics (http://google.com/analytics) -->
807
+ <!-- Google Analytics (https://www.google.com/analytics) -->
783
808
  <script>
784
809
  !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
785
810
  (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),