jekyll-docs 3.5.2 → 3.6.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (127) hide show
  1. checksums.yaml +4 -4
  2. data/site/404.html +3 -3
  3. data/site/community/index.html +5 -5
  4. data/site/docs/assets/index.html +14 -22
  5. data/site/docs/code_of_conduct/index.html +730 -0
  6. data/site/docs/collections/index.html +65 -80
  7. data/site/docs/conduct/index.html +4 -4
  8. data/site/docs/configuration/index.html +130 -156
  9. data/site/docs/continuous-integration/buddyworks/index.html +14 -16
  10. data/site/docs/continuous-integration/circleci/index.html +13 -21
  11. data/site/docs/continuous-integration/index.html +5 -5
  12. data/site/docs/continuous-integration/travis-ci/index.html +45 -73
  13. data/site/docs/contributing/index.html +10 -10
  14. data/site/docs/datafiles/index.html +37 -53
  15. data/site/docs/deployment-methods/index.html +54 -64
  16. data/site/docs/drafts/index.html +6 -8
  17. data/site/docs/extras/index.html +8 -12
  18. data/site/docs/frontmatter/index.html +10 -14
  19. data/site/docs/github-pages/index.html +10 -14
  20. data/site/docs/history/index.html +539 -440
  21. data/site/docs/home/index.html +4 -4
  22. data/site/docs/includes/index.html +42 -70
  23. data/site/docs/installation/index.html +23 -37
  24. data/site/docs/maintaining/affinity-team-captain/index.html +4 -4
  25. data/site/docs/maintaining/avoiding-burnout/index.html +4 -4
  26. data/site/docs/maintaining/becoming-a-maintainer/index.html +4 -4
  27. data/site/docs/maintaining/index.html +4 -4
  28. data/site/docs/maintaining/merging-a-pull-request/index.html +6 -8
  29. data/site/docs/maintaining/reviewing-a-pull-request/index.html +4 -4
  30. data/site/docs/maintaining/special-labels/index.html +4 -4
  31. data/site/docs/maintaining/triaging-an-issue/index.html +4 -4
  32. data/site/docs/migrations/index.html +4 -4
  33. data/site/docs/pages/index.html +8 -12
  34. data/site/docs/pagination/index.html +13 -21
  35. data/site/docs/permalinks/index.html +43 -34
  36. data/site/docs/plugins/index.html +51 -79
  37. data/site/docs/posts/index.html +26 -48
  38. data/site/docs/quickstart/index.html +6 -8
  39. data/site/docs/resources/index.html +45 -21
  40. data/site/docs/sites/index.html +4 -4
  41. data/site/docs/static-files/index.html +12 -16
  42. data/site/docs/structure/index.html +6 -8
  43. data/site/docs/templates/index.html +36 -68
  44. data/site/docs/themes/index.html +32 -49
  45. data/site/docs/troubleshooting/index.html +44 -82
  46. data/site/docs/upgrading/0-to-2/index.html +7 -9
  47. data/site/docs/upgrading/2-to-3/index.html +19 -31
  48. data/site/docs/upgrading/index.html +4 -4
  49. data/site/docs/usage/index.html +20 -30
  50. data/site/docs/variables/index.html +26 -10
  51. data/site/docs/windows/index.html +36 -58
  52. data/site/feed.xml +47 -53
  53. data/site/help/index.html +3 -3
  54. data/site/index.html +3 -3
  55. data/site/latest_version.txt +1 -1
  56. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +16 -8
  57. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +16 -8
  58. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +16 -8
  59. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +16 -8
  60. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +16 -8
  61. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +16 -8
  62. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +16 -8
  63. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +16 -8
  64. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +16 -8
  65. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +16 -8
  66. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +16 -8
  67. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +16 -8
  68. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +16 -8
  69. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +16 -8
  70. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +16 -8
  71. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +16 -8
  72. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +16 -8
  73. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +16 -8
  74. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +16 -8
  75. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +16 -8
  76. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +16 -8
  77. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +16 -8
  78. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +16 -8
  79. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +16 -8
  80. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +16 -8
  81. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +16 -8
  82. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +16 -8
  83. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +16 -8
  84. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +16 -8
  85. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +16 -8
  86. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +16 -8
  87. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +16 -8
  88. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +16 -8
  89. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +17 -9
  90. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +16 -8
  91. data/site/news/2015/10/26/jekyll-3-0-released/index.html +16 -8
  92. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +16 -8
  93. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +16 -8
  94. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +16 -8
  95. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +16 -8
  96. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +16 -8
  97. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +16 -8
  98. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +16 -8
  99. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +20 -12
  100. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +16 -8
  101. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +16 -8
  102. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +16 -8
  103. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +16 -8
  104. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +16 -8
  105. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +16 -8
  106. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +16 -8
  107. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +16 -8
  108. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +16 -8
  109. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +16 -8
  110. data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +16 -8
  111. data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +16 -8
  112. data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +27 -29
  113. data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +23 -17
  114. data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +20 -14
  115. data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +21 -13
  116. data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +18 -10
  117. data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +573 -0
  118. data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +565 -0
  119. data/site/news/index.html +122 -48
  120. data/site/news/releases/index.html +122 -48
  121. data/site/sitemap.xml +64 -52
  122. data/site/tutorials/convert-site-to-jekyll/index.html +80 -138
  123. data/site/tutorials/custom-404-page/index.html +13 -21
  124. data/site/tutorials/home/index.html +4 -4
  125. data/site/tutorials/navigation/index.html +144 -180
  126. data/site/tutorials/orderofinterpretation/index.html +27 -45
  127. metadata +8 -5
