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.
Files changed (102) hide show
  1. checksums.yaml +4 -4
  2. data/site/404.html +2 -2
  3. data/site/community/index.html +4 -4
  4. data/site/css/screen.css +16 -8
  5. data/site/docs/assets/index.html +90 -79
  6. data/site/docs/collections/index.html +106 -84
  7. data/site/docs/conduct/index.html +70 -70
  8. data/site/docs/configuration/index.html +143 -93
  9. data/site/docs/continuous-integration/index.html +137 -95
  10. data/site/docs/contributing/index.html +70 -70
  11. data/site/docs/datafiles/index.html +116 -87
  12. data/site/docs/deployment-methods/index.html +108 -84
  13. data/site/docs/drafts/index.html +75 -72
  14. data/site/docs/extras/index.html +74 -71
  15. data/site/docs/frontmatter/index.html +82 -76
  16. data/site/docs/github-pages/index.html +88 -83
  17. data/site/docs/history/index.html +185 -74
  18. data/site/docs/home/index.html +70 -70
  19. data/site/docs/installation/index.html +94 -82
  20. data/site/docs/migrations/index.html +70 -70
  21. data/site/docs/pages/index.html +80 -74
  22. data/site/docs/pagination/index.html +91 -76
  23. data/site/docs/permalinks/index.html +70 -70
  24. data/site/docs/plugins/index.html +142 -96
  25. data/site/docs/posts/index.html +117 -87
  26. data/site/docs/quickstart/index.html +77 -73
  27. data/site/docs/resources/index.html +76 -71
  28. data/site/docs/sites/index.html +70 -70
  29. data/site/docs/static-files/index.html +88 -72
  30. data/site/docs/structure/index.html +79 -76
  31. data/site/docs/templates/index.html +210 -84
  32. data/site/docs/themes/index.html +106 -81
  33. data/site/docs/troubleshooting/index.html +155 -91
  34. data/site/docs/upgrading/0-to-2/index.html +74 -71
  35. data/site/docs/upgrading/2-to-3/index.html +99 -79
  36. data/site/docs/upgrading/index.html +70 -70
  37. data/site/docs/usage/index.html +95 -80
  38. data/site/docs/variables/index.html +71 -72
  39. data/site/docs/windows/index.html +89 -77
  40. data/site/feed.xml +111 -35
  41. data/site/help/index.html +2 -2
  42. data/site/index.html +3 -8
  43. data/site/latest_version.txt +1 -1
  44. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +18 -6
  45. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +18 -6
  46. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +18 -6
  47. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +18 -6
  48. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +18 -6
  49. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +18 -6
  50. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +18 -6
  51. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +18 -6
  52. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +18 -6
  53. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +18 -6
  54. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +18 -6
  55. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +18 -6
  56. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +18 -6
  57. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +18 -6
  58. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +18 -6
  59. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +18 -6
  60. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +18 -6
  61. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +18 -6
  62. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +18 -6
  63. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +18 -6
  64. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +18 -6
  65. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +18 -6
  66. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +18 -6
  67. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +18 -6
  68. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +18 -6
  69. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +18 -6
  70. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +18 -6
  71. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +18 -6
  72. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +18 -6
  73. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +18 -6
  74. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +18 -6
  75. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +18 -6
  76. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +18 -6
  77. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +18 -6
  78. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +18 -6
  79. data/site/news/2015/10/26/jekyll-3-0-released/index.html +18 -6
  80. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +18 -6
  81. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +18 -6
  82. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +18 -6
  83. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +18 -6
  84. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +18 -6
  85. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +18 -6
  86. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +18 -6
  87. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +18 -6
  88. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +18 -6
  89. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +18 -6
  90. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +18 -6
  91. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +18 -6
  92. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +18 -6
  93. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +18 -6
  94. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +19 -7
  95. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +18 -6
  96. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +536 -0
  97. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +615 -0
  98. data/site/news/index.html +172 -7
  99. data/site/news/releases/index.html +135 -7
  100. data/site/sitemap.xml +8 -0
  101. metadata +6 -5
  102. data/site/README.md +0 -16
data/site/docs/permalinks/index.html CHANGED
@@ -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.2.1">
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/permalinks/">
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-08-02T18:14:35-07:00">
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": "Permalinks",
31
- "datePublished": "2016-08-02T18:14:35-07:00",
31
+ "datePublished": "2016-10-06T11:16:34-07:00",
32
32
  "description": "Jekyll supports a flexible way to build your site’s URLs. You can specify thepermalinks for your site through the Configuration or inthe YAML Front Matter for each post. You’re free to chooseone of the built-in styles to create your links or craft your own. The defaultstyle is date.",
33
- "logo": "https://jekyllrb.comimg/logo-2x.png",
33
+ "logo": "https://jekyllrb.com/img/logo-2x.png",
34
34
  "url": "https://jekyllrb.com/docs/permalinks/"
35
35
  }
36
36
  </script>
@@ -114,27 +114,27 @@
114
114
 
115
115
 
116
116
 
117
- <option value="https://jekyllrb.com/docs/home/">Welcome</option>
117
+ <option value="/docs/home/">Welcome</option>
118
118
 
119
119
 
120
120
 
121
- <option value="https://jekyllrb.com/docs/quickstart/">Quick-start guide</option>
121
+ <option value="/docs/quickstart/">Quick-start guide</option>
122
122
 
123
123
 
124
124
 
125
- <option value="https://jekyllrb.com/docs/installation/">Installation</option>
125
+ <option value="/docs/installation/">Installation</option>
126
126
 
127
127
 
128
128
 
129
- <option value="https://jekyllrb.com/docs/usage/">Basic Usage</option>
129
+ <option value="/docs/usage/">Basic Usage</option>
130
130
 
131
131
 
132
132
 
133
- <option value="https://jekyllrb.com/docs/structure/">Directory structure</option>
133
+ <option value="/docs/structure/">Directory structure</option>
134
134
 
135
135
 
136
136
 
137
- <option value="https://jekyllrb.com/docs/configuration/">Configuration</option>
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="https://jekyllrb.com/docs/frontmatter/">Front Matter</option>
146
+ <option value="/docs/frontmatter/">Front Matter</option>
147
147
 
148
148
 
149
149
 
150
- <option value="https://jekyllrb.com/docs/posts/">Writing posts</option>
150
+ <option value="/docs/posts/">Writing posts</option>
151
151
 
152
152
 
153
153
 
