jekyll-docs 3.8.5 → 3.9.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (143) hide show
  1. checksums.yaml +4 -4
  2. data/site/404.html +5 -4
  3. data/site/docs/assets/index.html +22 -21
  4. data/site/docs/code_of_conduct/index.html +8 -7
  5. data/site/docs/collections/index.html +44 -43
  6. data/site/docs/conduct/index.html +8 -7
  7. data/site/docs/configuration/index.html +68 -67
  8. data/site/docs/continuous-integration/buddyworks/index.html +10 -9
  9. data/site/docs/continuous-integration/circleci/index.html +13 -12
  10. data/site/docs/continuous-integration/index.html +8 -7
  11. data/site/docs/continuous-integration/travis-ci/index.html +32 -31
  12. data/site/docs/contributing/index.html +34 -33
  13. data/site/docs/datafiles/index.html +24 -23
  14. data/site/docs/deployment-methods/index.html +30 -29
  15. data/site/docs/drafts/index.html +11 -10
  16. data/site/docs/extras/index.html +9 -8
  17. data/site/docs/frontmatter/index.html +8 -7
  18. data/site/docs/github-pages/index.html +19 -18
  19. data/site/docs/history/index.html +674 -645
  20. data/site/docs/home/index.html +8 -7
  21. data/site/docs/includes/index.html +44 -43
  22. data/site/docs/installation/index.html +16 -15
  23. data/site/docs/maintaining/affinity-team-captain/index.html +11 -10
  24. data/site/docs/maintaining/avoiding-burnout/index.html +8 -7
  25. data/site/docs/maintaining/becoming-a-maintainer/index.html +9 -8
  26. data/site/docs/maintaining/index.html +8 -7
  27. data/site/docs/maintaining/merging-a-pull-request/index.html +23 -22
  28. data/site/docs/maintaining/releasing-a-new-version/index.html +19 -18
  29. data/site/docs/maintaining/reviewing-a-pull-request/index.html +10 -9
  30. data/site/docs/maintaining/special-labels/index.html +14 -13
  31. data/site/docs/maintaining/triaging-an-issue/index.html +12 -11
  32. data/site/docs/migrations/index.html +9 -8
  33. data/site/docs/pages/index.html +12 -11
  34. data/site/docs/pagination/index.html +25 -24
  35. data/site/docs/permalinks/index.html +33 -32
  36. data/site/docs/plugins/index.html +57 -56
  37. data/site/docs/posts/index.html +37 -36
  38. data/site/docs/quickstart/index.html +18 -17
  39. data/site/docs/resources/index.html +9 -8
  40. data/site/docs/sites/index.html +8 -7
  41. data/site/docs/static-files/index.html +14 -13
  42. data/site/docs/structure/index.html +8 -7
  43. data/site/docs/support/index.html +9 -8
  44. data/site/docs/templates/index.html +44 -43
  45. data/site/docs/themes/index.html +63 -62
  46. data/site/docs/troubleshooting/index.html +48 -47
  47. data/site/docs/upgrading/0-to-2/index.html +51 -50
  48. data/site/docs/upgrading/2-to-3/index.html +35 -34
  49. data/site/docs/upgrading/index.html +11 -10
  50. data/site/docs/usage/index.html +15 -14
  51. data/site/docs/variables/index.html +8 -7
  52. data/site/docs/windows/index.html +29 -28
  53. data/site/feed.xml +45 -41
  54. data/site/help/index.html +7 -6
  55. data/site/index.html +7 -6
  56. data/site/jekyllconf/index.html +9 -8
  57. data/site/latest_version.txt +1 -1
  58. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +16 -10
  59. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +18 -12
  60. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +19 -13
  61. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +20 -14
  62. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +19 -13
  63. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +16 -10
  64. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +18 -12
  65. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +18 -12
  66. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +21 -15
  67. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +19 -13
  68. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +16 -10
  69. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +25 -19
  70. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +17 -11
  71. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +17 -11
  72. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +16 -10
  73. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +18 -12
  74. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +17 -11
  75. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +17 -11
  76. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +17 -11
  77. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +20 -14
  78. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +16 -10
  79. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +16 -10
  80. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +21 -15
  81. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +18 -12
  82. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +17 -11
  83. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +24 -18
  84. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +23 -17
  85. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +22 -16
  86. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +16 -10
  87. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +18 -12
  88. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +16 -10
  89. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +16 -10
  90. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +16 -10
  91. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +16 -10
  92. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +16 -10
  93. data/site/news/2015/10/26/jekyll-3-0-released/index.html +21 -15
  94. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +20 -14
  95. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +18 -12
  96. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +21 -15
  97. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +21 -15
  98. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +17 -11
  99. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +18 -12
  100. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +16 -10
  101. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +17 -11
  102. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +17 -11
  103. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +16 -10
  104. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +22 -16
  105. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +17 -11
  106. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +17 -11
  107. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +16 -10
  108. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +20 -14
  109. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +17 -11
  110. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +16 -10
  111. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +42 -36
  112. data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +17 -11
  113. data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +18 -12
  114. data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +17 -11
  115. data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +21 -15
  116. data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +26 -20
  117. data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +25 -19
  118. data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +18 -12
  119. data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +21 -15
  120. data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +17 -11
  121. data/site/news/2017/10/19/diversity-open-source/index.html +18 -12
  122. data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +18 -12
  123. data/site/news/2018/01/02/jekyll-3-7-0-released/index.html +21 -15
  124. data/site/news/2018/01/25/jekyll-3-7-2-released/index.html +26 -20
  125. data/site/news/2018/02/19/meet-jekyll-s-new-lead-developer/index.html +16 -10
  126. data/site/news/2018/02/24/jekyll-3-7-3-released/index.html +22 -16
  127. data/site/news/2018/05/01/jekyll-3-8-1-released/index.html +19 -13
  128. data/site/news/2018/05/19/jekyll-3-8-2-released/index.html +17 -11
  129. data/site/news/2018/06/05/jekyll-3-8-3-released/index.html +19 -13
  130. data/site/news/2019/07/02/jekyll-3-8-6-released/index.html +623 -0
  131. data/site/news/index.html +263 -218
  132. data/site/news/releases/index.html +261 -216
  133. data/site/philosophy.html +1 -1
  134. data/site/sitemap.xml +61 -57
  135. data/site/team/index.html +7 -6
  136. data/site/tutorials/convert-site-to-jekyll/index.html +97 -96
  137. data/site/tutorials/custom-404-page/index.html +16 -15
  138. data/site/tutorials/home/index.html +10 -9
  139. data/site/tutorials/navigation/index.html +102 -101
  140. data/site/tutorials/orderofinterpretation/index.html +32 -31
  141. data/site/tutorials/using-jekyll-with-bundler/index.html +19 -18
  142. data/site/tutorials/video-walkthroughs/index.html +8 -7
  143. metadata +10 -24
@@ -13,7 +13,7 @@ action, the outcome should be easily understandable and focused.</p>
13
13
  <h3 id="2-it-just-works">2. It “Just Works”</h3>
14
14
 
15
15
  <p>The out-of-the-box experience should be that it “just works.” Run
16
- <code class="highlighter-rouge">gem install jekyll</code> and it should build any Jekyll site that it’s given.
16
+ <code class="language-plaintext highlighter-rouge">gem install jekyll</code> and it should build any Jekyll site that it’s given.
17
17
  Features like auto-regeneration and settings like the markdown renderer
18
18
  should represent sane defaults that work perfectly for the vast majority of
19
19
  cases. The burden of initial configuration should not be placed on the user.</p>
@@ -2,203 +2,203 @@
2
2
  <urlset xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9 http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd" xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
3
3
  <url>
4
4
  <loc>https://jekyllrb.com/docs/assets/</loc>
5
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
5
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
6
6
  </url>
7
7
  <url>
8
8
  <loc>https://jekyllrb.com/docs/code_of_conduct/</loc>
9
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
9
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
10
10
  </url>
11
11
  <url>
12
12
  <loc>https://jekyllrb.com/docs/collections/</loc>
13
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
13
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
14
14
  </url>
15
15
  <url>
16
16
  <loc>https://jekyllrb.com/docs/conduct/</loc>
17
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
17
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
18
18
  </url>
19
19
  <url>
20
20
  <loc>https://jekyllrb.com/docs/configuration/</loc>
21
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
21
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
22
22
  </url>
23
23
  <url>
24
24
  <loc>https://jekyllrb.com/docs/continuous-integration/buddyworks/</loc>
25
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
25
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
26
26
  </url>
27
27
  <url>
28
28
  <loc>https://jekyllrb.com/docs/continuous-integration/circleci/</loc>
29
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
29
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
30
30
  </url>
31
31
  <url>
32
32
  <loc>https://jekyllrb.com/docs/continuous-integration/</loc>
33
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
33
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
34
34
  </url>
35
35
  <url>
36
36
  <loc>https://jekyllrb.com/docs/continuous-integration/travis-ci/</loc>
37
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
37
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
38
38
  </url>
39
39
  <url>
40
40
  <loc>https://jekyllrb.com/docs/contributing/</loc>
41
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
41
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
42
42
  </url>
43
43
  <url>
44
44
  <loc>https://jekyllrb.com/docs/datafiles/</loc>
45
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
45
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
46
46
  </url>
47
47
  <url>