data/site/sitemap.xml CHANGED
@@ -2,191 +2,195 @@
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>2017-08-12T13:36:54-07:00</lastmod>
5
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
6
+ </url>
7
+ <url>
8
+ <loc>https://jekyllrb.com/docs/code_of_conduct/</loc>
9
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
6
10
  </url>
7
11
  <url>
8
12
  <loc>https://jekyllrb.com/docs/collections/</loc>
9
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
13
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
10
14
  </url>
11
15
  <url>
12
16
  <loc>https://jekyllrb.com/docs/conduct/</loc>
13
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
17
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
14
18
  </url>
15
19
  <url>
16
20
  <loc>https://jekyllrb.com/docs/configuration/</loc>
17
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
21
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
18
22
  </url>
19
23
  <url>
20
24
  <loc>https://jekyllrb.com/docs/continuous-integration/buddyworks/</loc>
21
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
25
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
22
26
  </url>
23
27
  <url>
24
28
  <loc>https://jekyllrb.com/docs/continuous-integration/circleci/</loc>
25
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
29
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
26
30
  </url>
27
31
  <url>
28
32
  <loc>https://jekyllrb.com/docs/continuous-integration/</loc>
29
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
33
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
30
34
  </url>
31
35
  <url>
32
36
  <loc>https://jekyllrb.com/docs/continuous-integration/travis-ci/</loc>
33
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
37
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
34
38
  </url>
35
39
  <url>
36
40
  <loc>https://jekyllrb.com/docs/contributing/</loc>
37
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
41
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
38
42
  </url>
39
43
  <url>
40
44
  <loc>https://jekyllrb.com/docs/datafiles/</loc>
41
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
45
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
42
46
  </url>
43
47
  <url>
44
48
  <loc>https://jekyllrb.com/docs/deployment-methods/</loc>
45
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
49
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
46
50
  </url>
47
51
  <url>
48
52
  <loc>https://jekyllrb.com/docs/drafts/</loc>
49
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
53
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
50
54
  </url>
51
55
  <url>
52
56
  <loc>https://jekyllrb.com/docs/extras/</loc>
53
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
57
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
54
58
  </url>
55
59
  <url>
56
60
  <loc>https://jekyllrb.com/docs/frontmatter/</loc>
57
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
61
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
58
62
  </url>
59
63
  <url>
60
64
  <loc>https://jekyllrb.com/docs/github-pages/</loc>
61
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
65
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
62
66
  </url>
63
67
  <url>
64
68
  <loc>https://jekyllrb.com/docs/history/</loc>
65
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
69
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
66
70
  </url>
67
71
  <url>
68
72
  <loc>https://jekyllrb.com/docs/includes/</loc>
69
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
73
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
70
74
  </url>
71
75
  <url>
72
76
  <loc>https://jekyllrb.com/docs/home/</loc>
73
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
77
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
74
78
  </url>
75
79
  <url>
76
80
  <loc>https://jekyllrb.com/docs/installation/</loc>
77
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
81
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
78
82
  </url>
79
83
  <url>
80
84
  <loc>https://jekyllrb.com/docs/maintaining/affinity-team-captain/</loc>
81
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
85
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
82
86
  </url>
83
87
  <url>
84
88
  <loc>https://jekyllrb.com/docs/maintaining/avoiding-burnout/</loc>
85
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
89
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
86
90
  </url>