154
- <option value="https://jekyllrb.com/docs/drafts/">Working with drafts</option>
154
+ <option value="/docs/drafts/">Working with drafts</option>
155
155
 
156
156
 
157
157
 
158
- <option value="https://jekyllrb.com/docs/pages/">Creating pages</option>
158
+ <option value="/docs/pages/">Creating pages</option>
159
159
 
160
160
 
161
161
 
162
- <option value="https://jekyllrb.com/docs/static-files/">Static Files</option>
162
+ <option value="/docs/static-files/">Static Files</option>
163
163
 
164
164
 
165
165
 
166
- <option value="https://jekyllrb.com/docs/variables/">Variables</option>
166
+ <option value="/docs/variables/">Variables</option>
167
167
 
168
168
 
169
169
 
170
- <option value="https://jekyllrb.com/docs/collections/">Collections</option>
170
+ <option value="/docs/collections/">Collections</option>
171
171
 
172
172
 
173
173
 
174
- <option value="https://jekyllrb.com/docs/datafiles/">Data Files</option>
174
+ <option value="/docs/datafiles/">Data Files</option>
175
175
 
176
176
 
177
177
 
178
- <option value="https://jekyllrb.com/docs/assets/">Assets</option>
178
+ <option value="/docs/assets/">Assets</option>
179
179
 
180
180
 
181
181
 
182
- <option value="https://jekyllrb.com/docs/migrations/">Blog migrations</option>
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="https://jekyllrb.com/docs/templates/">Templates</option>
191
+ <option value="/docs/templates/">Templates</option>
192
192
 
193
193
 
194
194
 
195
- <option value="https://jekyllrb.com/docs/permalinks/">Permalinks</option>
195
+ <option value="/docs/permalinks/">Permalinks</option>
196
196
 
197
197
 
198
198
 
199
- <option value="https://jekyllrb.com/docs/pagination/">Pagination</option>
199
+ <option value="/docs/pagination/">Pagination</option>
200
200
 
201
201
 
202
202
 
203
- <option value="https://jekyllrb.com/docs/plugins/">Plugins</option>
203
+ <option value="/docs/plugins/">Plugins</option>
204
204
 
205
205
 
206
206
 
207
- <option value="https://jekyllrb.com/docs/themes/">Themes</option>
207
+ <option value="/docs/themes/">Themes</option>
208
208
 
209
209
 
210
210
 
211
- <option value="https://jekyllrb.com/docs/extras/">Extras</option>
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="https://jekyllrb.com/docs/github-pages/">GitHub Pages</option>
220
+ <option value="/docs/github-pages/">GitHub Pages</option>
221
221
 
222
222
 
223
223
 
224
- <option value="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</option>
224
+ <option value="/docs/deployment-methods/">Deployment methods</option>
225
225
 
226
226
 
227
227
 
228
- <option value="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</option>
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="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</option>
237
+ <option value="/docs/troubleshooting/">Troubleshooting</option>
238
238
 
239
239
 
240
240
 
241
- <option value="https://jekyllrb.com/docs/sites/">Sites using Jekyll</option>
241
+ <option value="/docs/sites/">Sites using Jekyll</option>
242
242
 
243
243
 
244
244
 
245
- <option value="https://jekyllrb.com/docs/resources/">Resources</option>
245
+ <option value="/docs/resources/">Resources</option>
246
246
 
247
247
 
248
248
 
249
- <option value="https://jekyllrb.com/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
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="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
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="https://jekyllrb.com/docs/contributing/">Contributing</option>
262
+ <option value="/docs/contributing/">Contributing</option>
263
263
 
264
264
 
265
265
 
266
- <option value="https://jekyllrb.com/docs/conduct/">Code of Conduct</option>
266
+ <option value="/docs/conduct/">Code of Conduct</option>
267
267
 
268
268
 
269
269
 
270
- <option value="https://jekyllrb.com/docs/history/">History</option>
270
+ <option value="/docs/history/">History</option>
271
271
 
272
272
 
273
273
  </optgroup>
@@ -665,27 +665,27 @@ not found.</p>
665
665
 
666
666
 
667
667
 
668
- <li class=""><a href="https://jekyllrb.com/docs/home/">Welcome</a></li>
668
+ <li class=""><a href="/docs/home/">Welcome</a></li>
669
669
 
670
670
 
671
671
 
672
- <li class=""><a href="https://jekyllrb.com/docs/quickstart/">Quick-start guide</a></li>
672
+ <li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
673
673
 
674
674
 
675
675
 
676
- <li class=""><a href="https://jekyllrb.com/docs/installation/">Installation</a></li>
676
+ <li class=""><a href="/docs/installation/">Installation</a></li>
677
677
 
678
678
 
679
679
 
680
- <li class=""><a href="https://jekyllrb.com/docs/usage/">Basic Usage</a></li>
680
+ <li class=""><a href="/docs/usage/">Basic Usage</a></li>
681
681
 
682
682
 
683
683
 
684
- <li class=""><a href="https://jekyllrb.com/docs/structure/">Directory structure</a></li>
684
+ <li class=""><a href="/docs/structure/">Directory structure</a></li>
685
685
 
686
686
 
687
687
 
688
- <li class=""><a href="https://jekyllrb.com/docs/configuration/">Configuration</a></li>
688
+ <li class=""><a href="/docs/configuration/">Configuration</a></li>
689
689
 
690
690
  </ul>
691
691
 
@@ -695,43 +695,43 @@ not found.</p>
695
695
 
696
696
 
697
697
 
698
- <li class=""><a href="https://jekyllrb.com/docs/frontmatter/">Front Matter</a></li>
698
+ <li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
699
699
 
700
700
 
701
701
 
702
- <li class=""><a href="https://jekyllrb.com/docs/posts/">Writing posts</a></li>
702
+ <li class=""><a href="/docs/posts/">Writing posts</a></li>
703
703
 
704
704
 
705
705
 
706
- <li class=""><a href="https://jekyllrb.com/docs/drafts/">Working with drafts</a></li>
706
+ <li class=""><a href="/docs/drafts/">Working with drafts</a></li>
707
707
 
708
708
 
709
709
 
710
- <li class=""><a href="https://jekyllrb.com/docs/pages/">Creating pages</a></li>
710
+ <li class=""><a href="/docs/pages/">Creating pages</a></li>
711
711
 
712
712
 
713
713
 
