jekyll-docs 3.2.1 → 3.3.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 +2 -2
- data/site/community/index.html +4 -4
- data/site/css/screen.css +16 -8
- data/site/docs/assets/index.html +90 -79
- data/site/docs/collections/index.html +106 -84
- data/site/docs/conduct/index.html +70 -70
- data/site/docs/configuration/index.html +143 -93
- data/site/docs/continuous-integration/index.html +137 -95
- data/site/docs/contributing/index.html +70 -70
- data/site/docs/datafiles/index.html +116 -87
- data/site/docs/deployment-methods/index.html +108 -84
- data/site/docs/drafts/index.html +75 -72
- data/site/docs/extras/index.html +74 -71
- data/site/docs/frontmatter/index.html +82 -76
- data/site/docs/github-pages/index.html +88 -83
- data/site/docs/history/index.html +185 -74
- data/site/docs/home/index.html +70 -70
- data/site/docs/installation/index.html +94 -82
- data/site/docs/migrations/index.html +70 -70
- data/site/docs/pages/index.html +80 -74
- data/site/docs/pagination/index.html +91 -76
- data/site/docs/permalinks/index.html +70 -70
- data/site/docs/plugins/index.html +142 -96
- data/site/docs/posts/index.html +117 -87
- data/site/docs/quickstart/index.html +77 -73
- data/site/docs/resources/index.html +76 -71
- data/site/docs/sites/index.html +70 -70
- data/site/docs/static-files/index.html +88 -72
- data/site/docs/structure/index.html +79 -76
- data/site/docs/templates/index.html +210 -84
- data/site/docs/themes/index.html +106 -81
- data/site/docs/troubleshooting/index.html +155 -91
- data/site/docs/upgrading/0-to-2/index.html +74 -71
- data/site/docs/upgrading/2-to-3/index.html +99 -79
- data/site/docs/upgrading/index.html +70 -70
- data/site/docs/usage/index.html +95 -80
- data/site/docs/variables/index.html +71 -72
- data/site/docs/windows/index.html +89 -77
- data/site/feed.xml +111 -35
- data/site/help/index.html +2 -2
- data/site/index.html +3 -8
- data/site/latest_version.txt +1 -1
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +18 -6
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +18 -6
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +18 -6
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +18 -6
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +18 -6
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +18 -6
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +18 -6
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +18 -6
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +18 -6
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +18 -6
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +18 -6
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +18 -6
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +18 -6
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +18 -6
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +18 -6
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +18 -6
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +18 -6
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +18 -6
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +18 -6
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +18 -6
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +18 -6
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +18 -6
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +18 -6
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +18 -6
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +18 -6
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +18 -6
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +18 -6
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +18 -6
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +18 -6
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +18 -6
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +18 -6
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +18 -6
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +18 -6
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +18 -6
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +18 -6
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +18 -6
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +18 -6
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +18 -6
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +18 -6
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +18 -6
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +18 -6
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +18 -6
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +18 -6
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +18 -6
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +18 -6
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +18 -6
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +18 -6
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +18 -6
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +18 -6
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +18 -6
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +19 -7
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +18 -6
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +536 -0
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +615 -0
- data/site/news/index.html +172 -7
- data/site/news/releases/index.html +135 -7
- data/site/sitemap.xml +8 -0
- metadata +6 -5
- data/site/README.md +0 -16
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
5
5
|
<meta charset="UTF-8">
|
|
6
6
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
7
|
-
<meta name="generator" content="Jekyll v3.
|
|
7
|
+
<meta name="generator" content="Jekyll v3.3.0">
|
|
8
8
|
<link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
|
|
9
9
|
<link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
|
|
10
10
|
<link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
<meta property="og:url" content="https://jekyllrb.com/docs/structure/">
|
|
20
20
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
|
|
21
21
|
<meta property="og:type" content="article">
|
|
22
|
-
<meta property="article:published_time" content="2016-
|
|
22
|
+
<meta property="article:published_time" content="2016-10-06T11:16:34-07:00">
|
|
23
23
|
<meta name="twitter:card" content="summary">
|
|
24
24
|
<meta name="twitter:site" content="@jekyllrb">
|
|
25
25
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
|
|
@@ -28,9 +28,9 @@
|
|
|
28
28
|
"@context": "http://schema.org",
|
|
29
29
|
"@type": "BlogPosting",
|
|
30
30
|
"headline": "Directory structure",
|
|
31
|
-
"datePublished": "2016-
|
|
31
|
+
"datePublished": "2016-10-06T11:16:34-07:00",
|
|
32
32
|
"description": "Jekyll is, at its core, a text transformation engine. The concept behind thesystem is this: you give it text written in your favorite markup language, bethat Markdown, Textile, or just plain HTML, and it churns that through a layoutor a series of layout files. Throughout that process you can tweak how you wantthe site URLs to look, what data gets displayed in the layout, and more. Thisis all done through editing text files; the static web site is the finalproduct.",
|
|
33
|
-
"logo": "https://jekyllrb.
|
|
33
|
+
"logo": "https://jekyllrb.com/img/logo-2x.png",
|
|
34
34
|
"url": "https://jekyllrb.com/docs/structure/"
|
|
35
35
|
}
|
|
36
36
|
</script>
|
|
@@ -114,27 +114,27 @@
|
|
|
114
114
|
|
|
115
115
|
|
|
116
116
|
|
|
117
|
-
<option value="
|
|
117
|
+
<option value="/docs/home/">Welcome</option>
|
|
118
118
|
|
|
119
119
|
|
|
120
120
|
|
|
121
|
-
<option value="
|
|
121
|
+
<option value="/docs/quickstart/">Quick-start guide</option>
|
|
122
122
|
|
|
123
123
|
|
|
124
124
|
|
|
125
|
-
<option value="
|
|
125
|
+
<option value="/docs/installation/">Installation</option>
|
|
126
126
|
|
|
127
127
|
|
|
128
128
|
|
|
129
|
-
<option value="
|
|
129
|
+
<option value="/docs/usage/">Basic Usage</option>
|
|
130
130
|
|
|
131
131
|
|
|
132
132
|
|
|
133
|
-
<option value="
|
|
133
|
+
<option value="/docs/structure/">Directory structure</option>
|
|
134
134
|
|
|
135
135
|
|
|
136
136
|
|
|
137
|
-
<option value="
|
|
137
|
+
<option value="/docs/configuration/">Configuration</option>
|
|
138
138
|
|
|
139
139
|
|
|
140
140
|
</optgroup>
|
|
@@ -143,43 +143,43 @@
|
|
|
143
143
|
|
|
144
144
|
|
|
145
145
|
|
|
146
|
-
<option value="
|
|
146
|
+
<option value="/docs/frontmatter/">Front Matter</option>
|
|
147
147
|
|
|
148
148
|
|
|
149
149
|
|
|
150
|
-
<option value="
|
|
150
|
+
<option value="/docs/posts/">Writing posts</option>
|
|
151
151
|
|
|
152
152
|
|
|
153
153
|
|
|
154
|
-
<option value="
|
|
154
|
+
<option value="/docs/drafts/">Working with drafts</option>
|
|
155
155
|
|
|
156
156
|
|
|
157
157
|
|
|
158
|
-
<option value="
|
|
158
|
+
<option value="/docs/pages/">Creating pages</option>
|
|
159
159
|
|
|
160
160
|
|
|
161
161
|
|
|
162
|
-
<option value="
|
|
162
|
+
<option value="/docs/static-files/">Static Files</option>
|
|
163
163
|
|
|
164
164
|
|
|
165
165
|
|
|
166
|
-
<option value="
|
|
166
|
+
<option value="/docs/variables/">Variables</option>
|
|
167
167
|
|
|
168
168
|
|
|
169
169
|
|
|
170
|
-
<option value="
|
|
170
|
+
<option value="/docs/collections/">Collections</option>
|
|
171
171
|
|
|
172
172
|
|
|
173
173
|
|
|
174
|
-
<option value="
|
|
174
|
+
<option value="/docs/datafiles/">Data Files</option>
|
|
175
175
|
|
|
176
176
|
|
|
177
177
|
|
|
178
|
-
<option value="
|
|
178
|
+
<option value="/docs/assets/">Assets</option>
|
|
179
179
|
|
|
180
180
|
|
|
181
181
|
|
|
182
|
-
<option value="
|
|
182
|
+
<option value="/docs/migrations/">Blog migrations</option>
|
|
183
183
|
|
|
184
184
|
|
|
185
185
|
</optgroup>
|
|
@@ -188,27 +188,27 @@
|
|
|
188
188
|
|
|
189
189
|
|
|
190
190
|
|
|
191
|
-
<option value="
|
|
191
|
+
<option value="/docs/templates/">Templates</option>
|
|
192
192
|
|
|
193
193
|
|
|
194
194
|
|
|
195
|
-
<option value="
|
|
195
|
+
<option value="/docs/permalinks/">Permalinks</option>
|
|
196
196
|
|
|
197
197
|
|
|
198
198
|
|
|
199
|
-
<option value="
|
|
199
|
+
<option value="/docs/pagination/">Pagination</option>
|
|
200
200
|
|
|
201
201
|
|
|
202
202
|
|
|
203
|
-
<option value="
|
|
203
|
+
<option value="/docs/plugins/">Plugins</option>
|
|
204
204
|
|
|
205
205
|
|
|
206
206
|
|
|
207
|
-
<option value="
|
|
207
|
+
<option value="/docs/themes/">Themes</option>
|
|
208
208
|
|
|
209
209
|
|
|
210
210
|
|
|
211
|
-
<option value="
|
|
211
|
+
<option value="/docs/extras/">Extras</option>
|
|
212
212
|
|
|
213
213
|
|
|
214
214
|
</optgroup>
|
|
@@ -217,15 +217,15 @@
|
|
|
217
217
|
|
|
218
218
|
|
|
219
219
|
|
|
220
|
-
<option value="
|
|
220
|
+
<option value="/docs/github-pages/">GitHub Pages</option>
|
|
221
221
|
|
|
222
222
|
|
|
223
223
|
|
|
224
|
-
<option value="
|
|
224
|
+
<option value="/docs/deployment-methods/">Deployment methods</option>
|
|
225
225
|
|
|
226
226
|
|
|
227
227
|
|
|
228
|
-
<option value="
|
|
228
|
+
<option value="/docs/continuous-integration/">Continuous Integration</option>
|
|
229
229
|
|
|
230
230
|
|
|
231
231
|
</optgroup>
|
|
@@ -234,23 +234,23 @@
|
|
|
234
234
|
|
|
235
235
|
|
|
236
236
|
|
|
237
|
-
<option value="
|
|
237
|
+
<option value="/docs/troubleshooting/">Troubleshooting</option>
|
|
238
238
|
|
|
239
239
|
|
|
240
240
|
|
|
241
|
-
<option value="
|
|
241
|
+
<option value="/docs/sites/">Sites using Jekyll</option>
|
|
242
242
|
|
|
243
243
|
|
|
244
244
|
|
|
245
|
-
<option value="
|
|
245
|
+
<option value="/docs/resources/">Resources</option>
|
|
246
246
|
|
|
247
247
|
|
|
248
248
|
|
|
249
|
-
<option value="
|
|
249
|
+
<option value="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
|
|
250
250
|
|
|
251
251
|
|
|
252
252
|
|
|
253
|
-
<option value="
|
|
253
|
+
<option value="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
|
|
254
254
|
|
|
255
255
|
|
|
256
256
|
</optgroup>
|
|
@@ -259,15 +259,15 @@
|
|
|
259
259
|
|
|
260
260
|
|
|
261
261
|
|
|
262
|
-
<option value="
|
|
262
|
+
<option value="/docs/contributing/">Contributing</option>
|
|
263
263
|
|
|
264
264
|
|
|
265
265
|
|
|
266
|
-
<option value="
|
|
266
|
+
<option value="/docs/conduct/">Code of Conduct</option>
|
|
267
267
|
|
|
268
268
|
|
|
269
269
|
|
|
270
|
-
<option value="
|
|
270
|
+
<option value="/docs/history/">History</option>
|
|
271
271
|
|
|
272
272
|
|
|
273
273
|
</optgroup>
|
|
@@ -292,11 +292,12 @@ product.</p>
|
|
|
292
292
|
|
|
293
293
|
<p>A basic Jekyll site usually looks something like this:</p>
|
|
294
294
|
|
|
295
|
-
<
|
|
295
|
+
<div class="language-sh highlighter-rouge">
|
|
296
|
+
<pre class="highlight"><code>.
|
|
296
297
|
├── _config.yml
|
|
297
298
|
├── _drafts
|
|
298
|
-
| ├── begin-with-the-crazy-ideas.
|
|
299
|
-
| └── on-simplicity-in-technology.
|
|
299
|
+
| ├── begin-with-the-crazy-ideas.md
|
|
300
|
+
| └── on-simplicity-in-technology.md
|
|
300
301
|
├── _includes
|
|
301
302
|
| ├── footer.html
|
|
302
303
|
| └── header.html
|
|
@@ -304,13 +305,15 @@ product.</p>
|
|
|
304
305
|
| ├── default.html
|
|
305
306
|
| └── post.html
|
|
306
307
|
├── _posts
|
|
307
|
-
| ├── 2007-10-29-why-every-programmer-should-play-nethack.
|
|
308
|
-
| └── 2009-04-26-barcamp-boston-4-roundup.
|
|
308
|
+
| ├── 2007-10-29-why-every-programmer-should-play-nethack.md
|
|
309
|
+
| └── 2009-04-26-barcamp-boston-4-roundup.md
|
|
309
310
|
├── _data
|
|
310
311
|
| └── members.yml
|
|
311
312
|
├── _site
|
|
312
313
|
├── .jekyll-metadata
|
|
313
|
-
└── index.html
|
|
314
|
+
└── index.html
|
|
315
|
+
</code></pre>
|
|
316
|
+
</div>
|
|
314
317
|
|
|
315
318
|
<p>An overview of what each of these does:</p>
|
|
316
319
|
|
|
@@ -535,27 +538,27 @@ product.</p>
|
|
|
535
538
|
|
|
536
539
|
|
|
537
540
|
|
|
538
|
-
<li class=""><a href="
|
|
541
|
+
<li class=""><a href="/docs/home/">Welcome</a></li>
|
|
539
542
|
|
|
540
543
|
|
|
541
544
|
|
|
542
|
-
<li class=""><a href="
|
|
545
|
+
<li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
|
|
543
546
|
|
|
544
547
|
|
|
545
548
|
|
|
546
|
-
<li class=""><a href="
|
|
549
|
+
<li class=""><a href="/docs/installation/">Installation</a></li>
|
|
547
550
|
|
|
548
551
|
|
|
549
552
|
|
|
550
|
-
<li class=""><a href="
|
|
553
|
+
<li class=""><a href="/docs/usage/">Basic Usage</a></li>
|
|
551
554
|
|
|
552
555
|
|
|
553
556
|
|
|
554
|
-
<li class="current"><a href="
|
|
557
|
+
<li class="current"><a href="/docs/structure/">Directory structure</a></li>
|
|
555
558
|
|
|
556
559
|
|
|
557
560
|
|
|
558
|
-
<li class=""><a href="
|
|
561
|
+
<li class=""><a href="/docs/configuration/">Configuration</a></li>
|
|
559
562
|
|
|
560
563
|
</ul>
|
|
561
564
|
|
|
@@ -565,43 +568,43 @@ product.</p>
|
|
|
565
568
|
|
|
566
569
|
|
|
567
570
|
|
|
568
|
-
<li class=""><a href="
|
|
571
|
+
<li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
|
|
569
572
|
|
|
570
573
|
|
|
571
574
|
|
|
572
|
-
<li class=""><a href="
|
|
575
|
+
<li class=""><a href="/docs/posts/">Writing posts</a></li>
|
|
573
576
|
|
|
574
577
|
|
|
575
578
|
|
|
576
|
-
<li class=""><a href="
|
|
579
|
+
<li class=""><a href="/docs/drafts/">Working with drafts</a></li>
|
|
577
580
|
|
|
578
581
|
|
|
579
582
|
|
|
580
|
-
<li class=""><a href="
|
|
583
|
+
<li class=""><a href="/docs/pages/">Creating pages</a></li>
|
|
581
584
|
|
|
582
585
|
|
|
583
586
|
|
|
584
|
-
<li class=""><a href="
|
|
587
|
+
<li class=""><a href="/docs/static-files/">Static Files</a></li>
|
|
585
588
|
|
|
586
589
|
|
|
587
590
|
|
|
588
|
-
<li class=""><a href="
|
|
591
|
+
<li class=""><a href="/docs/variables/">Variables</a></li>
|
|
589
592
|
|
|
590
593
|
|
|
591
594
|
|
|
592
|
-
<li class=""><a href="
|
|
595
|
+
<li class=""><a href="/docs/collections/">Collections</a></li>
|
|
593
596
|
|
|
594
597
|
|
|
595
598
|
|
|
596
|
-
<li class=""><a href="
|
|
599
|
+
<li class=""><a href="/docs/datafiles/">Data Files</a></li>
|
|
597
600
|
|
|
598
601
|
|
|
599
602
|
|
|
600
|
-
<li class=""><a href="
|
|
603
|
+
<li class=""><a href="/docs/assets/">Assets</a></li>
|
|
601
604
|
|
|
602
605
|
|
|
603
606
|
|
|
604
|
-
<li class=""><a href="
|
|
607
|
+
<li class=""><a href="/docs/migrations/">Blog migrations</a></li>
|
|
605
608
|
|
|
606
609
|
</ul>
|
|
607
610
|
|
|
@@ -611,27 +614,27 @@ product.</p>
|
|
|
611
614
|
|
|
612
615
|
|
|
613
616
|
|
|
614
|
-
<li class=""><a href="
|
|
617
|
+
<li class=""><a href="/docs/templates/">Templates</a></li>
|
|
615
618
|
|
|
616
619
|
|
|
617
620
|
|
|
618
|
-
<li class=""><a href="
|
|
621
|
+
<li class=""><a href="/docs/permalinks/">Permalinks</a></li>
|
|
619
622
|
|
|
620
623
|
|
|
621
624
|
|
|
622
|
-
<li class=""><a href="
|
|
625
|
+
<li class=""><a href="/docs/pagination/">Pagination</a></li>
|
|
623
626
|
|
|
624
627
|
|
|
625
628
|
|
|
626
|
-
<li class=""><a href="
|
|
629
|
+
<li class=""><a href="/docs/plugins/">Plugins</a></li>
|
|
627
630
|
|
|
628
631
|
|
|
629
632
|
|
|
630
|
-
<li class=""><a href="
|
|
633
|
+
<li class=""><a href="/docs/themes/">Themes</a></li>
|
|
631
634
|
|
|
632
635
|
|
|
633
636
|
|
|
634
|
-
<li class=""><a href="
|
|
637
|
+
<li class=""><a href="/docs/extras/">Extras</a></li>
|
|
635
638
|
|
|
636
639
|
</ul>
|
|
637
640
|
|
|
@@ -641,15 +644,15 @@ product.</p>
|
|
|
641
644
|
|
|
642
645
|
|
|
643
646
|
|
|
644
|
-
<li class=""><a href="
|
|
647
|
+
<li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
|
|
645
648
|
|
|
646
649
|
|
|
647
650
|
|
|
648
|
-
<li class=""><a href="
|
|
651
|
+
<li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
|
|
649
652
|
|
|
650
653
|
|
|
651
654
|
|
|
652
|
-
<li class=""><a href="
|
|
655
|
+
<li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
|
|
653
656
|
|
|
654
657
|
</ul>
|
|
655
658
|
|
|
@@ -659,23 +662,23 @@ product.</p>
|
|
|
659
662
|
|
|
660
663
|
|
|
661
664
|
|
|
662
|
-
<li class=""><a href="
|
|
665
|
+
<li class=""><a href="/docs/troubleshooting/">Troubleshooting</a></li>
|
|
663
666
|
|
|
664
667
|
|
|
665
668
|
|
|
666
|
-
<li class=""><a href="
|
|
669
|
+
<li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
|
|
667
670
|
|
|
668
671
|
|
|
669
672
|
|
|
670
|
-
<li class=""><a href="
|
|
673
|
+
<li class=""><a href="/docs/resources/">Resources</a></li>
|
|
671
674
|
|
|
672
675
|
|
|
673
676
|
|
|
674
|
-
<li class=""><a href="
|
|
677
|
+
<li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
|
|
675
678
|
|
|
676
679
|
|
|
677
680
|
|
|
678
|
-
<li class=""><a href="
|
|
681
|
+
<li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
|
|
679
682
|
|
|
680
683
|
</ul>
|
|
681
684
|
|
|
@@ -685,15 +688,15 @@ product.</p>
|
|
|
685
688
|
|
|
686
689
|
|
|
687
690
|
|
|
688
|
-
<li class=""><a href="
|
|
691
|
+
<li class=""><a href="/docs/contributing/">Contributing</a></li>
|
|
689
692
|
|
|
690
693
|
|
|
691
694
|
|
|
692
|
-
<li class=""><a href="
|
|
695
|
+
<li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
|
|
693
696
|
|
|
694
697
|
|
|
695
698
|
|
|
696
|
-
<li class=""><a href="
|
|
699
|
+
<li class=""><a href="/docs/history/">History</a></li>
|
|
697
700
|
|
|
698
701
|
</ul>
|
|
699
702
|
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
5
5
|
<meta charset="UTF-8">
|
|
6
6
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
7
|
-
<meta name="generator" content="Jekyll v3.
|
|
7
|
+
<meta name="generator" content="Jekyll v3.3.0">
|
|
8
8
|
<link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
|
|
9
9
|
<link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
|
|
10
10
|
<link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
<meta property="og:url" content="https://jekyllrb.com/docs/templates/">
|
|
20
20
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
|
|
21
21
|
<meta property="og:type" content="article">
|
|
22
|
-
<meta property="article:published_time" content="2016-
|
|
22
|
+
<meta property="article:published_time" content="2016-10-06T11:16:34-07:00">
|
|
23
23
|
<meta name="twitter:card" content="summary">
|
|
24
24
|
<meta name="twitter:site" content="@jekyllrb">
|
|
25
25
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
|
|
@@ -28,9 +28,9 @@
|
|
|
28
28
|
"@context": "http://schema.org",
|
|
29
29
|
"@type": "BlogPosting",
|
|
30
30
|
"headline": "Templates",
|
|
31
|
-
"datePublished": "2016-
|
|
31
|
+
"datePublished": "2016-10-06T11:16:34-07:00",
|
|
32
32
|
"description": "Jekyll uses the Liquid templating language toprocess templates. All of the standard Liquid tags andfilters aresupported. Jekyll even adds a few handy filters and tags of its own to makecommon tasks easier.",
|
|
33
|
-
"logo": "https://jekyllrb.
|
|
33
|
+
"logo": "https://jekyllrb.com/img/logo-2x.png",
|
|
34
34
|
"url": "https://jekyllrb.com/docs/templates/"
|
|
35
35
|
}
|
|
36
36
|
</script>
|
|
@@ -114,27 +114,27 @@
|
|
|
114
114
|
|
|
115
115
|
|
|
116
116
|
|
|
117
|
-
<option value="
|
|
117
|
+
<option value="/docs/home/">Welcome</option>
|
|
118
118
|
|
|
119
119
|
|
|
120
120
|
|
|
121
|
-
<option value="
|
|
121
|
+
<option value="/docs/quickstart/">Quick-start guide</option>
|
|
122
122
|
|
|
123
123
|
|
|
124
124
|
|
|
125
|
-
<option value="
|
|
125
|
+
<option value="/docs/installation/">Installation</option>
|
|
126
126
|
|
|
127
127
|
|
|
128
128
|
|
|
129
|
-
<option value="
|
|
129
|
+
<option value="/docs/usage/">Basic Usage</option>
|
|
130
130
|
|
|
131
131
|
|
|
132
132
|
|
|
133
|
-
<option value="
|
|
133
|
+
<option value="/docs/structure/">Directory structure</option>
|
|
134
134
|
|
|
135
135
|
|
|
136
136
|
|
|
137
|
-
<option value="
|
|
137
|
+
<option value="/docs/configuration/">Configuration</option>
|
|
138
138
|
|
|
139
139
|
|
|
140
140
|
</optgroup>
|
|
@@ -143,43 +143,43 @@
|
|
|
143
143
|
|
|
144
144
|
|
|
145
145
|
|
|
146
|
-
<option value="
|
|
146
|
+
<option value="/docs/frontmatter/">Front Matter</option>
|
|
147
147
|
|
|
148
148
|
|
|
149
149
|
|
|
150
|
-
<option value="
|
|
150
|
+
<option value="/docs/posts/">Writing posts</option>
|
|
151
151
|
|
|
152
152
|
|
|
153
153
|
|
|
154
|
-
<option value="
|
|
154
|
+
<option value="/docs/drafts/">Working with drafts</option>
|
|
155
155
|
|
|
156
156
|
|
|
157
157
|
|
|
158
|
-
<option value="
|
|
158
|
+
<option value="/docs/pages/">Creating pages</option>
|
|
159
159
|
|
|
160
160
|
|
|
161
161
|
|
|
162
|
-
<option value="
|
|
162
|
+
<option value="/docs/static-files/">Static Files</option>
|
|
163
163
|
|
|
164
164
|
|
|
165
165
|
|
|
166
|
-
<option value="
|
|
166
|
+
<option value="/docs/variables/">Variables</option>
|
|
167
167
|
|
|
168
168
|
|
|
169
169
|
|
|
170
|
-
<option value="
|
|
170
|
+
<option value="/docs/collections/">Collections</option>
|
|
171
171
|
|
|
172
172
|
|
|
173
173
|
|
|
174
|
-
<option value="
|
|
174
|
+
<option value="/docs/datafiles/">Data Files</option>
|
|
175
175
|
|
|
176
176
|
|
|
177
177
|
|
|
178
|
-
<option value="
|
|
178
|
+
<option value="/docs/assets/">Assets</option>
|
|
179
179
|
|
|
180
180
|
|
|
181
181
|
|
|
182
|
-
<option value="
|
|
182
|
+
<option value="/docs/migrations/">Blog migrations</option>
|
|
183
183
|
|
|
184
184
|
|
|
185
185
|
</optgroup>
|
|
@@ -188,27 +188,27 @@
|
|
|
188
188
|
|
|
189
189
|
|
|
190
190
|
|
|
191
|
-
<option value="
|
|
191
|
+
<option value="/docs/templates/">Templates</option>
|
|
192
192
|
|
|
193
193
|
|
|
194
194
|
|
|
195
|
-
<option value="
|
|
195
|
+
<option value="/docs/permalinks/">Permalinks</option>
|
|
196
196
|
|
|
197
197
|
|
|
198
198
|
|
|
199
|
-
<option value="
|
|
199
|
+
<option value="/docs/pagination/">Pagination</option>
|
|
200
200
|
|
|
201
201
|
|
|
202
202
|
|
|
203
|
-
<option value="
|
|
203
|
+
<option value="/docs/plugins/">Plugins</option>
|
|
204
204
|
|
|
205
205
|
|
|
206
206
|
|
|
207
|
-
<option value="
|
|
207
|
+
<option value="/docs/themes/">Themes</option>
|
|
208
208
|
|
|
209
209
|
|
|
210
210
|
|
|
211
|
-
<option value="
|
|
211
|
+
<option value="/docs/extras/">Extras</option>
|
|
212
212
|
|
|
213
213
|
|
|
214
214
|
</optgroup>
|
|
@@ -217,15 +217,15 @@
|
|
|
217
217
|
|
|
218
218
|
|
|
219
219
|
|
|
220
|
-
<option value="
|
|
220
|
+
<option value="/docs/github-pages/">GitHub Pages</option>
|
|
221
221
|
|
|
222
222
|
|
|
223
223
|
|
|
224
|
-
<option value="
|
|
224
|
+
<option value="/docs/deployment-methods/">Deployment methods</option>
|
|
225
225
|
|
|
226
226
|
|
|
227
227
|
|
|
228
|
-
<option value="
|
|
228
|
+
<option value="/docs/continuous-integration/">Continuous Integration</option>
|
|
229
229
|
|
|
230
230
|
|
|
231
231
|
</optgroup>
|
|
@@ -234,23 +234,23 @@
|
|
|
234
234
|
|
|
235
235
|
|
|
236
236
|
|
|
237
|
-
<option value="
|
|
237
|
+
<option value="/docs/troubleshooting/">Troubleshooting</option>
|
|
238
238
|
|
|
239
239
|
|
|
240
240
|
|
|
241
|
-
<option value="
|
|
241
|
+
<option value="/docs/sites/">Sites using Jekyll</option>
|
|
242
242
|
|
|
243
243
|
|
|
244
244
|
|
|
245
|
-
<option value="
|
|
245
|
+
<option value="/docs/resources/">Resources</option>
|
|
246
246
|
|
|
247
247
|
|
|
248
248
|
|
|
249
|
-
<option value="
|
|
249
|
+
<option value="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
|
|
250
250
|
|
|
251
251
|
|
|
252
252
|
|
|
253
|
-
<option value="
|
|
253
|
+
<option value="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
|
|
254
254
|
|
|
255
255
|
|
|
256
256
|
</optgroup>
|
|
@@ -259,15 +259,15 @@
|
|
|
259
259
|
|
|
260
260
|
|
|
261
261
|
|
|
262
|
-
<option value="
|
|
262
|
+
<option value="/docs/contributing/">Contributing</option>
|
|
263
263
|
|
|
264
264
|
|
|
265
265
|
|
|
266
|
-
<option value="
|
|
266
|
+
<option value="/docs/conduct/">Code of Conduct</option>
|
|
267
267
|
|
|
268
268
|
|
|
269
269
|
|
|
270
|
-
<option value="
|
|
270
|
+
<option value="/docs/history/">History</option>
|
|
271
271
|
|
|
272
272
|
|
|
273
273
|
</optgroup>
|
|
@@ -301,6 +301,34 @@ common tasks easier.</p>
|
|
|
301
301
|
</tr>
|
|
302
302
|
</thead>
|
|
303
303
|
<tbody>
|
|
304
|
+
<tr>
|
|
305
|
+
<td>
|
|
306
|
+
<p class="name"><strong>Relative URL</strong></p>
|
|
307
|
+
<p>Prepend the <code>baseurl</code> value to the input. Useful if your site is hosted at a subpath rather than the root of the domain.</p>
|
|
308
|
+
</td>
|
|
309
|
+
<td class="align-center">
|
|
310
|
+
<p>
|
|
311
|
+
<code class="filter">{{ "/assets/style.css" | relative_url }}</code>
|
|
312
|
+
</p>
|
|
313
|
+
<p>
|
|
314
|
+
<code class="output">/my-baseurl/assets/style.css</code>
|
|
315
|
+
</p>
|
|
316
|
+
</td>
|
|
317
|
+
</tr>
|
|
318
|
+
<tr>
|
|
319
|
+
<td>
|
|
320
|
+
<p class="name"><strong>Absolute URL</strong></p>
|
|
321
|
+
<p>Prepend the <code>url</code> and <code>baseurl</code> value to the input.</p>
|
|
322
|
+
</td>
|
|
323
|
+
<td class="align-center">
|
|
324
|
+
<p>
|
|
325
|
+
<code class="filter">{{ "/assets/style.css" | absolute_url }}</code>
|
|
326
|
+
</p>
|
|
327
|
+
<p>
|
|
328
|
+
<code class="output">http://example.com/my-baseurl/assets/style.css</code>
|
|
329
|
+
</p>
|
|
330
|
+
</td>
|
|
331
|
+
</tr>
|
|
304
332
|
<tr>
|
|
305
333
|
<td>
|
|
306
334
|
<p class="name"><strong>Date to XML Schema</strong></p>
|
|
@@ -543,7 +571,7 @@ common tasks easier.</p>
|
|
|
543
571
|
</td>
|
|
544
572
|
<td class="align-center">
|
|
545
573
|
<p>
|
|
546
|
-
<code class="filter">{{ "a \n b" |
|
|
574
|
+
<code class="filter">{{ "a \n b" | normalize_whitespace }}</code>
|
|
547
575
|
</p>
|
|
548
576
|
</td>
|
|
549
577
|
</tr>
|
|
@@ -578,6 +606,17 @@ common tasks easier.</p>
|
|
|
578
606
|
</p>
|
|
579
607
|
</td>
|
|
580
608
|
</tr>
|
|
609
|
+
<tr>
|
|
610
|
+
<td>
|
|
611
|
+
<p class="name"><strong>To Integer</strong></p>
|
|
612
|
+
<p>Convert a string or boolean to integer.</p>
|
|
613
|
+
</td>
|
|
614
|
+
<td class="align-center">
|
|
615
|
+
<p>
|
|
616
|
+
<code class="filter">{{ some_var | to_integer }}</code>
|
|
617
|
+
</p>
|
|
618
|
+
</td>
|
|
619
|
+
</tr>
|
|
581
620
|
<tr>
|
|
582
621
|
<td>
|
|
583
622
|
<p class="name"><strong>Array Filters</strong></p>
|
|
@@ -611,6 +650,17 @@ common tasks easier.</p>
|
|
|
611
650
|
</p>
|
|
612
651
|
</td>
|
|
613
652
|
</tr>
|
|
653
|
+
<tr>
|
|
654
|
+
<td>
|
|
655
|
+
<p class="name"><strong>Inspect</strong></p>
|
|
656
|
+
<p>Convert an object into its String representation for debugging.</p>
|
|
657
|
+
</td>
|
|
658
|
+
<td class="align-center">
|
|
659
|
+
<p>
|
|
660
|
+
<code class="filter">{{ some_var | inspect }}</code>
|
|
661
|
+
</p>
|
|
662
|
+
</td>
|
|
663
|
+
</tr>
|
|
614
664
|
</tbody>
|
|
615
665
|
</table>
|
|
616
666
|
</div>
|
|
@@ -639,7 +689,10 @@ The default is <code class="highlighter-rouge">default</code>. They are as follo
|
|
|
639
689
|
<p>If you have small page fragments that you wish to include in multiple places on
|
|
640
690
|
your site, you can use the <code class="highlighter-rouge">include</code> tag.</p>
|
|
641
691
|
|
|
642
|
-
<
|
|
692
|
+
<div class="language-liquid highlighter-rouge">
|
|
693
|
+
<pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">include</span><span class="w"> </span><span class="na">footer</span><span class="p">.</span><span class="na">html</span><span class="w"> </span><span class="p">%}</span>
|
|
694
|
+
</code></pre>
|
|
695
|
+
</div>
|
|
643
696
|
|
|
644
697
|
<p>Jekyll expects all include files to be placed in an <code class="highlighter-rouge">_includes</code> directory at the
|
|
645
698
|
root of your source directory. This will embed the contents of
|
|
@@ -658,17 +711,26 @@ root of your source directory. This will embed the contents of
|
|
|
658
711
|
|
|
659
712
|
<p>You can also pass parameters to an include. Omit the quotation marks to send a variable’s value. Liquid curly brackets should not be used here:</p>
|
|
660
713
|
|
|
661
|
-
<
|
|
714
|
+
<div class="language-liquid highlighter-rouge">
|
|
715
|
+
<pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">include</span><span class="w"> </span><span class="na">footer</span><span class="p">.</span><span class="na">html</span><span class="w"> </span><span class="na">param</span><span class="o">=</span><span class="s2">"value"</span><span class="w"> </span><span class="na">variable-param</span><span class="o">=</span><span class="nv">page</span><span class="p">.</span><span class="nv">variable</span><span class="w"> </span><span class="p">%}</span>
|
|
716
|
+
</code></pre>
|
|
717
|
+
</div>
|
|
662
718
|
|
|
663
719
|
<p>These parameters are available via Liquid in the include:</p>
|
|
664
720
|
|
|
665
|
-
<
|
|
721
|
+
<div class="language-liquid highlighter-rouge">
|
|
722
|
+
<pre class="highlight"><code><span class="p">{{</span><span class="w"> </span><span class="nv">include</span><span class="p">.</span><span class="nv">param</span><span class="w"> </span><span class="p">}}</span>
|
|
723
|
+
</code></pre>
|
|
724
|
+
</div>
|
|
666
725
|
|
|
667
726
|
<h4 id="including-files-relative-to-another-file">Including files relative to another file</h4>
|
|
668
727
|
|
|
669
728
|
<p>You can also choose to include file fragments relative to the current file:</p>
|
|
670
729
|
|
|
671
|
-
<
|
|
730
|
+
<div class="language-liquid highlighter-rouge">
|
|
731
|
+
<pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">include</span><span class="na">_relative somedir/footer</span><span class="p">.</span><span class="na">html</span><span class="w"> </span><span class="p">%}</span>
|
|
732
|
+
</code></pre>
|
|
733
|
+
</div>
|
|
672
734
|
|
|
673
735
|
<p>You won’t need to place your included content within the <code class="highlighter-rouge">_includes</code> directory. Instead,
|
|
674
736
|
the inclusion is specifically relative to the file where the tag is being used. For example,
|
|
@@ -694,11 +756,16 @@ languages</a></p>
|
|
|
694
756
|
|
|
695
757
|
<p>To render a code block with syntax highlighting, surround your code as follows:</p>
|
|
696
758
|
|
|
697
|
-
<
|
|
759
|
+
<div class="language-liquid highlighter-rouge">
|
|
760
|
+
<pre class="highlight"><code>
|
|
761
|
+
<span class="p">{%</span><span class="w"> </span><span class="nt">highlight</span><span class="w"> </span>ruby<span class="w"> </span><span class="p">%}</span>
|
|
698
762
|
def foo
|
|
699
763
|
puts 'foo'
|
|
700
764
|
end
|
|
701
|
-
<span class="p">{%</span><span class="w"> </span><span class="nt">endhighlight</span><span class="w"> </span><span class="p">%}</span
|
|
765
|
+
<span class="p">{%</span><span class="w"> </span><span class="nt">endhighlight</span><span class="w"> </span><span class="p">%}</span>
|
|
766
|
+
|
|
767
|
+
</code></pre>
|
|
768
|
+
</div>
|
|
702
769
|
|
|
703
770
|
<p>The argument to the <code class="highlighter-rouge">highlight</code> tag (<code class="highlighter-rouge">ruby</code> in the example above) is the
|
|
704
771
|
language identifier. To find the appropriate identifier to use for the language
|
|
@@ -713,11 +780,16 @@ Including the <code class="highlighter-rouge">linenos</code> argument will force
|
|
|
713
780
|
numbers. For instance, the following code block would include line numbers next
|
|
714
781
|
to each line:</p>
|
|
715
782
|
|
|
716
|
-
<
|
|
783
|
+
<div class="language-liquid highlighter-rouge">
|
|
784
|
+
<pre class="highlight"><code>
|
|
785
|
+
<span class="p">{%</span><span class="w"> </span><span class="nt">highlight</span><span class="w"> </span>ruby<span class="w"> </span>linenos<span class="w"> </span><span class="p">%}</span>
|
|
717
786
|
def foo
|
|
718
787
|
puts 'foo'
|
|
719
788
|
end
|
|
720
|
-
<span class="p">{%</span><span class="w"> </span><span class="nt">endhighlight</span><span class="w"> </span><span class="p">%}</span
|
|
789
|
+
<span class="p">{%</span><span class="w"> </span><span class="nt">endhighlight</span><span class="w"> </span><span class="p">%}</span>
|
|
790
|
+
|
|
791
|
+
</code></pre>
|
|
792
|
+
</div>
|
|
721
793
|
|
|
722
794
|
<h4 id="stylesheets-for-syntax-highlighting">Stylesheets for syntax highlighting</h4>
|
|
723
795
|
|
|
@@ -729,34 +801,88 @@ site. If you use <code class="highlighter-rouge">linenos</code>, you might want
|
|
|
729
801
|
definition for the <code class="highlighter-rouge">.lineno</code> class in <code class="highlighter-rouge">syntax.css</code> to distinguish the line
|
|
730
802
|
numbers from the highlighted code.</p>
|
|
731
803
|
|
|
804
|
+
<h3 id="link">Link</h3>
|
|
805
|
+
|
|
806
|
+
<p>If you would like to include a link to a collection’s document, or a post
|
|
807
|
+
the <code class="highlighter-rouge">link</code> tag will generate the correct permalink URL for the path you
|
|
808
|
+
specify.</p>
|
|
809
|
+
|
|
810
|
+
<p>You must include the file extension when using the <code class="highlighter-rouge">link</code> tag.</p>
|
|
811
|
+
|
|
812
|
+
<div class="language-liquid highlighter-rouge">
|
|
813
|
+
<pre class="highlight"><code>
|
|
814
|
+
<span class="p">{%</span><span class="w"> </span><span class="nt">link</span><span class="w"> </span>_collection/name-of-document.md<span class="w"> </span><span class="p">%}</span>
|
|
815
|
+
<span class="p">{%</span><span class="w"> </span><span class="nt">link</span><span class="w"> </span>_posts/<span class="mi">2016</span>-<span class="mi">07</span>-<span class="mi">26</span>-name-of-post.md<span class="w"> </span><span class="p">%}</span>
|
|
816
|
+
|
|
817
|
+
</code></pre>
|
|
818
|
+
</div>
|
|
819
|
+
|
|
820
|
+
<p>You can also use this tag to create a link in Markdown as follows:</p>
|
|
821
|
+
|
|
822
|
+
<div class="language-liquid highlighter-rouge">
|
|
823
|
+
<pre class="highlight"><code>
|
|
824
|
+
[Link to a document](<span class="p">{%</span><span class="w"> </span><span class="nt">link</span><span class="w"> </span>_collection/name-of-document.md<span class="w"> </span><span class="p">%}</span>)
|
|
825
|
+
[Link to a post](<span class="p">{%</span><span class="w"> </span><span class="nt">link</span><span class="w"> </span>_posts/<span class="mi">2016</span>-<span class="mi">07</span>-<span class="mi">26</span>-name-of-post.md<span class="w"> </span><span class="p">%}</span>)
|
|
826
|
+
|
|
827
|
+
</code></pre>
|
|
828
|
+
</div>
|
|
829
|
+
|
|
830
|
+
<p>Support for static files and pages is coming in a later release but is
|
|
831
|
+
<strong>not</strong> released as of v3.2.1.</p>
|
|
832
|
+
|
|
732
833
|
<h3 id="post-url">Post URL</h3>
|
|
733
834
|
|
|
734
835
|
<p>If you would like to include a link to a post on your site, the <code class="highlighter-rouge">post_url</code> tag
|
|
735
836
|
will generate the correct permalink URL for the post you specify.</p>
|
|
736
837
|
|
|
737
|
-
<
|
|
838
|
+
<div class="language-liquid highlighter-rouge">
|
|
839
|
+
<pre class="highlight"><code>
|
|
840
|
+
<span class="p">{%</span><span class="w"> </span><span class="nt">post_url</span><span class="w"> </span><span class="mi">2010</span>-<span class="mi">07</span>-<span class="mi">21</span>-name-of-post<span class="w"> </span><span class="p">%}</span>
|
|
841
|
+
|
|
842
|
+
</code></pre>
|
|
843
|
+
</div>
|
|
738
844
|
|
|
739
845
|
<p>If you organize your posts in subdirectories, you need to include subdirectory
|
|
740
846
|
path to the post:</p>
|
|
741
847
|
|
|
742
|
-
<
|
|
848
|
+
<div class="language-liquid highlighter-rouge">
|
|
849
|
+
<pre class="highlight"><code>
|
|
850
|
+
<span class="p">{%</span><span class="w"> </span><span class="nt">post_url</span><span class="w"> </span>/subdir/<span class="mi">2010</span>-<span class="mi">07</span>-<span class="mi">21</span>-name-of-post<span class="w"> </span><span class="p">%}</span>
|
|
851
|
+
|
|
852
|
+
</code></pre>
|
|
853
|
+
</div>
|
|
743
854
|
|
|
744
855
|
<p>There is no need to include the file extension when using the <code class="highlighter-rouge">post_url</code> tag.</p>
|
|
745
856
|
|
|
746
857
|
<p>You can also use this tag to create a link to a post in Markdown as follows:</p>
|
|
747
858
|
|
|
748
|
-
<
|
|
859
|
+
<div class="language-liquid highlighter-rouge">
|
|
860
|
+
<pre class="highlight"><code>
|
|
861
|
+
[Name of Link](<span class="p">{%</span><span class="w"> </span><span class="nt">post_url</span><span class="w"> </span><span class="mi">2010</span>-<span class="mi">07</span>-<span class="mi">21</span>-name-of-post<span class="w"> </span><span class="p">%}</span>)
|
|
862
|
+
|
|
863
|
+
</code></pre>
|
|
864
|
+
</div>
|
|
749
865
|
|
|
750
866
|
<h3 id="gist">Gist</h3>
|
|
751
867
|
|
|
752
868
|
<p>Use the <code class="highlighter-rouge">gist</code> tag to easily embed a GitHub Gist onto your site. This works
|
|
753
869
|
with public or secret gists:</p>
|
|
754
870
|
|
|
755
|
-
<
|
|
871
|
+
<div class="language-liquid highlighter-rouge">
|
|
872
|
+
<pre class="highlight"><code>
|
|
873
|
+
<span class="p">{%</span><span class="w"> </span><span class="nt">gist</span><span class="w"> </span>parkr/<span class="mi">931</span>c<span class="mi">1</span>c<span class="mi">8</span>d<span class="mi">465</span>a<span class="mi">04042403</span><span class="w"> </span><span class="p">%}</span>
|
|
874
|
+
|
|
875
|
+
</code></pre>
|
|
876
|
+
</div>
|
|
756
877
|
|
|
757
878
|
<p>You may also optionally specify the filename in the gist to display:</p>
|
|
758
879
|
|
|
759
|
-
<
|
|
880
|
+
<div class="language-liquid highlighter-rouge">
|
|
881
|
+
<pre class="highlight"><code>
|
|
882
|
+
<span class="p">{%</span><span class="w"> </span><span class="nt">gist</span><span class="w"> </span>parkr/<span class="mi">931</span>c<span class="mi">1</span>c<span class="mi">8</span>d<span class="mi">465</span>a<span class="mi">04042403</span><span class="w"> </span>jekyll-private-gist.markdown<span class="w"> </span><span class="p">%}</span>
|
|
883
|
+
|
|
884
|
+
</code></pre>
|
|
885
|
+
</div>
|
|
760
886
|
|
|
761
887
|
<p>To use the <code class="highlighter-rouge">gist</code> tag, you’ll need to add the
|
|
762
888
|
<a href="https://github.com/jekyll/jekyll-gist">jekyll-gist</a> gem to your project.</p>
|
|
@@ -846,27 +972,27 @@ with public or secret gists:</p>
|
|
|
846
972
|
|
|
847
973
|
|
|
848
974
|
|
|
849
|
-
<li class=""><a href="
|
|
975
|
+
<li class=""><a href="/docs/home/">Welcome</a></li>
|
|
850
976
|
|
|
851
977
|
|
|
852
978
|
|
|
853
|
-
<li class=""><a href="
|
|
979
|
+
<li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
|
|
854
980
|
|
|
855
981
|
|
|
856
982
|
|
|
857
|
-
<li class=""><a href="
|
|
983
|
+
<li class=""><a href="/docs/installation/">Installation</a></li>
|
|
858
984
|
|
|
859
985
|
|
|
860
986
|
|
|
861
|
-
<li class=""><a href="
|
|
987
|
+
<li class=""><a href="/docs/usage/">Basic Usage</a></li>
|
|
862
988
|
|
|
863
989
|
|
|
864
990
|
|
|
865
|
-
<li class=""><a href="
|
|
991
|
+
<li class=""><a href="/docs/structure/">Directory structure</a></li>
|
|
866
992
|
|
|
867
993
|
|
|
868
994
|
|
|
869
|
-
<li class=""><a href="
|
|
995
|
+
<li class=""><a href="/docs/configuration/">Configuration</a></li>
|
|
870
996
|
|
|
871
997
|
</ul>
|
|
872
998
|
|
|
@@ -876,43 +1002,43 @@ with public or secret gists:</p>
|
|
|
876
1002
|
|
|
877
1003
|
|
|
878
1004
|
|
|
879
|
-
<li class=""><a href="
|
|
1005
|
+
<li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
|
|
880
1006
|
|
|
881
1007
|
|
|
882
1008
|
|
|
883
|
-
<li class=""><a href="
|
|
1009
|
+
<li class=""><a href="/docs/posts/">Writing posts</a></li>
|
|
884
1010
|
|
|
885
1011
|
|
|
886
1012
|
|
|
887
|
-
<li class=""><a href="
|
|
1013
|
+
<li class=""><a href="/docs/drafts/">Working with drafts</a></li>
|
|
888
1014
|
|
|
889
1015
|
|
|
890
1016
|
|
|
891
|
-
<li class=""><a href="
|
|
1017
|
+
<li class=""><a href="/docs/pages/">Creating pages</a></li>
|
|
892
1018
|
|
|
893
1019
|
|
|
894
1020
|
|
|
895
|
-
<li class=""><a href="
|
|
1021
|
+
<li class=""><a href="/docs/static-files/">Static Files</a></li>
|
|
896
1022
|
|
|
897
1023
|
|
|
898
1024
|
|
|
899
|
-
<li class=""><a href="
|
|
1025
|
+
<li class=""><a href="/docs/variables/">Variables</a></li>
|
|
900
1026
|
|
|
901
1027
|
|
|
902
1028
|
|
|
903
|
-
<li class=""><a href="
|
|
1029
|
+
<li class=""><a href="/docs/collections/">Collections</a></li>
|
|
904
1030
|
|
|
905
1031
|
|
|
906
1032
|
|
|
907
|
-
<li class=""><a href="
|
|
1033
|
+
<li class=""><a href="/docs/datafiles/">Data Files</a></li>
|
|
908
1034
|
|
|
909
1035
|
|
|
910
1036
|
|
|
911
|
-
<li class=""><a href="
|
|
1037
|
+
<li class=""><a href="/docs/assets/">Assets</a></li>
|
|
912
1038
|
|
|
913
1039
|
|
|
914
1040
|
|
|
915
|
-
<li class=""><a href="
|
|
1041
|
+
<li class=""><a href="/docs/migrations/">Blog migrations</a></li>
|
|
916
1042
|
|
|
917
1043
|
</ul>
|
|
918
1044
|
|
|
@@ -922,27 +1048,27 @@ with public or secret gists:</p>
|
|
|
922
1048
|
|
|
923
1049
|
|
|
924
1050
|
|
|
925
|
-
<li class="current"><a href="
|
|
1051
|
+
<li class="current"><a href="/docs/templates/">Templates</a></li>
|
|
926
1052
|
|
|
927
1053
|
|
|
928
1054
|
|
|
929
|
-
<li class=""><a href="
|
|
1055
|
+
<li class=""><a href="/docs/permalinks/">Permalinks</a></li>
|
|
930
1056
|
|
|
931
1057
|
|
|
932
1058
|
|
|
933
|
-
<li class=""><a href="
|
|
1059
|
+
<li class=""><a href="/docs/pagination/">Pagination</a></li>
|
|
934
1060
|
|
|
935
1061
|
|
|
936
1062
|
|
|
937
|
-
<li class=""><a href="
|
|
1063
|
+
<li class=""><a href="/docs/plugins/">Plugins</a></li>
|
|
938
1064
|
|
|
939
1065
|
|
|
940
1066
|
|
|
941
|
-
<li class=""><a href="
|
|
1067
|
+
<li class=""><a href="/docs/themes/">Themes</a></li>
|
|
942
1068
|
|
|
943
1069
|
|
|
944
1070
|
|
|
945
|
-
<li class=""><a href="
|
|
1071
|
+
<li class=""><a href="/docs/extras/">Extras</a></li>
|
|
946
1072
|
|
|
947
1073
|
</ul>
|
|
948
1074
|
|
|
@@ -952,15 +1078,15 @@ with public or secret gists:</p>
|
|
|
952
1078
|
|
|
953
1079
|
|
|
954
1080
|
|
|
955
|
-
<li class=""><a href="
|
|
1081
|
+
<li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
|
|
956
1082
|
|
|
957
1083
|
|
|
958
1084
|
|
|
959
|
-
<li class=""><a href="
|
|
1085
|
+
<li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
|
|
960
1086
|
|
|
961
1087
|
|
|
962
1088
|
|
|
963
|
-
<li class=""><a href="
|
|
1089
|
+
<li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
|
|
964
1090
|
|
|
965
1091
|
</ul>
|
|
966
1092
|
|
|
@@ -970,23 +1096,23 @@ with public or secret gists:</p>
|
|
|
970
1096
|
|
|
971
1097
|
|
|
972
1098
|
|
|
973
|
-
<li class=""><a href="
|
|
1099
|
+
<li class=""><a href="/docs/troubleshooting/">Troubleshooting</a></li>
|
|
974
1100
|
|
|
975
1101
|
|
|
976
1102
|
|
|
977
|
-
<li class=""><a href="
|
|
1103
|
+
<li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
|
|
978
1104
|
|
|
979
1105
|
|
|
980
1106
|
|
|
981
|
-
<li class=""><a href="
|
|
1107
|
+
<li class=""><a href="/docs/resources/">Resources</a></li>
|
|
982
1108
|
|
|
983
1109
|
|
|
984
1110
|
|
|
985
|
-
<li class=""><a href="
|
|
1111
|
+
<li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
|
|
986
1112
|
|
|
987
1113
|
|
|
988
1114
|
|
|
989
|
-
<li class=""><a href="
|
|
1115
|
+
<li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
|
|
990
1116
|
|
|
991
1117
|
</ul>
|
|
992
1118
|
|
|
@@ -996,15 +1122,15 @@ with public or secret gists:</p>
|
|
|
996
1122
|
|
|
997
1123
|
|
|
998
1124
|
|
|
999
|
-
<li class=""><a href="
|
|
1125
|
+
<li class=""><a href="/docs/contributing/">Contributing</a></li>
|
|
1000
1126
|
|
|
1001
1127
|
|
|
1002
1128
|
|
|
1003
|
-
<li class=""><a href="
|
|
1129
|
+
<li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
|
|
1004
1130
|
|
|
1005
1131
|
|
|
1006
1132
|
|
|
1007
|
-
<li class=""><a href="
|
|
1133
|
+
<li class=""><a href="/docs/history/">History</a></li>
|
|
1008
1134
|
|
|
1009
1135
|
</ul>
|
|
1010
1136
|
|