87
91
  <url>
88
92
  <loc>https://jekyllrb.com/docs/maintaining/becoming-a-maintainer/</loc>
89
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
93
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
90
94
  </url>
91
95
  <url>
92
96
  <loc>https://jekyllrb.com/docs/maintaining/</loc>
93
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
97
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
94
98
  </url>
95
99
  <url>
96
100
  <loc>https://jekyllrb.com/docs/maintaining/merging-a-pull-request/</loc>
97
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
101
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
98
102
  </url>
99
103
  <url>
100
104
  <loc>https://jekyllrb.com/docs/maintaining/reviewing-a-pull-request/</loc>
101
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
105
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
102
106
  </url>
103
107
  <url>
104
108
  <loc>https://jekyllrb.com/docs/maintaining/special-labels/</loc>
105
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
109
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
106
110
  </url>
107
111
  <url>
108
112
  <loc>https://jekyllrb.com/docs/maintaining/triaging-an-issue/</loc>
109
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
113
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
110
114
  </url>
111
115
  <url>
112
116
  <loc>https://jekyllrb.com/docs/migrations/</loc>
113
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
117
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
114
118
  </url>
115
119
  <url>
116
120
  <loc>https://jekyllrb.com/docs/pages/</loc>
117
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
121
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
118
122
  </url>
119
123
  <url>
120
124
  <loc>https://jekyllrb.com/docs/pagination/</loc>
121
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
125
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
122
126
  </url>
123
127
  <url>
124
128
  <loc>https://jekyllrb.com/docs/permalinks/</loc>
125
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
129
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
126
130
  </url>
127
131
  <url>
128
132
  <loc>https://jekyllrb.com/docs/plugins/</loc>
129
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
133
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
130
134
  </url>
131
135
  <url>
132
136
  <loc>https://jekyllrb.com/docs/posts/</loc>
133
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
137
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
134
138
  </url>
135
139
  <url>
136
140
  <loc>https://jekyllrb.com/docs/quickstart/</loc>
137
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
141
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
138
142
  </url>
139
143
  <url>
140
144
  <loc>https://jekyllrb.com/docs/resources/</loc>
141
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
145
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
142
146
  </url>
143
147
  <url>
144
148
  <loc>https://jekyllrb.com/docs/sites/</loc>
145
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
149
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
146
150
  </url>
147
151
  <url>
148
152
  <loc>https://jekyllrb.com/docs/static-files/</loc>
149
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
153
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
150
154
  </url>
151
155
  <url>
152
156
  <loc>https://jekyllrb.com/docs/structure/</loc>
153
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
157
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
154
158
  </url>
155
159
  <url>
156
160
  <loc>https://jekyllrb.com/docs/templates/</loc>
157
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
161
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
158
162
  </url>
159
163
  <url>
160
164
  <loc>https://jekyllrb.com/docs/themes/</loc>
161
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
165
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
162
166
  </url>
163
167
  <url>
164
168
  <loc>https://jekyllrb.com/docs/troubleshooting/</loc>
165
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
169
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
166
170
  </url>
167
171
  <url>
168
172
  <loc>https://jekyllrb.com/docs/upgrading/</loc>
169
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
173
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
170
174
  </url>
171
175
  <url>
172
176
  <loc>https://jekyllrb.com/docs/upgrading/0-to-2/</loc>
173
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
177
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
174
178
  </url>
175
179
  <url>
176
180
  <loc>https://jekyllrb.com/docs/upgrading/2-to-3/</loc>
177
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
181
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
178
182
  </url>
179
183
  <url>
180
184
  <loc>https://jekyllrb.com/docs/usage/</loc>
181
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
185
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
182
186
  </url>
183
187
  <url>
184
188
  <loc>https://jekyllrb.com/docs/variables/</loc>
185
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
189
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
186
190
  </url>
187
191
  <url>
188
192
  <loc>https://jekyllrb.com/docs/windows/</loc>
189
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
193
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
190
194
  </url>
191
195
  <url>
192
196
  <loc>https://jekyllrb.com/news/2013/05/05/jekyll-1-0-0-released/</loc>
@@ -433,24 +437,32 @@
433
437
  <lastmod>2017-07-17T09:40:37-07:00</lastmod>
434
438
  </url>
435
439
  <url>