714
- <li class=""><a href="https://jekyllrb.com/docs/static-files/">Static Files</a></li>
714
+ <li class=""><a href="/docs/static-files/">Static Files</a></li>
715
715
 
716
716
 
717
717
 
718
- <li class=""><a href="https://jekyllrb.com/docs/variables/">Variables</a></li>
718
+ <li class=""><a href="/docs/variables/">Variables</a></li>
719
719
 
720
720
 
721
721
 
722
- <li class=""><a href="https://jekyllrb.com/docs/collections/">Collections</a></li>
722
+ <li class=""><a href="/docs/collections/">Collections</a></li>
723
723
 
724
724
 
725
725
 
726
- <li class=""><a href="https://jekyllrb.com/docs/datafiles/">Data Files</a></li>
726
+ <li class=""><a href="/docs/datafiles/">Data Files</a></li>
727
727
 
728
728
 
729
729
 
730
- <li class=""><a href="https://jekyllrb.com/docs/assets/">Assets</a></li>
730
+ <li class=""><a href="/docs/assets/">Assets</a></li>
731
731
 
732
732
 
733
733
 
734
- <li class=""><a href="https://jekyllrb.com/docs/migrations/">Blog migrations</a></li>
734
+ <li class=""><a href="/docs/migrations/">Blog migrations</a></li>
735
735
 
736
736
  </ul>
737
737
 
@@ -741,27 +741,27 @@ not found.</p>
741
741
 
742
742
 
743
743
 
744
- <li class=""><a href="https://jekyllrb.com/docs/templates/">Templates</a></li>
744
+ <li class=""><a href="/docs/templates/">Templates</a></li>
745
745
 
746
746
 
747
747
 
748
- <li class="current"><a href="https://jekyllrb.com/docs/permalinks/">Permalinks</a></li>
748
+ <li class="current"><a href="/docs/permalinks/">Permalinks</a></li>
749
749
 
750
750
 
751
751
 
752
- <li class=""><a href="https://jekyllrb.com/docs/pagination/">Pagination</a></li>
752
+ <li class=""><a href="/docs/pagination/">Pagination</a></li>
753
753
 
754
754
 
755
755
 
756
- <li class=""><a href="https://jekyllrb.com/docs/plugins/">Plugins</a></li>
756
+ <li class=""><a href="/docs/plugins/">Plugins</a></li>
757
757
 
758
758
 
759
759
 
760
- <li class=""><a href="https://jekyllrb.com/docs/themes/">Themes</a></li>
760
+ <li class=""><a href="/docs/themes/">Themes</a></li>
761
761
 
762
762
 
763
763
 
764
- <li class=""><a href="https://jekyllrb.com/docs/extras/">Extras</a></li>
764
+ <li class=""><a href="/docs/extras/">Extras</a></li>
765
765
 
766
766
  </ul>
767
767
 
@@ -771,15 +771,15 @@ not found.</p>
771
771
 
772
772
 
773
773
 
774
- <li class=""><a href="https://jekyllrb.com/docs/github-pages/">GitHub Pages</a></li>
774
+ <li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
775
775
 
776
776
 
777
777
 
778
- <li class=""><a href="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</a></li>
778
+ <li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
779
779
 
780
780
 
781
781
 
782
- <li class=""><a href="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</a></li>
782
+ <li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
783
783
 
784
784
  </ul>
785
785
 
@@ -789,23 +789,23 @@ not found.</p>
789
789
 
790
790
 
791
791
 
792
- <li class=""><a href="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</a></li>
792
+ <li class=""><a href="/docs/troubleshooting/">Troubleshooting</a></li>
793
793
 
794
794
 
795
795
 
796
- <li class=""><a href="https://jekyllrb.com/docs/sites/">Sites using Jekyll</a></li>
796
+ <li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
797
797
 
798
798
 
799
799
 
800
- <li class=""><a href="https://jekyllrb.com/docs/resources/">Resources</a></li>
800
+ <li class=""><a href="/docs/resources/">Resources</a></li>
801
801
 
802
802
 
803
803
 
804
- <li class=""><a href="https://jekyllrb.com/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
804
+ <li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
805
805
 
806
806
 
807
807
 
808
- <li class=""><a href="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
808
+ <li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
809
809
 
810
810
  </ul>
811
811
 
@@ -815,15 +815,15 @@ not found.</p>
815
815
 
816
816
 
817
817
 
818
- <li class=""><a href="https://jekyllrb.com/docs/contributing/">Contributing</a></li>
818
+ <li class=""><a href="/docs/contributing/">Contributing</a></li>
819
819
 
820
820
 
821
821
 
822
- <li class=""><a href="https://jekyllrb.com/docs/conduct/">Code of Conduct</a></li>
822
+ <li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
823
823
 
824
824
 
825
825
 
826
- <li class=""><a href="https://jekyllrb.com/docs/history/">History</a></li>
826
+ <li class=""><a href="/docs/history/">History</a></li>
827
827
 
828
828
  </ul>
829
829
 
data/site/docs/plugins/index.html CHANGED
@@ -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.2.1">
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/plugins/">
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-08-02T18:14:35-07:00">
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": "Plugins",
31
- "datePublished": "2016-08-02T18:14:35-07:00",
31
+ "datePublished": "2016-10-06T11:16:34-07:00",
32
32
  "description": "Jekyll has a plugin system with hooks that allow you to create custom generatedcontent specific to your site. You can run custom code for your site withouthaving to modify the Jekyll source itself.",
33
- "logo": "https://jekyllrb.comimg/logo-2x.png",
33
+ "logo": "https://jekyllrb.com/img/logo-2x.png",
34
34
  "url": "https://jekyllrb.com/docs/plugins/"
35
35
  }
36
36
  </script>
@@ -114,27 +114,27 @@
114
114
 
115
115
 
116
116
 
117
- <option value="https://jekyllrb.com/docs/home/">Welcome</option>
117
+ <option value="/docs/home/">Welcome</option>
118
118
 
119
119
 
120
120
 
121
- <option value="https://jekyllrb.com/docs/quickstart/">Quick-start guide</option>
121
+ <option value="/docs/quickstart/">Quick-start guide</option>
122
122
 
123
123
 
124
124
 
125
- <option value="https://jekyllrb.com/docs/installation/">Installation</option>
125
+ <option value="/docs/installation/">Installation</option>
126
126
 
127
127
 
128
128
 