48
48
  <loc>https://jekyllrb.com/docs/deployment-methods/</loc>
49
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
49
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
50
50
  </url>
51
51
  <url>
52
52
  <loc>https://jekyllrb.com/docs/drafts/</loc>
53
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
53
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
54
54
  </url>
55
55
  <url>
56
56
  <loc>https://jekyllrb.com/docs/extras/</loc>
57
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
57
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
58
58
  </url>
59
59
  <url>
60
60
  <loc>https://jekyllrb.com/docs/frontmatter/</loc>
61
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
61
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
62
62
  </url>
63
63
  <url>
64
64
  <loc>https://jekyllrb.com/docs/github-pages/</loc>
65
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
65
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
66
66
  </url>
67
67
  <url>
68
68
  <loc>https://jekyllrb.com/docs/history/</loc>
69
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
69
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
70
70
  </url>
71
71
  <url>
72
72
  <loc>https://jekyllrb.com/docs/includes/</loc>
73
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
73
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
74
74
  </url>
75
75
  <url>
76
76
  <loc>https://jekyllrb.com/docs/home/</loc>
77
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
77
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
78
78
  </url>
79
79
  <url>
80
80
  <loc>https://jekyllrb.com/docs/installation/</loc>
81
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
81
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
82
82
  </url>
83
83
  <url>
84
84
  <loc>https://jekyllrb.com/docs/maintaining/affinity-team-captain/</loc>
85
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
85
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
86
86
  </url>
87
87
  <url>
88
88
  <loc>https://jekyllrb.com/docs/maintaining/avoiding-burnout/</loc>
89
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
89
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
90
90
  </url>
91
91
  <url>
92
92
  <loc>https://jekyllrb.com/docs/maintaining/becoming-a-maintainer/</loc>
93
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
93
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
94
94
  </url>
95
95
  <url>
96
96
  <loc>https://jekyllrb.com/docs/maintaining/</loc>
97
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
97
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
98
98
  </url>
99
99
  <url>
100
100
  <loc>https://jekyllrb.com/docs/maintaining/merging-a-pull-request/</loc>
101
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
101
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
102
102
  </url>
103
103
  <url>
104
104
  <loc>https://jekyllrb.com/docs/maintaining/releasing-a-new-version/</loc>
105
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
105
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
106
106
  </url>
107
107
  <url>
108
108
  <loc>https://jekyllrb.com/docs/maintaining/reviewing-a-pull-request/</loc>
109
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
109
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
110
110
  </url>
111
111
  <url>
112
112
  <loc>https://jekyllrb.com/docs/maintaining/special-labels/</loc>
113
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
113
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
114
114
  </url>
115
115
  <url>
116
116
  <loc>https://jekyllrb.com/docs/maintaining/triaging-an-issue/</loc>
117
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
117
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
118
118
  </url>
119
119
  <url>
120
120
  <loc>https://jekyllrb.com/docs/migrations/</loc>
121
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
121
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
122
122
  </url>
123
123
  <url>
124
124
  <loc>https://jekyllrb.com/docs/pages/</loc>
125
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
125
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
126
126
  </url>
127
127
  <url>
128
128
  <loc>https://jekyllrb.com/docs/pagination/</loc>
129
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
129
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
130
130
  </url>
131
131
  <url>
132
132
  <loc>https://jekyllrb.com/docs/permalinks/</loc>
133
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
133
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
134
134
  </url>
135
135
  <url>
136
136
  <loc>https://jekyllrb.com/docs/plugins/</loc>
137
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
137
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
138
138
  </url>
139
139
  <url>
140
140
  <loc>https://jekyllrb.com/docs/posts/</loc>
141
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
141
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
142
142
  </url>
143
143
  <url>
144
144
  <loc>https://jekyllrb.com/docs/quickstart/</loc>
145
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
145
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
146
146
  </url>
147
147
  <url>
148
148
  <loc>https://jekyllrb.com/docs/resources/</loc>
149
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
149
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
150
150
  </url>
151
151
  <url>
152
152
  <loc>https://jekyllrb.com/docs/sites/</loc>
153
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
153
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
154
154
  </url>
155
155
  <url>
156
156
  <loc>https://jekyllrb.com/docs/static-files/</loc>
157
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
157
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
158
158
  </url>
159
159
  <url>
160
160
  <loc>https://jekyllrb.com/docs/structure/</loc>
161
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
161
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
162
162
  </url>
163
163
  <url>
164
164
  <loc>https://jekyllrb.com/docs/support/</loc>
165
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
165
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
166
166
  </url>
167
167
  <url>
168
168
  <loc>https://jekyllrb.com/docs/templates/</loc>
169
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
169
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
170
170
  </url>
171
171
  <url>
172
172
  <loc>https://jekyllrb.com/docs/themes/</loc>
173
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
173
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
174
174
  </url>
175
175
  <url>
176
176
  <loc>https://jekyllrb.com/docs/troubleshooting/</loc>
177
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
177
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
178
178
  </url>
179
179
  <url>
180
180
  <loc>https://jekyllrb.com/docs/upgrading/</loc>
181
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
181
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
182
182
  </url>
183
183
  <url>
184
184
  <loc>https://jekyllrb.com/docs/upgrading/0-to-2/</loc>
185
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
185
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
186
186
  </url>
187
187
  <url>
188
188
  <loc>https://jekyllrb.com/docs/upgrading/2-to-3/</loc>
189
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
189
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
190
190
  </url>
191
191
  <url>
192
192
  <loc>https://jekyllrb.com/docs/usage/</loc>
193
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
193
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
194
194
  </url>
195
195
  <url>
196
196
  <loc>https://jekyllrb.com/docs/variables/</loc>
197
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
197
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
198
198
  </url>
199
199
  <url>
200
200
  <loc>https://jekyllrb.com/docs/windows/</loc>
201
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
201
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
202
202
  </url>
203
203
  <url>
204
204
  <loc>https://jekyllrb.com/news/2013/05/05/jekyll-1-0-0-released/</loc>
@@ -489,32 +489,36 @@
489
489
  <lastmod>2018-06-05T07:00:00-07:00</lastmod>
490
490
  </url>
491
491
  <url>
492
+ <loc>https://jekyllrb.com/news/2019/07/02/jekyll-3-8-6-released/</loc>
493
+ <lastmod>2019-07-02T08:21:02-07:00</lastmod>
494
+ </url>
495
+ <url>
492
496
  <loc>https://jekyllrb.com/tutorials/convert-site-to-jekyll/</loc>
493
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
497
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
494
498
  </url>
495
499
  <url>
496
500
  <loc>https://jekyllrb.com/tutorials/custom-404-page/</loc>
497
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
501
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
498
502
  </url>
499
503
  <url>
500
504
  <loc>https://jekyllrb.com/tutorials/home/</loc>
501
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
505
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
502
506
  </url>
503
507
  <url>
504
508
  <loc>https://jekyllrb.com/tutorials/navigation/</loc>
505
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
509
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
506
510
  </url>
507
511
  <url>
508
512
  <loc>https://jekyllrb.com/tutorials/orderofinterpretation/</loc>
509
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
513
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
510
514
  </url>
511
515
  <url>
512
516
  <loc>https://jekyllrb.com/tutorials/using-jekyll-with-bundler/</loc>
513
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
517
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
514
518
  </url>
515
519
  <url>
516
520
  <loc>https://jekyllrb.com/tutorials/video-walkthroughs/</loc>
517
- <lastmod>2018-12-01T11:24:20-08:00</lastmod>
521
+ <lastmod>2020-08-05T11:55:36-07:00</lastmod>
518
522
  </url>
519
523
  <url>
520
524
  <loc>https://jekyllrb.com/news/</loc>
@@ -3,7 +3,7 @@
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width,initial-scale=1">
6
- <meta name="generator" content="Jekyll v3.8.5">
6
+ <meta name="generator" content="Jekyll v3.9.0">
7
7
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
8
8
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
9
9
  <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
@@ -11,9 +11,9 @@
11
11
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
12
12
  <link rel="stylesheet" href="/css/screen.css">
13
13
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
14
- <!-- Begin Jekyll SEO tag v2.5.0 -->
14
+ <!-- Begin Jekyll SEO tag v2.6.1 -->
15
15
  <title>The Jekyll Team | Jekyll • Simple, blog-aware, static sites</title>
16
- <meta name="generator" content="Jekyll v3.8.5" />
16
+ <meta name="generator" content="Jekyll v3.9.0" />
17
17
  <meta property="og:title" content="The Jekyll Team" />
18
18
  <meta property="og:locale" content="en_US" />
19
19
  <meta name="description" content="Transform your plain text into static websites and blogs" />
@@ -22,10 +22,11 @@
22
22
  <meta property="og:url" content="https://jekyllrb.com/team/" />
23
23
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
24
24
  <meta name="twitter:card" content="summary" />
25
+ <meta property="twitter:title" content="The Jekyll Team" />
25
26
  <meta name="twitter:site" content="@jekyllrb" />
26
27
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
27
28
  <script type="application/ld+json">