440
+ <loc>https://jekyllrb.com/news/2017/08/12/jekyll-3-5-2-released/</loc>
441
+ <lastmod>2017-08-12T13:31:40-07:00</lastmod>
442
+ </url>
443
+ <url>
444
+ <loc>https://jekyllrb.com/news/2017/09/21/jekyll-3-6-0-released/</loc>
445
+ <lastmod>2017-09-21T13:38:20-07:00</lastmod>
446
+ </url>
447
+ <url>
436
448
  <loc>https://jekyllrb.com/tutorials/convert-site-to-jekyll/</loc>
437
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
449
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
438
450
  </url>
439
451
  <url>
440
452
  <loc>https://jekyllrb.com/tutorials/custom-404-page/</loc>
441
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
453
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
442
454
  </url>
443
455
  <url>
444
456
  <loc>https://jekyllrb.com/tutorials/home/</loc>
445
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
457
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
446
458
  </url>
447
459
  <url>
448
460
  <loc>https://jekyllrb.com/tutorials/navigation/</loc>
449
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
461
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
450
462
  </url>
451
463
  <url>
452
464
  <loc>https://jekyllrb.com/tutorials/orderofinterpretation/</loc>
453
- <lastmod>2017-08-12T13:36:54-07:00</lastmod>
465
+ <lastmod>2017-10-24T08:07:43-07:00</lastmod>
454
466
  </url>
455
467
  <url>
456
468
  <loc>https://jekyllrb.com/</loc>
@@ -4,13 +4,13 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.5.2">
7
+ <meta name="generator" content="Jekyll v3.6.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
11
  <link rel="stylesheet" href="/css/screen.css">
12
12
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.2.3 -->
13
+ <!-- Begin Jekyll SEO tag v2.3.0 -->
14
14
  <title>Convert an HTML site to Jekyll | Jekyll • Simple, blog-aware, static sites</title>
15
15
  <meta property="og:title" content="Convert an HTML site to Jekyll">
16
16
  <meta property="og:locale" content="en_US">
@@ -20,12 +20,12 @@
20
20
  <meta property="og:url" content="https://jekyllrb.com/tutorials/convert-site-to-jekyll/">
21
21
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
22
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-08-12T13:36:54-07:00">
23
+ <meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
24
24
  <meta name="twitter:card" content="summary">
25
25
  <meta name="twitter:site" content="@jekyllrb">
26
26
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
27
  <script type="application/ld+json">
28
- {"@context":"http://schema.org","@type":"BlogPosting","headline":"Convert an HTML site to Jekyll","datePublished":"2017-08-12T13:36:54-07:00","dateModified":"2017-08-12T13:36:54-07:00","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"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/tutorials/convert-site-to-jekyll/"},"url":"https://jekyllrb.com/tutorials/convert-site-to-jekyll/"}</script>
28
+ {"name":null,"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.","url":"https://jekyllrb.com/tutorials/convert-site-to-jekyll/","headline":"Convert an HTML site to Jekyll","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/tutorials/convert-site-to-jekyll/"},"@context":"http://schema.org"}</script>
29
29
  <!-- End Jekyll SEO tag -->
30
30
 
31
31
  <!--[if lt IE 9]>
@@ -152,49 +152,40 @@
152
152
 
153
153
  <p>We’ll start with a <em>basic Jekyll site</em> consisting of three files:</p>
154
154
 
155
- <div class="highlighter-rouge">
156
- <pre class="highlight"><code>├── _config.yml
155
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>├── _config.yml
157
156
  ├── _layouts
158
157
  │   └── default.html
159
158
  └── index.md
160
- </code></pre>
161
- </div>
159
+ </code></pre></div></div>
162
160
 
163
161
  <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>
164
162
 
165
- <div class="language-sh highlighter-rouge">
166
- <pre class="highlight"><code><span class="gp">$ </span>touch _config.yml index.md default.html
167
- <span class="gp">$ </span>mkdir _layouts <span class="o">&amp;&amp;</span> mv default.html _layouts
168
- </code></pre>
169
- </div>
163
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>touch _config.yml index.md default.html
164
+ <span class="nv">$ </span>mkdir _layouts <span class="o">&amp;&amp;</span> mv default.html _layouts
165
+ </code></pre></div></div>
170
166
 
171
167
  <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>
172
168
 
173
169
  <p><strong>_config.yml</strong></p>
174
170
 
175
- <div class="language-yaml highlighter-rouge">
176
- <pre class="highlight"><code><span class="s">name</span><span class="pi">:</span> <span class="s">My Jekyll Website</span>
177
- </code></pre>
178
- </div>
171
+ <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">name</span><span class="pi">:</span> <span class="s">My Jekyll Website</span>
172
+ </code></pre></div></div>
179
173
 