129
- <option value="https://jekyllrb.com/docs/usage/">Basic Usage</option>
129
+ <option value="/docs/usage/">Basic Usage</option>
130
130
 
131
131
 
132
132
 
133
- <option value="https://jekyllrb.com/docs/structure/">Directory structure</option>
133
+ <option value="/docs/structure/">Directory structure</option>
134
134
 
135
135
 
136
136
 
137
- <option value="https://jekyllrb.com/docs/configuration/">Configuration</option>
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="https://jekyllrb.com/docs/frontmatter/">Front Matter</option>
146
+ <option value="/docs/frontmatter/">Front Matter</option>
147
147
 
148
148
 
149
149
 
150
- <option value="https://jekyllrb.com/docs/posts/">Writing posts</option>
150
+ <option value="/docs/posts/">Writing posts</option>
151
151
 
152
152
 
153
153
 
154
- <option value="https://jekyllrb.com/docs/drafts/">Working with drafts</option>
154
+ <option value="/docs/drafts/">Working with drafts</option>
155
155
 
156
156
 
157
157
 
158
- <option value="https://jekyllrb.com/docs/pages/">Creating pages</option>
158
+ <option value="/docs/pages/">Creating pages</option>
159
159
 
160
160
 
161
161
 
162
- <option value="https://jekyllrb.com/docs/static-files/">Static Files</option>
162
+ <option value="/docs/static-files/">Static Files</option>
163
163
 
164
164
 
165
165
 
166
- <option value="https://jekyllrb.com/docs/variables/">Variables</option>
166
+ <option value="/docs/variables/">Variables</option>
167
167
 
168
168
 
169
169
 
170
- <option value="https://jekyllrb.com/docs/collections/">Collections</option>
170
+ <option value="/docs/collections/">Collections</option>
171
171
 
172
172
 
173
173
 
174
- <option value="https://jekyllrb.com/docs/datafiles/">Data Files</option>
174
+ <option value="/docs/datafiles/">Data Files</option>
175
175
 
176
176
 
177
177
 
178
- <option value="https://jekyllrb.com/docs/assets/">Assets</option>
178
+ <option value="/docs/assets/">Assets</option>
179
179
 
180
180
 
181
181
 
182
- <option value="https://jekyllrb.com/docs/migrations/">Blog migrations</option>
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="https://jekyllrb.com/docs/templates/">Templates</option>
191
+ <option value="/docs/templates/">Templates</option>
192
192
 
193
193
 
194
194
 
195
- <option value="https://jekyllrb.com/docs/permalinks/">Permalinks</option>
195
+ <option value="/docs/permalinks/">Permalinks</option>
196
196
 
197
197
 
198
198
 
199
- <option value="https://jekyllrb.com/docs/pagination/">Pagination</option>
199
+ <option value="/docs/pagination/">Pagination</option>
200
200
 
201
201
 
202
202
 
203
- <option value="https://jekyllrb.com/docs/plugins/">Plugins</option>
203
+ <option value="/docs/plugins/">Plugins</option>
204
204
 
205
205
 
206
206
 
207
- <option value="https://jekyllrb.com/docs/themes/">Themes</option>
207
+ <option value="/docs/themes/">Themes</option>
208
208
 
209
209
 
210
210
 
211
- <option value="https://jekyllrb.com/docs/extras/">Extras</option>
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="https://jekyllrb.com/docs/github-pages/">GitHub Pages</option>
220
+ <option value="/docs/github-pages/">GitHub Pages</option>
221
221
 
222
222
 
223
223
 
224
- <option value="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</option>
224
+ <option value="/docs/deployment-methods/">Deployment methods</option>
225
225
 
226
226
 
227
227
 
228
- <option value="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</option>
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="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</option>
237
+ <option value="/docs/troubleshooting/">Troubleshooting</option>
238
238
 
239
239
 
240
240
 
241
- <option value="https://jekyllrb.com/docs/sites/">Sites using Jekyll</option>
241
+ <option value="/docs/sites/">Sites using Jekyll</option>
242
242
 
243
243
 
244
244
 
245
- <option value="https://jekyllrb.com/docs/resources/">Resources</option>
245
+ <option value="/docs/resources/">Resources</option>
246
246
 
247
247
 
248
248
 
249
- <option value="https://jekyllrb.com/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
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="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
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="https://jekyllrb.com/docs/contributing/">Contributing</option>
262
+ <option value="/docs/contributing/">Contributing</option>
263
263
 
264
264
 
265
265
 
266
- <option value="https://jekyllrb.com/docs/conduct/">Code of Conduct</option>
266
+ <option value="/docs/conduct/">Code of Conduct</option>
267
267
 
268
268
 
269
269
 
270
- <option value="https://jekyllrb.com/docs/history/">History</option>
270
+ <option value="/docs/history/">History</option>
271
271
 
272
272
 
273
273
  </optgroup>
@@ -382,7 +382,8 @@ for more details.</p>
382
382
  variables. In the following example the template <code class="highlighter-rouge">reading.html</code> has two
383
383
  variables <code class="highlighter-rouge">ongoing</code> and <code class="highlighter-rouge">done</code> that we fill in the generator:</p>
384
384
 
385
- <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="k">module</span> <span class="nn">Reading</span>
385
+ <div class="language-ruby highlighter-rouge">
386
+ <pre class="highlight"><code><span class="k">module</span> <span class="nn">Reading</span>
386
387
  <span class="k">class</span> <span class="nc">Generator</span> <span class="o">&lt;</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">Generator</span>
387
388
  <span class="k">def</span> <span class="nf">generate</span><span class="p">(</span><span class="n">site</span><span class="p">)</span>
388
389
  <span class="n">ongoing</span><span class="p">,</span> <span class="n">done</span> <span class="o">=</span> <span class="no">Book</span><span class="p">.</span><span class="nf">all</span><span class="p">.</span><span class="nf">partition</span><span class="p">(</span><span class="o">&amp;</span><span class="ss">:ongoing?</span><span class="p">)</span>
@@ -392,11 +393,14 @@ variables <code class="highlighter-rouge">ongoing</code> and <code class="highli
392
393
  <span class="n">reading</span><span class="p">.</span><span class="nf">data</span><span class="p">[</span><span class="s1">'done'</span><span class="p">]</span> <span class="o">=</span> <span class="n">done</span>
393
394
  <span class="k">end</span>
394
395
  <span class="k">end</span>
395
- <span class="k">end</span></code></pre></figure>
396
+ <span class="k">end</span>
397
+ </code></pre>
398
+ </div>
396
399
 
