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.
- checksums.yaml +4 -4
- data/site/404.html +3 -3
- data/site/community/index.html +5 -5
- data/site/docs/assets/index.html +14 -22
- data/site/docs/code_of_conduct/index.html +730 -0
- data/site/docs/collections/index.html +65 -80
- data/site/docs/conduct/index.html +4 -4
- data/site/docs/configuration/index.html +130 -156
- data/site/docs/continuous-integration/buddyworks/index.html +14 -16
- data/site/docs/continuous-integration/circleci/index.html +13 -21
- data/site/docs/continuous-integration/index.html +5 -5
- data/site/docs/continuous-integration/travis-ci/index.html +45 -73
- data/site/docs/contributing/index.html +10 -10
- data/site/docs/datafiles/index.html +37 -53
- data/site/docs/deployment-methods/index.html +54 -64
- data/site/docs/drafts/index.html +6 -8
- data/site/docs/extras/index.html +8 -12
- data/site/docs/frontmatter/index.html +10 -14
- data/site/docs/github-pages/index.html +10 -14
- data/site/docs/history/index.html +539 -440
- data/site/docs/home/index.html +4 -4
- data/site/docs/includes/index.html +42 -70
- data/site/docs/installation/index.html +23 -37
- data/site/docs/maintaining/affinity-team-captain/index.html +4 -4
- data/site/docs/maintaining/avoiding-burnout/index.html +4 -4
- data/site/docs/maintaining/becoming-a-maintainer/index.html +4 -4
- data/site/docs/maintaining/index.html +4 -4
- data/site/docs/maintaining/merging-a-pull-request/index.html +6 -8
- data/site/docs/maintaining/reviewing-a-pull-request/index.html +4 -4
- data/site/docs/maintaining/special-labels/index.html +4 -4
- data/site/docs/maintaining/triaging-an-issue/index.html +4 -4
- data/site/docs/migrations/index.html +4 -4
- data/site/docs/pages/index.html +8 -12
- data/site/docs/pagination/index.html +13 -21
- data/site/docs/permalinks/index.html +43 -34
- data/site/docs/plugins/index.html +51 -79
- data/site/docs/posts/index.html +26 -48
- data/site/docs/quickstart/index.html +6 -8
- data/site/docs/resources/index.html +45 -21
- data/site/docs/sites/index.html +4 -4
- data/site/docs/static-files/index.html +12 -16
- data/site/docs/structure/index.html +6 -8
- data/site/docs/templates/index.html +36 -68
- data/site/docs/themes/index.html +32 -49
- data/site/docs/troubleshooting/index.html +44 -82
- data/site/docs/upgrading/0-to-2/index.html +7 -9
- data/site/docs/upgrading/2-to-3/index.html +19 -31
- data/site/docs/upgrading/index.html +4 -4
- data/site/docs/usage/index.html +20 -30
- data/site/docs/variables/index.html +26 -10
- data/site/docs/windows/index.html +36 -58
- data/site/feed.xml +47 -53
- data/site/help/index.html +3 -3
- data/site/index.html +3 -3
- data/site/latest_version.txt +1 -1
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +16 -8
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +16 -8
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +16 -8
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +16 -8
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +16 -8
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +16 -8
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +16 -8
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +16 -8
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +16 -8
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +16 -8
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +16 -8
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +16 -8
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +16 -8
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +16 -8
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +16 -8
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +16 -8
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +16 -8
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +16 -8
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +16 -8
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +16 -8
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +16 -8
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +16 -8
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +16 -8
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +16 -8
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +16 -8
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +16 -8
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +16 -8
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +16 -8
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +16 -8
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +16 -8
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +16 -8
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +16 -8
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +16 -8
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +17 -9
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +16 -8
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +16 -8
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +16 -8
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +16 -8
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +16 -8
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +16 -8
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +16 -8
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +16 -8
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +16 -8
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +20 -12
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +16 -8
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +16 -8
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +16 -8
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +16 -8
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +16 -8
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +16 -8
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +16 -8
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +16 -8
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +16 -8
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +16 -8
- data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +16 -8
- data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +16 -8
- data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +27 -29
- data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +23 -17
- data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +20 -14
- data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +21 -13
- data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +18 -10
- data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +573 -0
- data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +565 -0
- data/site/news/index.html +122 -48
- data/site/news/releases/index.html +122 -48
- data/site/sitemap.xml +64 -52
- data/site/tutorials/convert-site-to-jekyll/index.html +80 -138
- data/site/tutorials/custom-404-page/index.html +13 -21
- data/site/tutorials/home/index.html +4 -4
- data/site/tutorials/navigation/index.html +144 -180
- data/site/tutorials/orderofinterpretation/index.html +27 -45
- 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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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-
|
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.
|
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.
|
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-
|
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
|
-
{"
|
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
|
-
<
|
167
|
-
|
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">&&</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
|
-
|
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"><!DOCTYPE html></span>
|
176
|
+
<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp"><!DOCTYPE html></span>
|
184
177
|
<span class="nt"><html></span>
|
185
178
|
<span class="nt"><body></span>
|
186
179
|
{{ content }}
|
187
180
|
<span class="nt"></body></span>
|
188
181
|
<span class="nt"></html></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
|
-
<
|
196
|
-
<span class="
|
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"><!--</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">--></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"
|
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
|
-
|
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
|
-
|
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"
|
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"
|
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
|
-
<
|
301
|
-
<span class="
|
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
|
-
|
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"
|
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
|
-
|
361
|
-
</code></pre>
|
362
|
-
</div>
|
333
|
+
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code><title>ACME Website</title>
|
334
|
+
</code></pre></div></div>
|
363
335
|
|
364
336
|
<p>Insert the following site variables:</p>
|
365
337
|
|
366
|
-
<div class="highlighter-rouge"
|
367
|
-
|
368
|
-
</code></pre>
|
369
|
-
</div>
|
338
|
+
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code><title>{{ page.title }} | {{ site.title }}</title>
|
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
|
-
|
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
|
</li>
|
423
388
|
{% endfor %}
|
424
389
|
</ul>
|
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"
|
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"
|
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"
|
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"
|
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><ul class="myposts">
|
425
|
+
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><ul class="myposts">
|
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
|
<li><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>"><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></a>
|
467
428
|
<span class="postDate"><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></span>
|
468
429
|
</li>
|
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"><ul></code> element with various child <code class="highlighter-rouge"><li></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"><ul></span>
|
443
|
+
<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><ul></span>
|
485
444
|
{% assign mypages = site.pages | sort: "order" %}
|
486
445
|
{% for page in mypages %}
|
487
446
|
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"{{ page.url | absolute_url }}"</span><span class="nt">></span>{{ page.title }}<span class="nt"></a></li></span>
|
488
447
|
{% endfor %}
|
489
448
|
<span class="nt"></ul></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
|
-
<
|
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="
|
514
|
-
<span class="
|
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="
|
517
|
-
<span class="
|
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"><ul></span>
|
481
|
+
<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><ul></span>
|
529
482
|
{% for link in site.data.navigation %}
|
530
483
|
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"{{ link.url }}"</span><span class="nt">></span>{{ link.title }}<span class="nt"></a></li></span>
|
531
484
|
{% endfor %}
|
532
485
|
<span class="nt"></ul></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
|
-
|
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"></channel></span>
|
584
533
|
<span class="nt"></rss></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
|
-
|
596
|
-
</code></pre>
|
597
|
-
</div>
|
542
|
+
<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><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">></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"></urlset></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
|
|