180
174
  <p><strong>_layouts/default.html</strong></p>
181
175
 
182
- <div class="language-html highlighter-rouge">
183
- <pre class="highlight"><code><span class="cp">&lt;!DOCTYPE html&gt;</span>
176
+ <div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">&lt;!DOCTYPE html&gt;</span>
184
177
  <span class="nt">&lt;html&gt;</span>
185
178
  <span class="nt">&lt;body&gt;</span>
186
179
  {{ content }}
187
180
  <span class="nt">&lt;/body&gt;</span>
188
181
  <span class="nt">&lt;/html&gt;</span>
189
- </code></pre>
190
- </div>
182
+ </code></pre></div></div>
191
183
 
192
184
  <p><strong>index.md</strong></p>
193
185
 
194
- <div class="language-yaml highlighter-rouge">
195
- <pre class="highlight"><code><span class="nn">---</span>
196
- <span class="s">title</span><span class="pi">:</span> <span class="s">My page</span>
197
- <span class="s">layout</span><span class="pi">:</span> <span class="s">default</span>
186
+ <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
187
+ <span class="na">title</span><span class="pi">:</span> <span class="s">My page</span>
188
+ <span class="na">layout</span><span class="pi">:</span> <span class="s">default</span>
198
189
  <span class="nn">---</span>
199
190
 
200
191
  <span class="c1"># {{ page.title }}</span>
@@ -204,16 +195,13 @@
204
195
  <span class="s">&lt;!--</span>
205
196
  <span class="s">You can use HTML elements in Markdown, such as the comment element, and they won't be affected by a markdown parser. However, if you create an HTML element in your markdown file, you cannot use markdown syntax within that element's contents.</span>
206
197
  <span class="s">--&gt;</span>
207
- </code></pre>
208
- </div>
198
+ </code></pre></div></div>
209
199
 
210
200
  <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>
211
201
 
212
- <div class="highlighter-rouge">
213
- <pre class="highlight"><code>cd my_jekyll_site
202
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>cd my_jekyll_site
214
203
  jekyll serve
215
- </code></pre>
216
- </div>
204
+ </code></pre></div></div>
217
205
 
218
206
  <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>
219
207
 
@@ -224,7 +212,7 @@ jekyll serve
224
212
  <ul>
225
213
  <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>
226
214
  <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>
227
- <li>Jekyll pushes the content from all pages and posts into the <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">content</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></code> variable in the layout specified (<code class="highlighter-rouge">default</code>) in the front matter tags.</li>
215
+ <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>
228
216
  <li>The processed files get written as <code class="highlighter-rouge">.html</code> files in the <code class="highlighter-rouge">_site</code> directory.</li>
229
217
  </ul>
230
218
 
@@ -250,27 +238,21 @@ jekyll serve
250
238
 
251
239
  <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>
252
240
 
253
- <div class="language-liquid highlighter-rouge">
254
- <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>
255
- </code></pre>
256
- </div>
241
+ <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>
242
+ </code></pre></div></div>
257
243
 
258
244
  <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>
259
245
 
260
246
  <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>
261
247
 
262
- <div class="language-liquid highlighter-rouge">
263
- <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>
264
- </code></pre>
265
- </div>
248
+ <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>
249
+ </code></pre></div></div>
266
250
 
267
251
  <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
252
 
269
- <div class="highlighter-rouge">
270
- <pre class="highlight"><code>url: http://mysite.com
253
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>url: http://mysite.com
271
254
  baseurl: /blog
272
- </code></pre>
273
- </div>
255
+ </code></pre></div></div>
274
256
 
275
257
  <p>The result in the output will be <code class="highlighter-rouge">http://mysite.com/blog/assets/style.css</code>.</p>
276
258
 
@@ -284,9 +266,9 @@ baseurl: /blog
284
266
 
285
267
  <h2 id="2-identify-the-content-part-of-the-layout">2. Identify the content part of the layout</h2>
286
268
 
287
- <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"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">page.title</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></code>.</p>
269
+ <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>
288
270
 
289
- <p>Remove the content part (keep everything else: navigation menu, sidebar, footer, etc.) and replace it with <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">content</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></code>.</p>
271
+ <p>Remove the content part (keep everything else: navigation menu, sidebar, footer, etc.) and replace it with <code class="highlighter-rouge">{{ content }}</code>.</p>
290
272
 
291
273
  <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>
292
274
 