397
400
  <p>This is a more complex generator that generates new pages:</p>
398
401
 
399
- <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="k">module</span> <span class="nn">Jekyll</span>
402
+ <div class="language-ruby highlighter-rouge">
403
+ <pre class="highlight"><code><span class="k">module</span> <span class="nn">Jekyll</span>
400
404
 
401
405
  <span class="k">class</span> <span class="nc">CategoryPage</span> <span class="o">&lt;</span> <span class="no">Page</span>
402
406
  <span class="k">def</span> <span class="nf">initialize</span><span class="p">(</span><span class="n">site</span><span class="p">,</span> <span class="n">base</span><span class="p">,</span> <span class="n">dir</span><span class="p">,</span> <span class="n">category</span><span class="p">)</span>
@@ -427,7 +431,9 @@ variables <code class="highlighter-rouge">ongoing</code> and <code class="highli
427
431
  <span class="k">end</span>
428
432
  <span class="k">end</span>
429
433
 
430
- <span class="k">end</span></code></pre></figure>
434
+ <span class="k">end</span>
435
+ </code></pre>
436
+ </div>
431
437
 
432
438
  <p>In this example, our generator will create a series of files under the
433
439
  <code class="highlighter-rouge">categories</code> directory for each category, listing the posts in each category
@@ -474,7 +480,8 @@ languages are implemented using this method.</p>
474
480
  <p>Below is a converter that will take all posts ending in <code class="highlighter-rouge">.upcase</code> and process
475
481
  them using the <code class="highlighter-rouge">UpcaseConverter</code>:</p>
476
482
 
477
- <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="k">module</span> <span class="nn">Jekyll</span>
483
+ <div class="language-ruby highlighter-rouge">
484
+ <pre class="highlight"><code><span class="k">module</span> <span class="nn">Jekyll</span>
478
485
  <span class="k">class</span> <span class="nc">UpcaseConverter</span> <span class="o">&lt;</span> <span class="no">Converter</span>
479
486
  <span class="n">safe</span> <span class="kp">true</span>
480
487
  <span class="n">priority</span> <span class="ss">:low</span>
@@ -491,7 +498,9 @@ them using the <code class="highlighter-rouge">UpcaseConverter</code>:</p>
491
498
  <span class="n">content</span><span class="p">.</span><span class="nf">upcase</span>
492
499
  <span class="k">end</span>
493
500
  <span class="k">end</span>
494
- <span class="k">end</span></code></pre></figure>
501
+ <span class="k">end</span>
502
+ </code></pre>
503
+ </div>
495
504
 
496
505
  <p>Converters should implement at a minimum 3 methods:</p>
497
506
 
@@ -549,14 +558,18 @@ it will do so with a <code class="highlighter-rouge">.html</code> extension.</p>
549
558
  subcommands for the <code class="highlighter-rouge">jekyll</code> executable. This is possible by including the
550
559
  relevant plugins in a <code class="highlighter-rouge">Gemfile</code> group called <code class="highlighter-rouge">:jekyll_plugins</code>:</p>
551
560
 
552
- <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="n">group</span> <span class="ss">:jekyll_plugins</span> <span class="k">do</span>
561
+ <div class="language-ruby highlighter-rouge">
562
+ <pre class="highlight"><code><span class="n">group</span> <span class="ss">:jekyll_plugins</span> <span class="k">do</span>
553
563
  <span class="n">gem</span> <span class="s2">"my_fancy_jekyll_plugin"</span>
554
- <span class="k">end</span></code></pre></figure>
564
+ <span class="k">end</span>
565
+ </code></pre>
566
+ </div>
555
567
 
556
568
  <p>Each <code class="highlighter-rouge">Command</code> must be a subclass of the <code class="highlighter-rouge">Jekyll::Command</code> class and must
557
569
  contain one class method: <code class="highlighter-rouge">init_with_program</code>. An example:</p>
558
570
 
559
- <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="k">class</span> <span class="nc">MyNewCommand</span> <span class="o">&lt;</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">Command</span>
571
+ <div class="language-ruby highlighter-rouge">
572
+ <pre class="highlight"><code><span class="k">class</span> <span class="nc">MyNewCommand</span> <span class="o">&lt;</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">Command</span>
560
573
  <span class="k">class</span> <span class="o">&lt;&lt;</span> <span class="nb">self</span>
561
574
  <span class="k">def</span> <span class="nf">init_with_program</span><span class="p">(</span><span class="n">prog</span><span class="p">)</span>
562
575
  <span class="n">prog</span><span class="p">.</span><span class="nf">command</span><span class="p">(</span><span class="ss">:new</span><span class="p">)</span> <span class="k">do</span> <span class="o">|</span><span class="n">c</span><span class="o">|</span>
@@ -571,7 +584,9 @@ contain one class method: <code class="highlighter-rouge">init_with_program</cod
571
584
  <span class="k">end</span>
572
585
  <span class="k">end</span>
573
586
  <span class="k">end</span>
574
- <span class="k">end</span></code></pre></figure>
587
+ <span class="k">end</span>
588
+ </code></pre>
589
+ </div>
575
590
 
576
591
  <p>Commands should implement this single class method:</p>
577
592
 
@@ -607,7 +622,8 @@ hooking into the tagging system. Built-in examples added by Jekyll include the
607
622
  <code class="highlighter-rouge">highlight</code> and <code class="highlighter-rouge">include</code> tags. Below is an example of a custom liquid tag that
608
623
  will output the time the page was rendered:</p>
609
624
 
610
- <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="k">module</span> <span class="nn">Jekyll</span>
625
+ <div class="language-ruby highlighter-rouge">
626
+ <pre class="highlight"><code><span class="k">module</span> <span class="nn">Jekyll</span>
611
627
  <span class="k">class</span> <span class="nc">RenderTimeTag</span> <span class="o">&lt;</span> <span class="no">Liquid</span><span class="o">::</span><span class="no">Tag</span>
612
628
 
613
629
  <span class="k">def</span> <span class="nf">initialize</span><span class="p">(</span><span class="n">tag_name</span><span class="p">,</span> <span class="n">text</span><span class="p">,</span> <span class="n">tokens</span><span class="p">)</span>
@@ -621,7 +637,9 @@ will output the time the page was rendered:</p>
621
637
  <span class="k">end</span>
622
638
  <span class="k">end</span>
623
639
 