28
- {"headline":"The Jekyll Team","url":"https://jekyllrb.com/team/","description":"Transform your plain text into static websites and blogs","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"@type":"WebPage","@context":"http://schema.org"}</script>
29
+ {"url":"https://jekyllrb.com/team/","headline":"The Jekyll Team","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"description":"Transform your plain text into static websites and blogs","@type":"WebPage","@context":"https://schema.org"}</script>
29
30
  <!-- End Jekyll SEO tag -->
30
31
 
31
32
  <!--[if lt IE 9]>
@@ -70,7 +71,7 @@
70
71
  <div class="meta hide-on-mobiles">
71
72
  <ul>
72
73
  <li>
73
- <a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.5">v3.8.5</a>
74
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
74
75
  </li>
75
76
  <li>
76
77
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -182,7 +183,7 @@ and addressing issues for a specific aspect of Jekyll.</em></p>
182
183
  <footer>
183
184
  <div class="grid">
184
185
  <div class="unit one-third center-on-mobiles">
185
- <p>The contents of this website are <br>© 2018 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
186
+ <p>The contents of this website are <br>© 2020 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
186
187
  </div>
187
188
  <div class="unit two-thirds align-right center-on-mobiles">
188
189
  <p>
@@ -3,7 +3,7 @@
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width,initial-scale=1">
6
- <meta name="generator" content="Jekyll v3.8.5">
6
+ <meta name="generator" content="Jekyll v3.9.0">
7
7
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
8
8
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
9
9
  <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
@@ -11,9 +11,9 @@
11
11
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
12
12
  <link rel="stylesheet" href="/css/screen.css">
13
13
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
14
- <!-- Begin Jekyll SEO tag v2.5.0 -->
14
+ <!-- Begin Jekyll SEO tag v2.6.1 -->
15
15
  <title>Convert an HTML site to Jekyll | Jekyll • Simple, blog-aware, static sites</title>
16
- <meta name="generator" content="Jekyll v3.8.5" />
16
+ <meta name="generator" content="Jekyll v3.9.0" />
17
17
  <meta property="og:title" content="Convert an HTML site to Jekyll" />
18
18
  <meta property="og:locale" content="en_US" />
19
19
  <meta name="description" content="If you’re looking for themes for your Jekyll site, you don’t have to restrict yourself to existing Jekyll themes. It’s pretty easy to convert almost any static HTML files into a Jekyll website." />
@@ -22,12 +22,13 @@
22
22
  <meta property="og:url" content="https://jekyllrb.com/tutorials/convert-site-to-jekyll/" />
23
23
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
24
24
  <meta property="og:type" content="article" />
25
- <meta property="article:published_time" content="2018-12-01T11:24:20-08:00" />
25
+ <meta property="article:published_time" content="2020-08-05T11:55:36-07:00" />
26
26
  <meta name="twitter:card" content="summary" />
27
+ <meta property="twitter:title" content="Convert an HTML site to Jekyll" />
27
28
  <meta name="twitter:site" content="@jekyllrb" />
28
29
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
29
30
  <script type="application/ld+json">
30
- {"headline":"Convert an HTML site to Jekyll","dateModified":"2018-12-01T11:24:20-08:00","datePublished":"2018-12-01T11:24:20-08:00","url":"https://jekyllrb.com/tutorials/convert-site-to-jekyll/","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/tutorials/convert-site-to-jekyll/"},"description":"If you’re looking for themes for your Jekyll site, you don’t have to restrict yourself to existing Jekyll themes. It’s pretty easy to convert almost any static HTML files into a Jekyll website.","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"@type":"BlogPosting","@context":"http://schema.org"}</script>
31
+ {"url":"https://jekyllrb.com/tutorials/convert-site-to-jekyll/","headline":"Convert an HTML site to Jekyll","dateModified":"2020-08-05T11:55:36-07:00","datePublished":"2020-08-05T11:55:36-07:00","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"description":"If you’re looking for themes for your Jekyll site, you don’t have to restrict yourself to existing Jekyll themes. It’s pretty easy to convert almost any static HTML files into a Jekyll website.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/tutorials/convert-site-to-jekyll/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
31
32
  <!-- End Jekyll SEO tag -->
32
33
 
33
34
  <!--[if lt IE 9]>
@@ -72,7 +73,7 @@
72
73
  <div class="meta hide-on-mobiles">
73
74
  <ul>
74
75
  <li>
75
- <a href="https://github.com/jekyll/jekyll/releases/tag/v3.8.5">v3.8.5</a>
76
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
76
77
  </li>
77
78
  <li>
78
79
  <a href="https://github.com/jekyll/jekyll">GitHub</a>
@@ -168,19 +169,19 @@
168
169
 
169
170
  <p>We’ll start with a <em>basic Jekyll site</em> consisting of three files:</p>
170
171
 
171
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>├── _config.yml
172
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>├── _config.yml
172
173
  ├── _layouts
173
174
  │   └── default.html
174
175
  └── index.md
175
176
  </code></pre></div></div>
176
177
 
177
- <p>Manually create these three files in a folder called <code class="highlighter-rouge">my_jekyll_site</code> or whatever suits you the most, and place <code class="highlighter-rouge">default.html</code> inside a folder named <code class="highlighter-rouge">_layouts</code>.</p>
178
+ <p>Manually create these three files in a folder called <code class="language-plaintext highlighter-rouge">my_jekyll_site</code> or whatever suits you the most, and place <code class="language-plaintext highlighter-rouge">default.html</code> inside a folder named <code class="language-plaintext highlighter-rouge">_layouts</code>.</p>
178
179
 
179
180
  <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span><span class="nb">touch </span>_config.yml index.md default.html
180
181
  <span class="nv">$ </span><span class="nb">mkdir </span>_layouts <span class="o">&amp;&amp;</span> <span class="nb">mv </span>default.html _layouts
181
182
  </code></pre></div></div>
182
183
 
183
- <p>Fire up your favorite editor, and populate the contents of the <code class="highlighter-rouge">default.html</code> and <code class="highlighter-rouge">index.md</code> files as follows:</p>
184
+ <p>Fire up your favorite editor, and populate the contents of the <code class="language-plaintext highlighter-rouge">default.html</code> and <code class="language-plaintext highlighter-rouge">index.md</code> files as follows:</p>
184
185
 
185
186
  <p><strong>_config.yml</strong></p>
186
187
 
@@ -213,23 +214,23 @@
213
214
  <span class="s">--&gt;</span>
214
215
  </code></pre></div></div>
215
216
 
216
- <p>Now <code class="highlighter-rouge">cd</code> to <code class="highlighter-rouge">my_jekyll_site</code> and serve the site with the built-in server:</p>
217
+ <p>Now <code class="language-plaintext highlighter-rouge">cd</code> to <code class="language-plaintext highlighter-rouge">my_jekyll_site</code> and serve the site with the built-in server:</p>
217
218
 
218
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>cd my_jekyll_site
219
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>cd my_jekyll_site
219
220
  jekyll serve
220
221
  </code></pre></div></div>
221
222
 
222
- <p class="note info">If you have a Gemfile, <a href="/docs/quickstart/#about-bundler">use Bundler</a> by typing <code class="highlighter-rouge">bundle exec jekyll serve</code> instead.</p>
223
+ <p class="note info">If you have a Gemfile, <a href="/docs/quickstart/#about-bundler">use Bundler</a> by typing <code class="language-plaintext highlighter-rouge">bundle exec jekyll serve</code> instead.</p>
223
224
 
224
- <p>When you serve the site, you get a preview URL such as <code class="highlighter-rouge">http://127.0.0.1:4000/</code> (which is the same as <code class="highlighter-rouge">http://localhost:4000/</code>). The site’s files are built into the <code class="highlighter-rouge">_site</code> folder by default.</p>
225
+ <p>When you serve the site, you get a preview URL such as <code class="language-plaintext highlighter-rouge">http://127.0.0.1:4000/</code> (which is the same as <code class="language-plaintext highlighter-rouge">http://localhost:4000/</code>). The site’s files are built into the <code class="language-plaintext highlighter-rouge">_site</code> folder by default.</p>
225
226
 
226
227
  <p>This is a Jekyll site at the most basic functional level. Here’s what is happening:</p>
227
228
 
228
229
  <ul>
229
- <li>The <code class="highlighter-rouge">_config.yml</code> file contains settings that Jekyll uses as it processes your site. An empty config file will use default values for building a Jekyll site. For example, to convert <a href="https://learnxinyminutes.com/docs/markdown/">Markdown</a> to HTML, Jekyll will automatically use the <a href="https://rubygems.org/gems/kramdown/">kramdown Markdown filter</a>, without any need to specify it.</li>
230
- <li>Jekyll looks for files with <a href="/docs/frontmatter/">front matter tags</a> (the two sets of dashed lines <code class="highlighter-rouge">---</code> like those in <code class="highlighter-rouge">index.md</code>) and processes the files (populating site variables, rendering any <a href="https://shopify.github.io/liquid/">Liquid</a>, and converting Markdown to HTML).</li>
231
- <li>Jekyll pushes the content from all pages and posts into the <code class="highlighter-rouge">{{ content }}</code> variable in the layout specified (<code class="highlighter-rouge">default</code>) in the front matter tags.</li>
232
- <li>The processed files get written as <code class="highlighter-rouge">.html</code> files in the <code class="highlighter-rouge">_site</code> directory.</li>
230
+ <li>The <code class="language-plaintext highlighter-rouge">_config.yml</code> file contains settings that Jekyll uses as it processes your site. An empty config file will use default values for building a Jekyll site. For example, to convert <a href="https://learnxinyminutes.com/docs/markdown/">Markdown</a> to HTML, Jekyll will automatically use the <a href="https://rubygems.org/gems/kramdown/">kramdown Markdown filter</a>, without any need to specify it.</li>
231
+ <li>Jekyll looks for files with <a href="/docs/frontmatter/">front matter tags</a> (the two sets of dashed lines <code class="language-plaintext highlighter-rouge">---</code> like those in <code class="language-plaintext highlighter-rouge">index.md</code>) and processes the files (populating site variables, rendering any <a href="https://shopify.github.io/liquid/">Liquid</a>, and converting Markdown to HTML).</li>
232
+ <li>Jekyll pushes the content from all pages and posts into the <code class="language-plaintext highlighter-rouge">{{ content }}</code> variable in the layout specified (<code class="language-plaintext highlighter-rouge">default</code>) in the front matter tags.</li>
233
+ <li>The processed files get written as <code class="language-plaintext highlighter-rouge">.html</code> files in the <code class="language-plaintext highlighter-rouge">_site</code> directory.</li>
233
234
  </ul>
234
235
 
235
236
  <p>You can read more about how Jekyll processes the files in <a href="/tutorials/orderofinterpretation/">order of Interpretation</a>.</p>
@@ -238,61 +239,61 @@ jekyll serve
238
239
 
239
240
  <h2 id="1-create-a-template-for-your-default-layout">1. Create a template for your default layout</h2>
240
241
 
241
- <p>Find your HTML theme and save it as a <code class="highlighter-rouge">default</code> layout. If you’re converting or cloning an existing site, you can right-click the page and view the source code.</p>
242
+ <p>Find your HTML theme and save it as a <code class="language-plaintext highlighter-rouge">default</code> layout. If you’re converting or cloning an existing site, you can right-click the page and view the source code.</p>
242
243
 
243
244
  <p>For example, suppose you’re cloning your company site to create a documentation site with the same branding. Or suppose you have a personal site that you built with HTML and now want to make it a Jekyll site. Get the HTML source code for your site.</p>
244
245
 
245
246
  <p class="note info">Regardless of the site, do check the license and make sure you have permission to copy and use the code.</p>
246
247
 
247
- <p>Copy and paste the source code into a file called <code class="highlighter-rouge">default.html</code>. Put the <code class="highlighter-rouge">default.html</code> file inside the <code class="highlighter-rouge">_layouts</code> folder. This will be the default layout template for your pages and posts — that is, each page or post will use this layout when Jekyll builds the site.</p>
248
+ <p>Copy and paste the source code into a file called <code class="language-plaintext highlighter-rouge">default.html</code>. Put the <code class="language-plaintext highlighter-rouge">default.html</code> file inside the <code class="language-plaintext highlighter-rouge">_layouts</code> folder. This will be the default layout template for your pages and posts — that is, each page or post will use this layout when Jekyll builds the site.</p>
248
249
 
249
250
  <p>Note that in looking for templates, you want the HTML output of the template. If the template has PHP tags or other dynamic scripts, these dynamic elements will need to be converted to HTML or to <a href="https://shopify.github.io/liquid/">Liquid</a>. Liquid is <a href="/docs/templates/">Jekyll templating system</a> to retrieve dynamic content.</p>
250
251
 
251
- <p>Open <code class="highlighter-rouge">default.html</code> into your browser locally to ensure the site looks and behaves like it does online. You will likely need to adjust CSS, JS, and image paths so they work.</p>
252
+ <p>Open <code class="language-plaintext highlighter-rouge">default.html</code> into your browser locally to ensure the site looks and behaves like it does online. You will likely need to adjust CSS, JS, and image paths so they work.</p>
252
253
 
253
- <p>For example, if the paths were relative on the site you copied, you’ll need to either download the same assets into your Jekyll site or use absolute paths to the same assets in the cloud. (Syntax such as <code class="highlighter-rouge">src="//</code> requires a prefix such as <code class="highlighter-rouge">src="http://</code> to work in your local browser.)</p>
254
+ <p>For example, if the paths were relative on the site you copied, you’ll need to either download the same assets into your Jekyll site or use absolute paths to the same assets in the cloud. (Syntax such as <code class="language-plaintext highlighter-rouge">src="//</code> requires a prefix such as <code class="language-plaintext highlighter-rouge">src="http://</code> to work in your local browser.)</p>
254
255
 
255
256
  <p>Jekyll provides some <a href="/docs/templates/#filters">filters</a> to prepend a site URL before path. For example, you could preface your stylesheet like this:</p>
256
257
 
257
258
  <div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{{</span><span class="w"> </span><span class="s2">"/assets/style.css"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span>
258
259
  </code></pre></div></div>
259
260
 
260
- <p>The <code class="highlighter-rouge">relative_url</code> filter will prepend the <a href="https://byparker.com/blog/2014/clearing-up-confusion-around-baseurl/"><code class="highlighter-rouge">baseurl</code></a> value from your config file (as<code class="highlighter-rouge">blog</code> for instance) to the input. This is useful if your site is hosted at a subpath rather than at the root of the domain (for example, <code class="highlighter-rouge">http://mysite.com/blog/</code>).</p>
261
+ <p>The <code class="language-plaintext highlighter-rouge">relative_url</code> filter will prepend the <a href="https://byparker.com/blog/2014/clearing-up-confusion-around-baseurl/"><code class="language-plaintext highlighter-rouge">baseurl</code></a> value from your config file (as<code class="language-plaintext highlighter-rouge">blog</code> for instance) to the input. This is useful if your site is hosted at a subpath rather than at the root of the domain (for example, <code class="language-plaintext highlighter-rouge">http://mysite.com/blog/</code>).</p>
261
262
 
262
- <p>You can also use an <code class="highlighter-rouge">absolute_url</code> filter. This filter will prepend the <code class="highlighter-rouge">url</code> <em>and</em> <code class="highlighter-rouge">baseurl</code> value to the input:</p>
263
+ <p>You can also use an <code class="language-plaintext highlighter-rouge">absolute_url</code> filter. This filter will prepend the <code class="language-plaintext highlighter-rouge">url</code> <em>and</em> <code class="language-plaintext highlighter-rouge">baseurl</code> value to the input:</p>
263
264
 
264
265
  <div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{{</span><span class="w"> </span><span class="s2">"/assets/style.css"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">absolute_url</span><span class="w"> </span><span class="p">}}</span>
265
266
  </code></pre></div></div>
266
267
 
267
- <p>Again, both <code class="highlighter-rouge">url</code> and <code class="highlighter-rouge">baseurl</code> can be defined in your site’s config file, like this:</p>
268
+ <p>Again, both <code class="language-plaintext highlighter-rouge">url</code> and <code class="language-plaintext highlighter-rouge">baseurl</code> can be defined in your site’s config file, like this:</p>
268
269
 
269
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>url: http://mysite.com
270
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>url: http://mysite.com
270
271
  baseurl: /blog
271
272
  </code></pre></div></div>
272
273
 
273
- <p>The result in the output will be <code class="highlighter-rouge">http://mysite.com/blog/assets/style.css</code>.</p>
274
+ <p>The result in the output will be <code class="language-plaintext highlighter-rouge">http://mysite.com/blog/assets/style.css</code>.</p>
274
275
 
275
- <p>Note that the <code class="highlighter-rouge">url</code> property of any page begins with a forward slash (<code class="highlighter-rouge">/</code>), so omit this at the end of your <code class="highlighter-rouge">url</code> or <code class="highlighter-rouge">baseurl</code> property.</p>
276
+ <p>Note that the <code class="language-plaintext highlighter-rouge">url</code> property of any page begins with a forward slash (<code class="language-plaintext highlighter-rouge">/</code>), so omit this at the end of your <code class="language-plaintext highlighter-rouge">url</code> or <code class="language-plaintext highlighter-rouge">baseurl</code> property.</p>
276
277
 
277
278
  <p>You don’t have to prepend filters to link paths like this. You could also use relative links across your entire site. However you decide to code the paths to your assets, make sure they render correctly.</p>
278
279
 
279
- <p>Does your local <code class="highlighter-rouge">default.html</code> page look good in your browser? Are all images, styles, and other elements showing up correctly? If so, great. Keep going. You can use this template as the layout for all your pages and posts or create as many templates as you need.</p>
280
+ <p>Does your local <code class="language-plaintext highlighter-rouge">default.html</code> page look good in your browser? Are all images, styles, and other elements showing up correctly? If so, great. Keep going. You can use this template as the layout for all your pages and posts or create as many templates as you need.</p>
280
281
 
281
282
  <p>In the next section, you’ll blank out the content of the layout and replace it with placeholder tags that get populated dynamically with your Jekyll pages.</p>
282
283
 
283
284
  <h2 id="2-identify-the-content-part-of-the-layout">2. Identify the content part of the layout</h2>
284
285
 
285
- <p>In <code class="highlighter-rouge">default.html</code>, find where the page content begins (usually at <code class="highlighter-rouge">h1</code> or <code class="highlighter-rouge">h2</code> tags). Replace the title that appears inside these tags with <code class="highlighter-rouge">{{ page.title }}</code>.</p>
286
+ <p>In <code class="language-plaintext highlighter-rouge">default.html</code>, find where the page content begins (usually at <code class="language-plaintext highlighter-rouge">h1</code> or <code class="language-plaintext highlighter-rouge">h2</code> tags). Replace the title that appears inside these tags with <code class="language-plaintext highlighter-rouge">{{ page.title }}</code>.</p>
286
287
 
287
- <p>Remove the content part (keep everything else: navigation menu, sidebar, footer, etc.) and replace it with <code class="highlighter-rouge">{{ content }}</code>.</p>
288
+ <p>Remove the content part (keep everything else: navigation menu, sidebar, footer, etc.) and replace it with <code class="language-plaintext highlighter-rouge">{{ content }}</code>.</p>
288
289
 
289
- <p>Check the layout again in your browser and make sure you didn’t corrupt or alter it up by inadvertently removing a crucial <code class="highlighter-rouge">div</code> tag or other element. The only change should be to the title and page content, which are now blanked out or showing the placeholder tag.</p>
290
+ <p>Check the layout again in your browser and make sure you didn’t corrupt or alter it up by inadvertently removing a crucial <code class="language-plaintext highlighter-rouge">div</code> tag or other element. The only change should be to the title and page content, which are now blanked out or showing the placeholder tag.</p>
290
291
 
291
292
  <h2 id="3-create-a-couple-of-files-with-front-matter-tags">3. Create a couple of files with front matter tags</h2>
292
293
 
293
- <p>Create a couple of files (<code class="highlighter-rouge">index.md</code> and <code class="highlighter-rouge">about.md</code>) in your root directory.</p>
294
+ <p>Create a couple of files (<code class="language-plaintext highlighter-rouge">index.md</code> and <code class="language-plaintext highlighter-rouge">about.md</code>) in your root directory.</p>
294
295
 
295
- <p>In your <code class="highlighter-rouge">index.md</code> file, add some front matter tags containing a <code class="highlighter-rouge">title</code> and <code class="highlighter-rouge">layout</code> property, like this:</p>
296
+ <p>In your <code class="language-plaintext highlighter-rouge">index.md</code> file, add some front matter tags containing a <code class="language-plaintext highlighter-rouge">title</code> and <code class="language-plaintext highlighter-rouge">layout</code> property, like this:</p>
296
297
 
297
298
  <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
298
299
  <span class="na">title</span><span class="pi">:</span> <span class="s">Home</span>
@@ -302,20 +303,20 @@ baseurl: /blog
302
303
  <span class="s">Some page content here...</span>
303
304
  </code></pre></div></div>
304
305
 
305
- <p>Create another page for testing called <code class="highlighter-rouge">about.md</code> with similar front matter tags.</p>
306
+ <p>Create another page for testing called <code class="language-plaintext highlighter-rouge">about.md</code> with similar front matter tags.</p>
306
307
 
307
308
  <p class="note info">If you don’t specify a layout in your pages, Jekyll will simply render that page as an unstyled basic HTML page.</p>
308
309
 
309
310
  <h2 id="4-add-a-configuration-file">4. Add a configuration file</h2>
310
311
 
311
- <p>Add a <code class="highlighter-rouge">_config.yml</code> file in your root directory. In <code class="highlighter-rouge">_config.yml</code>, you can optionally specify the markdown filter you want. By default, <a href="https://kramdown.gettalong.org/">kramdown</a> is used (without the need to specify it). If no other filter is specified, your config file will automatically apply the following as a default setting:</p>
312
+ <p>Add a <code class="language-plaintext highlighter-rouge">_config.yml</code> file in your root directory. In <code class="language-plaintext highlighter-rouge">_config.yml</code>, you can optionally specify the markdown filter you want. By default, <a href="https://kramdown.gettalong.org/">kramdown</a> is used (without the need to specify it). If no other filter is specified, your config file will automatically apply the following as a default setting:</p>
312
313
 
313
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>markdown: kramdown
314
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>markdown: kramdown
314
315
  </code></pre></div></div>
315
316
 
316
317
  <p>You can also specify <a href="https://kramdown.gettalong.org/converter/html.html">some options</a> for kramdown to make it behave more like <a href="https://github.github.com/gfm/">GitHub Flavored Markdown (GFM)</a>:</p>
317
318
 
318
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>kramdown:
319
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>kramdown:
319
320
  input: GFM
320
321
  auto_ids: true
321
322
  hard_wrap: false
@@ -324,44 +325,44 @@ baseurl: /blog
324
325
 
325
326
  <h2 id="5-test-your-pages">5. Test your pages</h2>
326
327
 
327
- <p>Now run <code class="highlighter-rouge">jekyll serve</code> and toggle between your <code class="highlighter-rouge">index.html</code> and <code class="highlighter-rouge">about.html</code> pages. The default layout should load for both pages.</p>
328
+ <p>Now run <code class="language-plaintext highlighter-rouge">jekyll serve</code> and toggle between your <code class="language-plaintext highlighter-rouge">index.html</code> and <code class="language-plaintext highlighter-rouge">about.html</code> pages. The default layout should load for both pages.</p>
328
329
 
329
330
  <p>You’ve now extracted your content out into separate files and defined a common layout for pages.</p>
330
331
 
331
332
  <p>You could define any number of layouts you want for pages. Then just identify the layout you want that particular page to use. For example:</p>
332
333
 
333
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
334
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
334
335
  title: Sample page
335
336
  layout: homepage
336
337
  ---
337
338
  </code></pre></div></div>
338
339
 
339
- <p>This page would then use the <code class="highlighter-rouge">homepage.html</code> template in the <code class="highlighter-rouge">_layouts</code> folder.</p>
340
+ <p>This page would then use the <code class="language-plaintext highlighter-rouge">homepage.html</code> template in the <code class="language-plaintext highlighter-rouge">_layouts</code> folder.</p>
340
341
 
341
- <p>You can even set <a href="/docs/configuration/#front-matter-defaults">default front matter tags</a> for pages, posts, or <a href="/docs/collections/">collections</a> in your <code class="highlighter-rouge">_config.yml</code> file so that you don’t have to specify the layout in the front matter variables. Anywayd, setting defaults is beyond the scope of this tutorial, let’s get back to work.</p>
342
+ <p>You can even set <a href="/docs/configuration/#front-matter-defaults">default front matter tags</a> for pages, posts, or <a href="/docs/collections/">collections</a> in your <code class="language-plaintext highlighter-rouge">_config.yml</code> file so that you don’t have to specify the layout in the front matter variables. Anywayd, setting defaults is beyond the scope of this tutorial, let’s get back to work.</p>
342
343
 
343
344
  <h2 id="6-configure-site-variables">6. Configure site variables</h2>
344
345
 
345
- <p>You already configured the page title using <code class="highlighter-rouge">{{ page.title }}</code> tags. But there are more <code class="highlighter-rouge">title</code> tags to populate. Pages also have a <a href="https://moz.com/learn/seo/title-tag"><code class="highlighter-rouge">title</code></a> tag that appears in the browser tab or window. Typically you put the page title followed by the site title here.</p>
346
+ <p>You already configured the page title using <code class="language-plaintext highlighter-rouge">{{ page.title }}</code> tags. But there are more <code class="language-plaintext highlighter-rouge">title</code> tags to populate. Pages also have a <a href="https://moz.com/learn/seo/title-tag"><code class="language-plaintext highlighter-rouge">title</code></a> tag that appears in the browser tab or window. Typically you put the page title followed by the site title here.</p>
346
347
 
347
- <p>In your <code class="highlighter-rouge">default.html</code> layout, look for the <code class="highlighter-rouge">title</code> tags below your <code class="highlighter-rouge">head</code> tags:</p>
348
+ <p>In your <code class="language-plaintext highlighter-rouge">default.html</code> layout, look for the <code class="language-plaintext highlighter-rouge">title</code> tags below your <code class="language-plaintext highlighter-rouge">head</code> tags:</p>
348
349
 
349
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>&lt;title&gt;ACME Website&lt;/title&gt;
350
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>&lt;title&gt;ACME Website&lt;/title&gt;
350
351
  </code></pre></div></div>
351
352
 
352
353
  <p>Insert the following site variables:</p>
353
354
 
354
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>&lt;title&gt;{{ page.title }} | {{ site.title }}&lt;/title&gt;
355
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>&lt;title&gt;{{ page.title }} | {{ site.title }}&lt;/title&gt;
355
356
  </code></pre></div></div>
356
357
 
357
- <p>Open <code class="highlighter-rouge">_config.yml</code> and add a <code class="highlighter-rouge">title</code> property for your site’s name.</p>
358
+ <p>Open <code class="language-plaintext highlighter-rouge">_config.yml</code> and add a <code class="language-plaintext highlighter-rouge">title</code> property for your site’s name.</p>
358
359
 
359
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>title: ACME Website
360
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>title: ACME Website
360
361
  </code></pre></div></div>
361
362
 
362
- <p>Any properties you add in your <code class="highlighter-rouge">_config.yml</code> file are accessible through the <code class="highlighter-rouge">site</code> namespace. Similarly, any properties in your page’s front matter are accessible through the <code class="highlighter-rouge">page</code> namespace. Use dot notation after <code class="highlighter-rouge">site</code> or <code class="highlighter-rouge">page</code> to access the value.</p>
363
+ <p>Any properties you add in your <code class="language-plaintext highlighter-rouge">_config.yml</code> file are accessible through the <code class="language-plaintext highlighter-rouge">site</code> namespace. Similarly, any properties in your page’s front matter are accessible through the <code class="language-plaintext highlighter-rouge">page</code> namespace. Use dot notation after <code class="language-plaintext highlighter-rouge">site</code> or <code class="language-plaintext highlighter-rouge">page</code> to access the value.</p>
363
364
 
364
- <p>Stop your Jekyll server with <kbd>Ctrl</kbd> + <kbd>C</kbd> and restart it. Verify that the <code class="highlighter-rouge">title</code> tags are populating correctly.</p>
365
+ <p>Stop your Jekyll server with <kbd>Ctrl</kbd> + <kbd>C</kbd> and restart it. Verify that the <code class="language-plaintext highlighter-rouge">title</code> tags are populating correctly.</p>
365
366
 
366
367
  <p class="note info">Every time you modify your config file, you have to restart Jekyll for the changes to take effect. When you modify other files, Jekyll automatically picks up the changes when it rebuilds.</p>
367
368
 
@@ -371,17 +372,17 @@ layout: homepage
371
372
 
372
373
  <p>It’s common to show a list of posts on the homepage. First, let’s create some posts so that we have something to showcase.</p>
373
374
 
374
- <p>Add some posts in a <code class="highlighter-rouge">_posts</code> folder following the standard <code class="highlighter-rouge">YYYY-MM-DD-title.md</code> post format:</p>
375
+ <p>Add some posts in a <code class="language-plaintext highlighter-rouge">_posts</code> folder following the standard <code class="language-plaintext highlighter-rouge">YYYY-MM-DD-title.md</code> post format:</p>
375
376
 
376
377
  <ul>
377
- <li><code class="highlighter-rouge">2017-01-02-my-first-post.md</code></li>
378
- <li><code class="highlighter-rouge">2017-01-15-my-second-post.md</code></li>
379
- <li><code class="highlighter-rouge">2017-02-08-my-third-post.md</code></li>
378
+ <li><code class="language-plaintext highlighter-rouge">2017-01-02-my-first-post.md</code></li>
379
+ <li><code class="language-plaintext highlighter-rouge">2017-01-15-my-second-post.md</code></li>
380
+ <li><code class="language-plaintext highlighter-rouge">2017-02-08-my-third-post.md</code></li>
380
381
  </ul>
381
382
 
382
383
  <p>In each post, add some basic content:</p>
383
384
 
384
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
385
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
385
386
  title: My First Post
386
387
  layout: default
387
388
  ---
@@ -389,9 +390,9 @@ layout: default
389
390
  Some sample content...
390
391
  </code></pre></div></div>
391
392
 
392
- <p>Now let’s create a layout that will display the posts. Create a new file in <code class="highlighter-rouge">_layouts</code> called <code class="highlighter-rouge">home.html</code> and add the following logic:</p>
393
+ <p>Now let’s create a layout that will display the posts. Create a new file in <code class="language-plaintext highlighter-rouge">_layouts</code> called <code class="language-plaintext highlighter-rouge">home.html</code> and add the following logic:</p>
393
394
 
394
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
395
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
395
396
  layout: default
396
397
  ---
397
398
 
@@ -405,56 +406,56 @@ layout: default
405
406
  &lt;/ul&gt;
406
407
  </code></pre></div></div>
407
408
 
408
- <p>Create a file called <code class="highlighter-rouge">blog.md</code> in your root directory and specify the <code class="highlighter-rouge">home</code> layout:</p>
409
+ <p>Create a file called <code class="language-plaintext highlighter-rouge">blog.md</code> in your root directory and specify the <code class="language-plaintext highlighter-rouge">home</code> layout:</p>
409
410
 
410
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
411
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
411
412
  title: Blog
412
413
  layout: home
413
414
  ---
414
415
  </code></pre></div></div>
415
416
 
416
- <p>In this case, contents of <code class="highlighter-rouge">blog.md</code> will be pushed into the <code class="highlighter-rouge">{{ content }}</code> tag in the <code class="highlighter-rouge">home</code> layout. Then the <code class="highlighter-rouge">home</code> layout will be pushed into the <code class="highlighter-rouge">{{ content }}</code> tag of the <code class="highlighter-rouge">default</code> layout.</p>
417
+ <p>In this case, contents of <code class="language-plaintext highlighter-rouge">blog.md</code> will be pushed into the <code class="language-plaintext highlighter-rouge">{{ content }}</code> tag in the <code class="language-plaintext highlighter-rouge">home</code> layout. Then the <code class="language-plaintext highlighter-rouge">home</code> layout will be pushed into the <code class="language-plaintext highlighter-rouge">{{ content }}</code> tag of the <code class="language-plaintext highlighter-rouge">default</code> layout.</p>
417
418
 
418
419
  <h3 id="how-layouts-work">How layouts work</h3>
419
420
 
420
- <p>When a layout specifies another layout, it means the content of the first layout will be stuffed into the <code class="highlighter-rouge">{{ content }}</code> tag of the second layout. As an analogy, think of Russian dolls that fit into each other. Each layout fits into another layout that it specifies.</p>
421
+ <p>When a layout specifies another layout, it means the content of the first layout will be stuffed into the <code class="language-plaintext highlighter-rouge">{{ content }}</code> tag of the second layout. As an analogy, think of Russian dolls that fit into each other. Each layout fits into another layout that it specifies.</p>
421
422
 
422
423
  <p>The following diagram shows how layouts work in Jekyll:</p>
423
424
 
424
425
  <p><img src="../../img/jekylllayoutconcept.png" alt="Concept of Jekyll layouts" /></p>
425
426
 
426
- <p class="image-description">In this example, the content from a Markdown document <code class="highlighter-rouge">document.md</code> that specifies <code class="highlighter-rouge">layout: docs</code> gets pushed into the <code class="highlighter-rouge">{{ content }}</code> tag of the layout file <code class="highlighter-rouge">docs.html</code>. Because the <code class="highlighter-rouge">docs</code> layout itself specifies <code class="highlighter-rouge">layout: page</code>, the content from <code class="highlighter-rouge">docs.html</code> gets pushed into the <code class="highlighter-rouge">{{ content }}</code> tag in the layout file <code class="highlighter-rouge">page.html</code>. Finally because the <code class="highlighter-rouge">page</code> layout specifies <code class="highlighter-rouge">layout: default</code>, the content from <code class="highlighter-rouge">page.html</code> gets pushed into the <code class="highlighter-rouge">{{ content }}</code> tag of the layout file <code class="highlighter-rouge">default.html</code>.</p>
427
+ <p class="image-description">In this example, the content from a Markdown document <code class="language-plaintext highlighter-rouge">document.md</code> that specifies <code class="language-plaintext highlighter-rouge">layout: docs</code> gets pushed into the <code class="language-plaintext highlighter-rouge">{{ content }}</code> tag of the layout file <code class="language-plaintext highlighter-rouge">docs.html</code>. Because the <code class="language-plaintext highlighter-rouge">docs</code> layout itself specifies <code class="language-plaintext highlighter-rouge">layout: page</code>, the content from <code class="language-plaintext highlighter-rouge">docs.html</code> gets pushed into the <code class="language-plaintext highlighter-rouge">{{ content }}</code> tag in the layout file <code class="language-plaintext highlighter-rouge">page.html</code>. Finally because the <code class="language-plaintext highlighter-rouge">page</code> layout specifies <code class="language-plaintext highlighter-rouge">layout: default</code>, the content from <code class="language-plaintext highlighter-rouge">page.html</code> gets pushed into the <code class="language-plaintext highlighter-rouge">{{ content }}</code> tag of the layout file <code class="language-plaintext highlighter-rouge">default.html</code>.</p>
427
428
 
428
- <p>You don’t need multiple layouts. You could just use one: <code class="highlighter-rouge">default</code>. You have options for how you design your site. In general, it’s common to define one layout for pages and another layout for posts, but for both of these layouts to inherit the <code class="highlighter-rouge">default</code> template (which usually defines the top and bottom parts of the site).</p>
429
+ <p>You don’t need multiple layouts. You could just use one: <code class="language-plaintext highlighter-rouge">default</code>. You have options for how you design your site. In general, it’s common to define one layout for pages and another layout for posts, but for both of these layouts to inherit the <code class="language-plaintext highlighter-rouge">default</code> template (which usually defines the top and bottom parts of the site).</p>
429
430
 
430
- <p>In your browser, go to <code class="highlighter-rouge">blog.html</code> and see the list of posts.
431
- Note that you don’t have to use the method described here. You could have simply added the <code class="highlighter-rouge">for</code> loop to any page, such as <code class="highlighter-rouge">index.md</code>, to display these posts. But given that you may have more complex logic for other features, it can be helpful to store your logic in templates separate from the page area where you frequently type your content.</p>
431
+ <p>In your browser, go to <code class="language-plaintext highlighter-rouge">blog.html</code> and see the list of posts.
432
+ Note that you don’t have to use the method described here. You could have simply added the <code class="language-plaintext highlighter-rouge">for</code> loop to any page, such as <code class="language-plaintext highlighter-rouge">index.md</code>, to display these posts. But given that you may have more complex logic for other features, it can be helpful to store your logic in templates separate from the page area where you frequently type your content.</p>
432
433
 
433
- <p class="note info">At minimum, a layout should contain <code class="highlighter-rouge">{{ content }}</code>, which acts as a receiver for the <em>content</em> to be rendered.</p>
434
+ <p class="note info">At minimum, a layout should contain <code class="language-plaintext highlighter-rouge">{{ content }}</code>, which acts as a receiver for the <em>content</em> to be rendered.</p>
434
435
 
435
436
  <h3 id="for-loops">For loops</h3>
436
437
 
437
- <p>By the way, let’s pause here to look at the <code class="highlighter-rouge">for</code> loop logic a little more closely. <a href="https://shopify.github.io/liquid/tags/iteration/">For loops in Liquid</a> are one of the most commonly used Liquid tags. <em>For loops</em> let you iterate through content in your Jekyll site and build out a result. The <code class="highlighter-rouge">for</code> loop also has <a href="https://help.shopify.com/themes/liquid/objects/for-loops">certain properties available</a> (like first or last iteration) based on the loop’s position in the loop as well.</p>
438
+ <p>By the way, let’s pause here to look at the <code class="language-plaintext highlighter-rouge">for</code> loop logic a little more closely. <a href="https://shopify.github.io/liquid/tags/iteration/">For loops in Liquid</a> are one of the most commonly used Liquid tags. <em>For loops</em> let you iterate through content in your Jekyll site and build out a result. The <code class="language-plaintext highlighter-rouge">for</code> loop also has <a href="https://help.shopify.com/themes/liquid/objects/for-loops">certain properties available</a> (like first or last iteration) based on the loop’s position in the loop as well.</p>
438
439
 
439
- <p>We’ve only scratched the surface of what you can do with <code class="highlighter-rouge">for</code> loops in retrieving posts. For example, if you wanted to display posts from a specific category, you could do so by adding a <code class="highlighter-rouge">categories</code> property to your post’s front matter and then look in those categories. Further, you could limit the number of results by adding a <code class="highlighter-rouge">limit</code> property. Here’s an example:</p>
440
+ <p>We’ve only scratched the surface of what you can do with <code class="language-plaintext highlighter-rouge">for</code> loops in retrieving posts. For example, if you wanted to display posts from a specific category, you could do so by adding a <code class="language-plaintext highlighter-rouge">categories</code> property to your post’s front matter and then look in those categories. Further, you could limit the number of results by adding a <code class="language-plaintext highlighter-rouge">limit</code> property. Here’s an example:</p>
440
441
 
441
442
  <div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code>&lt;ul class="myposts"&gt;
442
- <span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span>post<span class="w"> </span>in<span class="w"> </span>site.categories.podcasts<span class="w"> </span><span class="na">limit</span><span class="o">:</span><span class="mi">3</span><span class="w"> </span><span class="p">%}</span>
443
+ <span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span><span class="nv">post</span><span class="w"> </span><span class="nt">in</span><span class="w"> </span><span class="nv">site.categories.podcasts</span><span class="w"> </span><span class="na">limit</span><span class="o">:</span><span class="mi">3</span><span class="w"> </span><span class="p">%}</span>
443
444
  &lt;li&gt;&lt;a href="<span class="p">{{</span><span class="w"> </span><span class="nv">post</span><span class="p">.</span><span class="nv">url</span><span class="w"> </span><span class="p">}}</span>"&gt;<span class="p">{{</span><span class="w"> </span><span class="nv">post</span><span class="p">.</span><span class="nv">title</span><span class="p">}}</span>&lt;/a&gt;
444
445
  &lt;span class="postDate"&gt;<span class="p">{{</span><span class="w"> </span><span class="nv">post</span><span class="p">.</span><span class="nv">date</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">date</span><span class="p">:</span><span class="w"> </span><span class="s2">"%b %-d, %Y"</span><span class="w"> </span><span class="p">}}</span>&lt;/span&gt;
445
446
  &lt;/li&gt;
446
447
  <span class="p">{%</span><span class="w"> </span><span class="nt">endfor</span><span class="w"> </span><span class="p">%}</span>
447
448
  </code></pre></div></div>
448
449
 
449
- <p>This loop would get the latest three posts that have a category called <code class="highlighter-rouge">podcasts</code> in the front matter.</p>
450
+ <p>This loop would get the latest three posts that have a category called <code class="language-plaintext highlighter-rouge">podcasts</code> in the front matter.</p>
450
451
 
451
452
  <h2 id="8-configure-navigation">8. Configure navigation</h2>
452
453
 
453
454
  <p>Now that you’ve configured posts, let’s configure page navigation. Most websites have some navigation either in the sidebar or header area.</p>
454
455
 
455
- <p>In this tutorial, we’ll assume you’ve got a simple list of pages you want to generate. If you only have a handful of pages, you could list them by using a <code class="highlighter-rouge">for</code> loop to iterate through the <code class="highlighter-rouge">site.pages</code> object and then order them by a front matter property.</p>
456
+ <p>In this tutorial, we’ll assume you’ve got a simple list of pages you want to generate. If you only have a handful of pages, you could list them by using a <code class="language-plaintext highlighter-rouge">for</code> loop to iterate through the <code class="language-plaintext highlighter-rouge">site.pages</code> object and then order them by a front matter property.</p>
456
457
 
457
- <p>Identify the part of your code where the list of pages appears. Usually this is a <code class="highlighter-rouge">&lt;ul&gt;</code> element with various child <code class="highlighter-rouge">&lt;li&gt;</code> elements. Replace the code with the following:</p>
458
+ <p>Identify the part of your code where the list of pages appears. Usually this is a <code class="language-plaintext highlighter-rouge">&lt;ul&gt;</code> element with various child <code class="language-plaintext highlighter-rouge">&lt;li&gt;</code> elements. Replace the code with the following:</p>
458
459
 
459
460
  <div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;ul&gt;</span>
460
461
  {% assign mypages = site.pages | sort: "order" %}
@@ -464,27 +465,27 @@ Note that you don’t have to use the method described here. You could have simp
464
465
  <span class="nt">&lt;/ul&gt;</span>
465
466
  </code></pre></div></div>
466
467
 
467
- <p>This example assumes each page would have front matter containing both a <code class="highlighter-rouge">title</code> and <code class="highlighter-rouge">order</code> property like this:</p>
468
+ <p>This example assumes each page would have front matter containing both a <code class="language-plaintext highlighter-rouge">title</code> and <code class="language-plaintext highlighter-rouge">order</code> property like this:</p>
468
469
 
469
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
470
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
470
471
  title: My page
471
472
  order: 2
472
473
  ---
473
474
  </code></pre></div></div>
474
475
 
475
- <p>Here the <code class="highlighter-rouge">order</code> property will define how the pages get sorted, with <code class="highlighter-rouge">1</code> appearing first in the list.</p>
476
+ <p>Here the <code class="language-plaintext highlighter-rouge">order</code> property will define how the pages get sorted, with <code class="language-plaintext highlighter-rouge">1</code> appearing first in the list.</p>
476
477
 
477
478
  <p>You could also iterate through a list of pages that you maintain in a separate data file. This might be more appropriate if you have a lot of pages, or you have other properties about the pages you want to store.</p>
478
479
 
479
- <p>To manage page links this way, create a folder in your Jekyll project called <code class="highlighter-rouge">_data</code>. In this folder, create a file called e.g. <code class="highlighter-rouge">navigation.yml</code> with this content:</p>
480
+ <p>To manage page links this way, create a folder in your Jekyll project called <code class="language-plaintext highlighter-rouge">_data</code>. In this folder, create a file called e.g. <code class="language-plaintext highlighter-rouge">navigation.yml</code> with this content:</p>
480
481
 
481
- <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s">Sample page 1</span>
482
+ <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s">Sample page </span><span class="m">1</span>
482
483
  <span class="na">url</span><span class="pi">:</span> <span class="s">/page-1-permalink/</span>
483
484
 
484
- <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s">Sample page 2</span>
485
+ <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s">Sample page </span><span class="m">2</span>
485
486
  <span class="na">url</span><span class="pi">:</span> <span class="s">/page-2-permalink/</span>
486
487
 
487
- <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s">Sample page 3</span>
488
+ <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s">Sample page </span><span class="m">3</span>
488
489
  <span class="na">url</span><span class="pi">:</span> <span class="s">/page-3-permalink/</span>
489
490
  </code></pre></div></div>
490
491
 
@@ -505,22 +506,22 @@ order: 2
505
506
 
506
507
  <h2 id="9-simplify-your-site-with-includes">9. Simplify your site with includes</h2>
507
508
 
508
- <p>Let’s suppose your <code class="highlighter-rouge">default.html</code> file is massive and hard to work with. You can break up your layout by putting some of the HTML code in <em>include</em> files.</p>
509
+ <p>Let’s suppose your <code class="language-plaintext highlighter-rouge">default.html</code> file is massive and hard to work with. You can break up your layout by putting some of the HTML code in <em>include</em> files.</p>
509
510
 
510
- <p>Add a folder called <code class="highlighter-rouge">_includes</code> in your root directory. In that folder, add a file there called <code class="highlighter-rouge">sidebar.html</code>.</p>
511
+ <p>Add a folder called <code class="language-plaintext highlighter-rouge">_includes</code> in your root directory. In that folder, add a file there called <code class="language-plaintext highlighter-rouge">sidebar.html</code>.</p>
511
512
 
512
- <p>Remove your sidebar code from your <code class="highlighter-rouge">default.html</code> layout and insert it into the <code class="highlighter-rouge">sidebar.html</code> file.</p>
513
+ <p>Remove your sidebar code from your <code class="language-plaintext highlighter-rouge">default.html</code> layout and insert it into the <code class="language-plaintext highlighter-rouge">sidebar.html</code> file.</p>
513
514
 
514
- <p>Where the sidebar code previously existed in <code class="highlighter-rouge">default.html</code>, pull in your “include” like this:</p>
515
+ <p>Where the sidebar code previously existed in <code class="language-plaintext highlighter-rouge">default.html</code>, pull in your “include” like this:</p>
515
516
 
516
- <div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">include</span><span class="w"> </span><span class="na">sidebar</span><span class="p">.</span><span class="na">html</span><span class="w"> </span><span class="p">%}</span>
517
+ <div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">include</span><span class="w"> </span>sidebar.html<span class="w"> </span><span class="p">%}</span>
517
518
  </code></pre></div></div>
518
519
 
519
520
  <p>You can break up other elements of your theme like this, such as your header or footer. Then you can apply these common elements to other layout files. This way you won’t have duplicate code.</p>
520
521
 
521
522
  <h2 id="10-rss-feed">10. RSS feed</h2>
522
523
 
523
- <p>Your Jekyll site needs an RSS feed. Here’s the <a href="http://www.w3schools.com/xml/xml_rss.asp">basic RSS feed syntax</a>. To create an RSS file in Jekyll, create a file called <code class="highlighter-rouge">feed.xml</code> in your root directory and add the following:</p>
524
+ <p>Your Jekyll site needs an RSS feed. Here’s the <a href="http://www.w3schools.com/xml/xml_rss.asp">basic RSS feed syntax</a>. To create an RSS file in Jekyll, create a file called <code class="language-plaintext highlighter-rouge">feed.xml</code> in your root directory and add the following:</p>
524
525
 
525
526
  <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
526
527
  layout: null
@@ -549,20 +550,20 @@ layout: null
549
550
  <span class="nt">&lt;/rss&gt;</span>
550
551
  </code></pre></div></div>
551
552
 
552
- <p>Make sure your <code class="highlighter-rouge">_config.yml</code> file has properties for <code class="highlighter-rouge">title</code>, <code class="highlighter-rouge">url</code>, and <code class="highlighter-rouge">description</code>.</p>
553
+ <p>Make sure your <code class="language-plaintext highlighter-rouge">_config.yml</code> file has properties for <code class="language-plaintext highlighter-rouge">title</code>, <code class="language-plaintext highlighter-rouge">url</code>, and <code class="language-plaintext highlighter-rouge">description</code>.</p>
553
554
 
554
- <p>This code uses a <code class="highlighter-rouge">for</code> loop to look through your last 20 posts. The content from the posts gets escaped and truncated to the last 400 characters using <a href="https://help.shopify.com/themes/liquid/filters">Liquid filters</a>.</p>
555
+ <p>This code uses a <code class="language-plaintext highlighter-rouge">for</code> loop to look through your last 20 posts. The content from the posts gets escaped and truncated to the last 400 characters using <a href="https://help.shopify.com/themes/liquid/filters">Liquid filters</a>.</p>
555
556
 
556
- <p>In your <code class="highlighter-rouge">default.html</code> layout, look for a reference to the RSS or Atom feed in your header, and replace it with a reference to the file you just created. For example:</p>
557
+ <p>In your <code class="language-plaintext highlighter-rouge">default.html</code> layout, look for a reference to the RSS or Atom feed in your header, and replace it with a reference to the file you just created. For example:</p>
557
558
 
558
559
  <div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;link</span> <span class="na">rel=</span><span class="s">"alternate"</span> <span class="na">type=</span><span class="s">"application/rss+xml"</span> <span class="na">href=</span><span class="s">"{{ site.url }}/feed.xml"</span> <span class="na">title=</span><span class="s">"{{ site.title }}"</span><span class="nt">&gt;</span>
559
560
  </code></pre></div></div>
560
561
 
561
- <p>You can also auto-generate your posts feed by adding a gem called <a href="https://help.github.com/articles/atom-rss-feeds-for-github-pages/"><code class="highlighter-rouge">jekyll-feed</code></a>. This gem will also work on GitHub Pages.</p>
562
+ <p>You can also auto-generate your posts feed by adding a gem called <a href="https://help.github.com/articles/atom-rss-feeds-for-github-pages/"><code class="language-plaintext highlighter-rouge">jekyll-feed</code></a>. This gem will also work on GitHub Pages.</p>
562
563
 
563
564
  <h2 id="11-add-a-sitemap">11. Add a sitemap</h2>
564
565
 
565
- <p>Finally, add a <a href="https://www.sitemaps.org/protocol.html">site map</a>. Create a <code class="highlighter-rouge">sitemap.xml</code> file in your root directory and add this code:</p>
566
+ <p>Finally, add a <a href="https://www.sitemaps.org/protocol.html">site map</a>. Create a <code class="language-plaintext highlighter-rouge">sitemap.xml</code> file in your root directory and add this code:</p>
566
567
 
567
568
  <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
568
569
  layout: null
@@ -593,9 +594,9 @@ search: exclude
593
594
  <span class="nt">&lt;/urlset&gt;</span>
594
595
  </code></pre></div></div>
595
596
 
596
- <p>Again, we’re using a <code class="highlighter-rouge">for</code> loop here to iterate through all posts and pages to add them to the sitemap.</p>
597
+ <p>Again, we’re using a <code class="language-plaintext highlighter-rouge">for</code> loop here to iterate through all posts and pages to add them to the sitemap.</p>
597
598
 
598
- <p>You can also auto-generate your sitemap by adding a gem called <a href="https://help.github.com/articles/sitemaps-for-github-pages/"><code class="highlighter-rouge">jekyll-sitemap</code></a>. This gem will also work on GitHub Pages.</p>
599
+ <p>You can also auto-generate your sitemap by adding a gem called <a href="https://help.github.com/articles/sitemaps-for-github-pages/"><code class="language-plaintext highlighter-rouge">jekyll-sitemap</code></a>. This gem will also work on GitHub Pages.</p>
599
600
 
600
601
  <h2 id="12-add-external-services">12. Add external services</h2>
601
602
 
@@ -612,11 +613,11 @@ search: exclude
612
613
 
613
614
  <p>Your Jekyll pages consist of HTML, CSS, and JavaScript, so pretty much any code you need to embed will work without a problem.</p>
614
615
 
615
- <p>As you integrate code for these services, note that <strong>if a page in your Jekyll site doesn’t have front matter tags, Jekyll won’t process any of the content in that page.</strong> The page will just be passed to the <code class="highlighter-rouge">_site</code> folder when you build your site.</p>
616
+ <p>As you integrate code for these services, note that <strong>if a page in your Jekyll site doesn’t have front matter tags, Jekyll won’t process any of the content in that page.</strong> The page will just be passed to the <code class="language-plaintext highlighter-rouge">_site</code> folder when you build your site.</p>
616
617
 
617
- <p>If you do want Jekyll to process some page content (for example, to populate a variable that you define in your site’s config file), just add front matter tags to the page. If you don’t want any layout applied to the page, specify <code class="highlighter-rouge">layout: null</code> like this:</p>
618
+ <p>If you do want Jekyll to process some page content (for example, to populate a variable that you define in your site’s config file), just add front matter tags to the page. If you don’t want any layout applied to the page, specify <code class="language-plaintext highlighter-rouge">layout: null</code> like this:</p>
618
619
 
619
- <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
620
+ <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
620
621
  layout: null
621
622
  ---
622
623
  </code></pre></div></div>
@@ -627,7 +628,7 @@ layout: null
627
628
 
628
629
  <p>To deploy your site, consider using <a href="https://pages.github.com/">GitHub Pages</a>, <a href="https://www.netlify.com/">Netlify</a>, <a href="https://aws.amazon.com/s3/">Amazon AWS S3</a> using the <a href="https://github.com/laurilehmijoki/s3_website">s3_website plugin</a>, or just FTP your files to your web server.</p>
629
630
 
630
- <p>You can also package your layouts, includes and assets into a Ruby <code class="highlighter-rouge">gem</code> and <a href="/docs/themes/#creating-a-theme">make it a Jekyll theme</a>.</p>
631
+ <p>You can also package your layouts, includes and assets into a Ruby <code class="language-plaintext highlighter-rouge">gem</code> and <a href="/docs/themes/#creating-a-theme">make it a Jekyll theme</a>.</p>
631
632
 
632
633
  <h2 id="additional-resources">Additional resources</h2>
633
634
 
@@ -735,7 +736,7 @@ layout: null
735
736
  <footer>
736
737
  <div class="grid">
737
738
  <div class="unit one-third center-on-mobiles">
738
- <p>The contents of this website are <br />&copy;&nbsp;2018 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT&nbsp;License</a>.</p>
739
+ <p>The contents of this website are <br />&copy;&nbsp;2020 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT&nbsp;License</a>.</p>
739
740
  </div>
740
741
  <div class="unit two-thirds align-right center-on-mobiles">
741
742
  <p>