@@ -296,15 +278,13 @@ baseurl: /blog
296
278
 
297
279
  <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>
298
280
 
299
- <div class="language-yaml highlighter-rouge">
300
- <pre class="highlight"><code><span class="nn">---</span>
301
- <span class="s">title</span><span class="pi">:</span> <span class="s">Home</span>
302
- <span class="s">layout</span><span class="pi">:</span> <span class="s">default</span>
281
+ <div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
282
+ <span class="na">title</span><span class="pi">:</span> <span class="s">Home</span>
283
+ <span class="na">layout</span><span class="pi">:</span> <span class="s">default</span>
303
284
  <span class="nn">---</span>
304
285
 
305
286
  <span class="s">Some page content here...</span>
306
- </code></pre>
307
- </div>
287
+ </code></pre></div></div>
308
288
 
309
289
  <p>Create another page for testing called <code class="highlighter-rouge">about.md</code> with similar front matter tags.</p>
310
290
 
@@ -314,21 +294,17 @@ baseurl: /blog
314
294
 
315
295
  <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>
316
296
 
317
- <div class="highlighter-rouge">
318
- <pre class="highlight"><code>markdown: kramdown
319
- </code></pre>
320
- </div>
297
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>markdown: kramdown
298
+ </code></pre></div></div>
321
299
 
322
300
  <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>
323
301
 
324
- <div class="highlighter-rouge">
325
- <pre class="highlight"><code>kramdown:
302
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>kramdown:
326
303
  input: GFM
327
304
  auto_ids: true
328
305
  hard_wrap: false
329
306
  syntax_highlighter: rouge
330
- </code></pre>
331
- </div>
307
+ </code></pre></div></div>
332
308
 
333
309
  <h2 id="5-test-your-pages">5. Test your pages</h2>
334
310
 
@@ -338,13 +314,11 @@ baseurl: /blog
338
314
 
339
315
  <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>
340
316
 
341
- <div class="highlighter-rouge">
342
- <pre class="highlight"><code>---
317
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
343
318
  title: Sample page
344
319
  layout: homepage
345
320
  ---
346
- </code></pre>
347
- </div>
321
+ </code></pre></div></div>
348
322
 
349
323
  <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>
350
324
 
@@ -352,28 +326,22 @@ layout: homepage
352
326
 
353
327
  <h2 id="6-configure-site-variables">6. Configure site variables</h2>
354
328
 
355
- <p>You already configured the page title using <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">page.title</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></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>
329
+ <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>
356
330
 
357
331
  <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>
358
332
 
359
- <div class="highlighter-rouge">
360
- <pre class="highlight"><code>&lt;title&gt;ACME Website&lt;/title&gt;
361
- </code></pre>
362
- </div>
333
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>&lt;title&gt;ACME Website&lt;/title&gt;
334
+ </code></pre></div></div>
363
335
 
364
336
  <p>Insert the following site variables:</p>
365
337
 
366
- <div class="highlighter-rouge">
367
- <pre class="highlight"><code>&lt;title&gt;{{ page.title }} | {{ site.title }}&lt;/title&gt;
368
- </code></pre>
369
- </div>
338
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>&lt;title&gt;{{ page.title }} | {{ site.title }}&lt;/title&gt;
339
+ </code></pre></div></div>
370
340
 
371
341
  <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>
372
342
 
373
- <div class="highlighter-rouge">
374
- <pre class="highlight"><code>title: ACME Website
375
- </code></pre>
376
- </div>
343
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>title: ACME Website
344
+ </code></pre></div></div>
377
345
 
378
346
  <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>
379
347
 
@@ -397,20 +365,17 @@ layout: homepage
397
365
 
398
366
  <p>In each post, add some basic content:</p>
399
367
 
400
- <div class="highlighter-rouge">
401
- <pre class="highlight"><code>---
368
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
402
369
  title: My First Post
403
370
  layout: default
404
371
  ---
405
372
 
406
373
  Some sample content...
407
- </code></pre>
408
- </div>
374
+ </code></pre></div></div>
409
375
 
410
376
  <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>
411
377
 
412
- <div class="highlighter-rouge">
413
- <pre class="highlight"><code>---
378
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
414
379
  layout: default
415
380
  ---
416
381
 
@@ -422,37 +387,34 @@ layout: default
422
387
  &lt;/li&gt;
423
388
  {% endfor %}
424
389
  &lt;/ul&gt;
425
- </code></pre>
426
- </div>
390
+ </code></pre></div></div>
427
391
 
428
392
  <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>