624
- <span class="no">Liquid</span><span class="o">::</span><span class="no">Template</span><span class="p">.</span><span class="nf">register_tag</span><span class="p">(</span><span class="s1">'render_time'</span><span class="p">,</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">RenderTimeTag</span><span class="p">)</span></code></pre></figure>
640
+ <span class="no">Liquid</span><span class="o">::</span><span class="no">Template</span><span class="p">.</span><span class="nf">register_tag</span><span class="p">(</span><span class="s1">'render_time'</span><span class="p">,</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">RenderTimeTag</span><span class="p">)</span>
641
+ </code></pre>
642
+ </div>
625
643
 
626
644
  <p>At a minimum, liquid tags must implement:</p>
627
645
 
@@ -649,16 +667,27 @@ will output the time the page was rendered:</p>
649
667
  <p>You must also register the custom tag with the Liquid template engine as
650
668
  follows:</p>
651
669
 
652
- <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="no">Liquid</span><span class="o">::</span><span class="no">Template</span><span class="p">.</span><span class="nf">register_tag</span><span class="p">(</span><span class="s1">'render_time'</span><span class="p">,</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">RenderTimeTag</span><span class="p">)</span></code></pre></figure>
670
+ <div class="language-ruby highlighter-rouge">
671
+ <pre class="highlight"><code><span class="no">Liquid</span><span class="o">::</span><span class="no">Template</span><span class="p">.</span><span class="nf">register_tag</span><span class="p">(</span><span class="s1">'render_time'</span><span class="p">,</span> <span class="no">Jekyll</span><span class="o">::</span><span class="no">RenderTimeTag</span><span class="p">)</span>
672
+ </code></pre>
673
+ </div>
653
674
 
654
675
  <p>In the example above, we can place the following tag anywhere in one of our
655
676
  pages:</p>
656
677
 
657
- <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="o">&lt;</span><span class="nb">p</span><span class="o">&gt;</span><span class="p">{</span><span class="sx">% render_time </span><span class="n">page</span> <span class="n">rendered</span> <span class="ss">at: </span><span class="sx">%}&lt;/p&gt;</span></code></pre></figure>
678
+ <div class="language-ruby highlighter-rouge">
679
+ <pre class="highlight"><code>
680
+ <span class="o">&lt;</span><span class="nb">p</span><span class="o">&gt;</span><span class="p">{</span><span class="sx">% render_time </span><span class="n">page</span> <span class="n">rendered</span> <span class="ss">at: </span><span class="sx">%}&lt;/p&gt;
681
+
682
+ </span></code></pre>
683
+ </div>
658
684
 
659
685
  <p>And we would get something like this on the page:</p>
660
686
 
661
- <figure class="highlight"><pre><code class="language-html" data-lang="html"><span class="nt">&lt;p&gt;</span>page rendered at: Tue June 22 23:38:47 –0500 2010<span class="nt">&lt;/p&gt;</span></code></pre></figure>
687
+ <div class="language-html highlighter-rouge">
688
+ <pre class="highlight"><code><span class="nt">&lt;p&gt;</span>page rendered at: Tue June 22 23:38:47 –0500 2010<span class="nt">&lt;/p&gt;</span>
689
+ </code></pre>
690
+ </div>
662
691
 
663
692
  <h3 id="liquid-filters">Liquid filters</h3>
664
693
 
@@ -667,7 +696,8 @@ add tags above. Filters are simply modules that export their methods to liquid.
667
696
  All methods will have to take at least one parameter which represents the input
668
697
  of the filter. The return value will be the output of the filter.</p>
669
698
 
670
- <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="k">module</span> <span class="nn">Jekyll</span>
699
+ <div class="language-ruby highlighter-rouge">
700
+ <pre class="highlight"><code><span class="k">module</span> <span class="nn">Jekyll</span>
671
701
  <span class="k">module</span> <span class="nn">AssetFilter</span>
672
702
  <span class="k">def</span> <span class="nf">asset_url</span><span class="p">(</span><span class="n">input</span><span class="p">)</span>
673
703
  <span class="s2">"http://www.example.com/</span><span class="si">#{</span><span class="n">input</span><span class="si">}</span><span class="s2">?</span><span class="si">#{</span><span class="no">Time</span><span class="p">.</span><span class="nf">now</span><span class="p">.</span><span class="nf">to_i</span><span class="si">}</span><span class="s2">"</span>
@@ -675,7 +705,9 @@ of the filter. The return value will be the output of the filter.</p>
675
705
  <span class="k">end</span>
676
706
  <span class="k">end</span>
677
707
 
678
- <span class="no">Liquid</span><span class="o">::</span><span class="no">Template</span><span class="p">.</span><span class="nf">register_filter</span><span class="p">(</span><span class="no">Jekyll</span><span class="o">::</span><span class="no">AssetFilter</span><span class="p">)</span></code></pre></figure>
708
+ <span class="no">Liquid</span><span class="o">::</span><span class="no">Template</span><span class="p">.</span><span class="nf">register_filter</span><span class="p">(</span><span class="no">Jekyll</span><span class="o">::</span><span class="no">AssetFilter</span><span class="p">)</span>
709
+ </code></pre>
710
+ </div>
679
711
 
680
712
  <div class="note">
681
713
  <h5>ProTip™: Access the site object using Liquid</h5>
@@ -736,13 +768,16 @@ of the filter. The return value will be the output of the filter.</p>
736
768
  <p>To use one of the example plugins above as an illustration, here is how you’d
737
769
  specify these two flags:</p>
738
770
 
739
- <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="k">module</span> <span class="nn">Jekyll</span>
771
+ <div class="language-ruby highlighter-rouge">
772
+ <pre class="highlight"><code><span class="k">module</span> <span class="nn">Jekyll</span>
740
773
  <span class="k">class</span> <span class="nc">UpcaseConverter</span> <span class="o">&lt;</span> <span class="no">Converter</span>
741
774
  <span class="n">safe</span> <span class="kp">true</span>
742
775
  <span class="n">priority</span> <span class="ss">:low</span>
743
776
  <span class="p">.</span><span class="nf">.</span><span class="p">.</span>
744
777
  <span class="nf">end</span>
745
- <span class="k">end</span></code></pre></figure>
778
+ <span class="k">end</span>
779
+ </code></pre>
780
+ </div>
746
781
 
747
782
  <h2 id="hooks">Hooks</h2>
748
783
 
@@ -756,16 +791,21 @@ call whenever the hook is triggered. For example, if you want to execute some
756
791
  custom functionality every time Jekyll renders a post, you could register a
757
792
  hook like this:</p>
758
793
 
759
- <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="no">Jekyll</span><span class="o">::</span><span class="no">Hooks</span><span class="p">.</span><span class="nf">register</span> <span class="ss">:posts</span><span class="p">,</span> <span class="ss">:post_render</span> <span class="k">do</span> <span class="o">|</span><span class="n">post</span><span class="o">|</span>
794
+ <div class="language-ruby highlighter-rouge">
795
+ <pre class="highlight"><code><span class="no">Jekyll</span><span class="o">::</span><span class="no">Hooks</span><span class="p">.</span><span class="nf">register</span> <span class="ss">:posts</span><span class="p">,</span> <span class="ss">:post_render</span> <span class="k">do</span> <span class="o">|</span><span class="n">post</span><span class="o">|</span>
760
796
  <span class="c1"># code to call after Jekyll renders a post</span>
761
- <span class="k">end</span></code></pre></figure>
797
+ <span class="k">end</span>
798
+ </code></pre>
799
+ </div>
762
800
 
763
801
  <p>Jekyll provides hooks for <code>:site</code>, <code>:pages</code>,
764
- <code>:posts</code>, and <code>:documents</code>. In all cases, Jekyll calls your
765
- hooks with the container object as the first callback parameter. But in the
766
- case of <code>:pre_render</code>, your hook will also receive a payload hash as
767
- a second parameter which allows you full control over the variables that are
768
- available while rendering.</p>
802
+ <code>:posts</code>, and <code>:documents</code>. In all cases, Jekyll calls
803
+ your hooks with the container object as the first callback parameter. However,
804
+ all <code class="highlighter-rouge">:pre_render</code> hooks and the<code class="highlighter-rouge">:site, :post_render</code> hook will also provide a
805
+ payload hash as a second parameter. In the case of <code class="highlighter-rouge">:pre_render</code>, the payload
806
+ gives you full control over the variables that are available while rendering.
807
+ In the case of <code class="highlighter-rouge">:site, :post_render</code>, the payload contains final values after
808
+ rendering all the site (useful for sitemaps, feeds, etc).</p>
769
809
 
770
810
  <p>The complete list of available hooks is below:</p>
771
811
 
@@ -1262,6 +1302,8 @@ LESS.js files during generation.</li>
1262
1302
  <a href="https://github.com/crispgm/jekyll-tags-list-plugin">Jekyll Tags List Plugin</a>: A Liquid tag plugin that creates tags list in specific order.</li>
1263
1303
  <li>
1264
1304
  <a href="https://github.com/ayastreb/jekyll-maps">Jekyll Maps</a> by <a href="https://github.com/ayastreb">Anatoliy Yastreb</a>: A Jekyll plugin to easily embed maps with filterable locations.</li>
1305
+ <li>
1306
+ <a href="https://nhoizey.github.io/jekyll-cloudinary/">Jekyll Cloudinary</a> by <a href="https://nicolas-hoizey.com/">Nicolas Hoizey</a>: a Jekyll plugin adding a Liquid tag to ease the use of Cloudinary for responsive images in your Markdown/Kramdown posts.</li>
1265
1307
  </ul>
1266
1308
 
1267
1309
  <h4 id="collections">Collections</h4>
@@ -1348,6 +1390,10 @@ LESS.js files during generation.</li>
1348
1390
  <a href="https://github.com/git-no/jekyll-breadcrumbs">Jekyll-breadcrumbs</a>: Creates breadcrumbs for Jekyll 3.x, includes features like SEO optimization, optional breadcrumb item translation and more.</li>
1349
1391
  <li>
1350
1392
  <a href="https://github.com/sondr3/generator-jekyllized">generator-jekyllized</a>: A Yeoman generator for rapidly developing sites with Gulp. Live reload your site, automatically minify and optimize your assets and much more.</li>
1393
+ <li>
1394
+ <a href="https://github.com/MertcanGokgoz/Jekyll-Spotify">Jekyll-Spotify</a>: Easily output Spotify Embed Player for jekyll</li>
1395
+ <li>
1396
+ <a href="https://github.com/forestryio/jekyll-menus">jekyll-menus</a>: Hugo style menus for your Jekyll site… recursive menus included.</li>
1351
1397
  </ul>
1352
1398
 
1353
1399
  <h4 id="editors">Editors</h4>
@@ -1467,27 +1513,27 @@ new posts and run <code class="highlighter-rouge">jekyll build</code> all withou
1467
1513
 
1468
1514
 
1469
1515
 
1470
- <li class=""><a href="https://jekyllrb.com/docs/home/">Welcome</a></li>
1516
+ <li class=""><a href="/docs/home/">Welcome</a></li>
1471
1517
 
1472
1518
 
1473
1519
 
1474
- <li class=""><a href="https://jekyllrb.com/docs/quickstart/">Quick-start guide</a></li>
1520
+ <li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
1475
1521
 
1476
1522
 
1477
1523
 
1478
- <li class=""><a href="https://jekyllrb.com/docs/installation/">Installation</a></li>
1524
+ <li class=""><a href="/docs/installation/">Installation</a></li>
1479
1525
 
1480
1526
 
1481
1527
 
1482
- <li class=""><a href="https://jekyllrb.com/docs/usage/">Basic Usage</a></li>
1528
+ <li class=""><a href="/docs/usage/">Basic Usage</a></li>
1483
1529
 
1484
1530
 
1485
1531
 
1486
- <li class=""><a href="https://jekyllrb.com/docs/structure/">Directory structure</a></li>
1532
+ <li class=""><a href="/docs/structure/">Directory structure</a></li>
1487
1533
 
1488
1534
 
1489
1535
 
1490
- <li class=""><a href="https://jekyllrb.com/docs/configuration/">Configuration</a></li>
1536
+ <li class=""><a href="/docs/configuration/">Configuration</a></li>
1491
1537
 
1492
1538
  </ul>
1493
1539
 
@@ -1497,43 +1543,43 @@ new posts and run <code class="highlighter-rouge">jekyll build</code> all withou
1497
1543
 
1498
1544
 
1499
1545
 
1500
- <li class=""><a href="https://jekyllrb.com/docs/frontmatter/">Front Matter</a></li>
1546
+ <li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
1501
1547
 
1502
1548
 
1503
1549
 
1504
- <li class=""><a href="https://jekyllrb.com/docs/posts/">Writing posts</a></li>
1550
+ <li class=""><a href="/docs/posts/">Writing posts</a></li>
1505
1551
 
1506
1552
 
1507
1553
 
1508
- <li class=""><a href="https://jekyllrb.com/docs/drafts/">Working with drafts</a></li>
1554
+ <li class=""><a href="/docs/drafts/">Working with drafts</a></li>
1509
1555
 
1510
1556
 
1511
1557
 
1512
- <li class=""><a href="https://jekyllrb.com/docs/pages/">Creating pages</a></li>
1558
+ <li class=""><a href="/docs/pages/">Creating pages</a></li>
1513
1559
 
1514
1560
 
1515
1561
 
1516
- <li class=""><a href="https://jekyllrb.com/docs/static-files/">Static Files</a></li>
1562
+ <li class=""><a href="/docs/static-files/">Static Files</a></li>
1517
1563
 
1518
1564
 
1519
1565
 
1520
- <li class=""><a href="https://jekyllrb.com/docs/variables/">Variables</a></li>
1566
+ <li class=""><a href="/docs/variables/">Variables</a></li>
1521
1567
 
1522
1568
 
1523
1569
 
1524
- <li class=""><a href="https://jekyllrb.com/docs/collections/">Collections</a></li>
1570
+ <li class=""><a href="/docs/collections/">Collections</a></li>
1525
1571
 
1526
1572
 
1527
1573
 
1528
- <li class=""><a href="https://jekyllrb.com/docs/datafiles/">Data Files</a></li>
1574
+ <li class=""><a href="/docs/datafiles/">Data Files</a></li>
1529
1575
 
1530
1576
 
1531
1577
 
1532
- <li class=""><a href="https://jekyllrb.com/docs/assets/">Assets</a></li>
1578
+ <li class=""><a href="/docs/assets/">Assets</a></li>
1533
1579
 
1534
1580
 
1535
1581
 
1536
- <li class=""><a href="https://jekyllrb.com/docs/migrations/">Blog migrations</a></li>
1582
+ <li class=""><a href="/docs/migrations/">Blog migrations</a></li>
1537
1583
 
1538
1584
  </ul>
1539
1585
 
@@ -1543,27 +1589,27 @@ new posts and run <code class="highlighter-rouge">jekyll build</code> all withou
1543
1589
 
1544
1590
 
1545
1591
 
1546
- <li class=""><a href="https://jekyllrb.com/docs/templates/">Templates</a></li>
1592
+ <li class=""><a href="/docs/templates/">Templates</a></li>
1547
1593
 
1548
1594
 
1549
1595
 
1550
- <li class=""><a href="https://jekyllrb.com/docs/permalinks/">Permalinks</a></li>
1596
+ <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
1551
1597
 
1552
1598
 
1553
1599
 
1554
- <li class=""><a href="https://jekyllrb.com/docs/pagination/">Pagination</a></li>
1600
+ <li class=""><a href="/docs/pagination/">Pagination</a></li>
1555
1601
 
1556
1602
 
1557
1603
 
1558
- <li class="current"><a href="https://jekyllrb.com/docs/plugins/">Plugins</a></li>
1604
+ <li class="current"><a href="/docs/plugins/">Plugins</a></li>
1559
1605
 
1560
1606
 
1561
1607
 
1562
- <li class=""><a href="https://jekyllrb.com/docs/themes/">Themes</a></li>
1608
+ <li class=""><a href="/docs/themes/">Themes</a></li>
1563
1609
 
1564
1610
 
1565
1611
 
1566
- <li class=""><a href="https://jekyllrb.com/docs/extras/">Extras</a></li>
1612
+ <li class=""><a href="/docs/extras/">Extras</a></li>
1567
1613
 
1568
1614
  </ul>
1569
1615
 
@@ -1573,15 +1619,15 @@ new posts and run <code class="highlighter-rouge">jekyll build</code> all withou
1573
1619
 
1574
1620
 
1575
1621
 
1576
- <li class=""><a href="https://jekyllrb.com/docs/github-pages/">GitHub Pages</a></li>
1622
+ <li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
1577
1623
 
1578
1624
 
1579
1625
 
1580
- <li class=""><a href="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</a></li>
1626
+ <li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
1581
1627
 
1582
1628
 
1583
1629
 
1584
- <li class=""><a href="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</a></li>
1630
+ <li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
1585
1631
 
1586
1632
  </ul>
1587
1633
 
@@ -1591,23 +1637,23 @@ new posts and run <code class="highlighter-rouge">jekyll build</code> all withou
1591
1637
 
1592
1638
 
1593
1639
 
1594
- <li class=""><a href="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</a></li>
1640
+ <li class=""><a href="/docs/troubleshooting/">Troubleshooting</a></li>
1595
1641
 
1596
1642
 
1597
1643
 
1598
- <li class=""><a href="https://jekyllrb.com/docs/sites/">Sites using Jekyll</a></li>
1644
+ <li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
1599
1645
 
1600
1646
 
1601
1647
 
1602
- <li class=""><a href="https://jekyllrb.com/docs/resources/">Resources</a></li>
1648
+ <li class=""><a href="/docs/resources/">Resources</a></li>
1603
1649
 
1604
1650
 
1605
1651
 
1606
- <li class=""><a href="https://jekyllrb.com/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
1652
+ <li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
1607
1653
 
1608
1654
 
1609
1655
 
1610
- <li class=""><a href="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
1656
+ <li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
1611
1657
 
1612
1658
  </ul>
1613
1659
 
@@ -1617,15 +1663,15 @@ new posts and run <code class="highlighter-rouge">jekyll build</code> all withou
1617
1663
 
1618
1664
 
1619
1665
 
1620
- <li class=""><a href="https://jekyllrb.com/docs/contributing/">Contributing</a></li>
1666
+ <li class=""><a href="/docs/contributing/">Contributing</a></li>
1621
1667
 
1622
1668
 
1623
1669
 
1624
- <li class=""><a href="https://jekyllrb.com/docs/conduct/">Code of Conduct</a></li>
1670
+ <li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
1625
1671
 
1626
1672
 
1627
1673
 
1628
- <li class=""><a href="https://jekyllrb.com/docs/history/">History</a></li>
1674
+ <li class=""><a href="/docs/history/">History</a></li>
1629
1675
 
1630
1676
  </ul>
1631
1677