429
393
 
430
- <div class="highlighter-rouge">
431
- <pre class="highlight"><code>---
394
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
432
395
  title: Blog
433
396
  layout: home
434
397
  ---
435
- </code></pre>
436
- </div>
398
+ </code></pre></div></div>
437
399
 
438
- <p>In this case, contents of <code class="highlighter-rouge">blog.md</code> will be pushed into the <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">content</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></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"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">content</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></code> tag of the <code class="highlighter-rouge">default</code> layout.</p>
400
+ <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>
439
401
 
440
402
  <h3 id="how-layouts-work">How layouts work</h3>
441
403
 
442
- <p>When a layout specifies another layout, it means the content of the first layout will be stuffed into the <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">content</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></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>
404
+ <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>
443
405
 
444
406
  <p>The following diagram shows how layouts work in Jekyll:</p>
445
407
 
446
408
  <p><img src="../../img/jekylllayoutconcept.png" alt="Concept of Jekyll layouts"></p>
447
409
 
448
- <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"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">content</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></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"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">content</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></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"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">content</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></code> tag of the layout file <code class="highlighter-rouge">default.html</code>.</p>
410
+ <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>
449
411
 
450
412
  <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>
451
413
 
452
414
  <p>In your browser, go to <code class="highlighter-rouge">blog.html</code> and see the list of posts.
453
415
  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>
454
416
 
455
- <p class="note info">At minimum, a layout should contain <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span><span class="w"> </span><span class="err">content</span><span class="w"> </span><span class="p">}</span><span class="err">}</span></code>, which acts as a receiver for the <em>content</em> to be rendered.</p>
417
+ <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>
456
418
 
457
419
  <h3 id="for-loops">For loops</h3>
458
420
 
@@ -460,15 +422,13 @@ Note that you don’t have to use the method described here. You could have simp
460
422
 
461
423
  <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>
462
424
 
463
- <div class="language-liquid highlighter-rouge">
464
- <pre class="highlight"><code>&lt;ul class="myposts"&gt;
425
+ <div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code>&lt;ul class="myposts"&gt;
465
426
  <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>
466
427
  &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;
467
428
  &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;
468
429
  &lt;/li&gt;
469
430
  <span class="p">{%</span><span class="w"> </span><span class="nt">endfor</span><span class="w"> </span><span class="p">%}</span>
470
- </code></pre>
471
- </div>
431
+ </code></pre></div></div>
472
432
 
473
433
  <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>
474
434
 
@@ -480,25 +440,21 @@ Note that you don’t have to use the method described here. You could have simp
480
440
 
481
441
  <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>
482
442
 
483
- <div class="language-html highlighter-rouge">
484
- <pre class="highlight"><code><span class="nt">&lt;ul&gt;</span>
443
+ <div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;ul&gt;</span>
485
444
  {% assign mypages = site.pages | sort: "order" %}
486
445
  {% for page in mypages %}
487
446
  <span class="nt">&lt;li&gt;&lt;a</span> <span class="na">href=</span><span class="s">"{{ page.url | absolute_url }}"</span><span class="nt">&gt;</span>{{ page.title }}<span class="nt">&lt;/a&gt;&lt;/li&gt;</span>
488
447
  {% endfor %}
489
448
  <span class="nt">&lt;/ul&gt;</span>
490
- </code></pre>
491
- </div>
449
+ </code></pre></div></div>
492
450
 
493
451
  <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>
494
452
 
495
- <div class="highlighter-rouge">
496
- <pre class="highlight"><code>---
453
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
497
454
  title: My page
498
455
  order: 2
499
456
  ---
500
- </code></pre>
501
- </div>
457
+ </code></pre></div></div>
502
458
 
503
459
  <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>
504
460
 
@@ -506,17 +462,15 @@ order: 2
506
462
 
507
463
  <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>
508
464
 
509
- <div class="language-yaml highlighter-rouge">
510
- <pre class="highlight"><code><span class="pi">-</span> <span class="s">title</span><span class="pi">:</span> <span class="s">Sample page 1</span>
511
- <span class="s">url</span><span class="pi">:</span> <span class="s">/page-1-permalink/</span>
465
+ <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>
466
+ <span class="na">url</span><span class="pi">:</span> <span class="s">/page-1-permalink/</span>
512
467
 
513
- <span class="pi">-</span> <span class="s">title</span><span class="pi">:</span> <span class="s">Sample page 2</span>
514
- <span class="s">url</span><span class="pi">:</span> <span class="s">/page-2-permalink/</span>
468
+ <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s">Sample page 2</span>
469
+ <span class="na">url</span><span class="pi">:</span> <span class="s">/page-2-permalink/</span>
515
470
 
516
- <span class="pi">-</span> <span class="s">title</span><span class="pi">:</span> <span class="s">Sample page 3</span>
517
- <span class="s">url</span><span class="pi">:</span> <span class="s">/page-3-permalink/</span>
518
- </code></pre>
519
- </div>
471
+ <span class="pi">-</span> <span class="na">title</span><span class="pi">:</span> <span class="s">Sample page 3</span>
472
+ <span class="na">url</span><span class="pi">:</span> <span class="s">/page-3-permalink/</span>
473
+ </code></pre></div></div>
520
474
 
521
475
  <p class="note info">If you never wrote any YAML before, you’ll get quickly familiar with it. Take a look at <a href="https://learnxinyminutes.com/docs/yaml/">what you can do with YAML</a>.</p>
522
476
 
@@ -524,14 +478,12 @@ order: 2
524
478
 
525
479
  <p>To print the list of pages from the data file, use code like this:</p>
526
480
 
527
- <div class="language-html highlighter-rouge">
528
- <pre class="highlight"><code><span class="nt">&lt;ul&gt;</span>
481
+ <div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;ul&gt;</span>
529
482
  {% for link in site.data.navigation %}
530
483
  <span class="nt">&lt;li&gt;&lt;a</span> <span class="na">href=</span><span class="s">"{{ link.url }}"</span><span class="nt">&gt;</span>{{ link.title }}<span class="nt">&lt;/a&gt;&lt;/li&gt;</span>
531
484
  {% endfor %}
532
485
  <span class="nt">&lt;/ul&gt;</span>
533
- </code></pre>
534
- </div>
486
+ </code></pre></div></div>
535
487
 
536
488
  <p>If you have more sophisticated requirements around navigation, such as when building a documentation site, see the <a href="/tutorials/navigation/">detailed tutorial on navigation</a>.</p>
537
489
 
@@ -545,10 +497,8 @@ order: 2
545
497
 
546
498
  <p>Where the sidebar code previously existed in <code class="highlighter-rouge">default.html</code>, pull in your “include” like this:</p>
547
499
 
548
- <div class="language-liquid highlighter-rouge">
549
- <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>
550
- </code></pre>
551
- </div>
500
+ <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>
501
+ </code></pre></div></div>
552
502
 
553
503
  <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>
554
504
 
@@ -556,8 +506,7 @@ order: 2
556
506
 
557
507
  <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>
558
508
 
559
- <div class="language-xml highlighter-rouge">
560
- <pre class="highlight"><code>---
509
+ <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
561
510
  layout: null
562
511
  ---
563
512
 
@@ -582,8 +531,7 @@ layout: null
582
531
  {% endfor %}
583
532
  <span class="nt">&lt;/channel&gt;</span>
584
533
  <span class="nt">&lt;/rss&gt;</span>
585
- </code></pre>
586
- </div>
534
+ </code></pre></div></div>
587
535
 
588
536
  <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>
589
537
 
@@ -591,10 +539,8 @@ layout: null
591
539
 
592
540
  <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>
593
541
 
594
- <div class="language-html highlighter-rouge">
595
- <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>
596
- </code></pre>
597
- </div>
542
+ <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>
543
+ </code></pre></div></div>
598
544
 
599
545
  <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>
600
546
 
@@ -602,8 +548,7 @@ layout: null
602
548
 
603
549
  <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>
604
550
 
605
- <div class="language-xml highlighter-rouge">
606
- <pre class="highlight"><code>---
551
+ <div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
607
552
  layout: null
608
553
  search: exclude
609
554
  ---
@@ -630,8 +575,7 @@ search: exclude
630
575
  {% endfor %}
631
576
 
632
577
  <span class="nt">&lt;/urlset&gt;</span>
633
- </code></pre>
634
- </div>
578
+ </code></pre></div></div>
635
579
 
636
580
  <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>
637
581
 
@@ -660,12 +604,10 @@ search: exclude
660
604
 
661
605
  <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>
662
606
 
663
- <div class="highlighter-rouge">
664
- <pre class="highlight"><code>---
607
+ <div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>---
665
608
  layout: null
666
609
  ---
667
- </code></pre>
668
- </div>
610
+ </code></pre></div></div>
669
611
 
670
612
  <h2 id="13-conclusion">13. Conclusion</h2>
671
613