jekyll-docs 3.1.6 → 3.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (211) hide show
  1. checksums.yaml +4 -4
  2. data/lib/jekyll-docs.rb +7 -13
  3. data/site/community/index.html +305 -0
  4. data/site/conduct/index.html +10 -0
  5. data/site/css/screen.css +1445 -0
  6. data/site/docs/assets/index.html +701 -0
  7. data/site/docs/collections/index.html +973 -0
  8. data/site/docs/conduct/index.html +718 -0
  9. data/site/docs/configuration/index.html +1337 -0
  10. data/site/docs/continuous-integration/index.html +846 -0
  11. data/site/docs/contributing/index.html +815 -0
  12. data/site/docs/datafiles/index.html +742 -0
  13. data/site/docs/deployment-methods/index.html +866 -0
  14. data/site/docs/drafts/index.html +615 -0
  15. data/site/docs/extras/index.html +656 -0
  16. data/site/docs/frontmatter/index.html +776 -0
  17. data/site/docs/github-pages/index.html +778 -0
  18. data/site/docs/history/index.html +3293 -0
  19. data/site/docs/home/index.html +627 -0
  20. data/site/docs/index.html +10 -0
  21. data/site/docs/installation/index.html +682 -0
  22. data/site/docs/migrations/index.html +627 -0
  23. data/site/docs/pages/index.html +698 -0
  24. data/site/docs/pagination/index.html +840 -0
  25. data/site/docs/permalinks/index.html +924 -0
  26. data/site/docs/plugins/index.html +1726 -0
  27. data/site/docs/posts/index.html +811 -0
  28. data/site/docs/quickstart/index.html +599 -0
  29. data/site/docs/resources/index.html +717 -0
  30. data/site/docs/sites/index.html +676 -0
  31. data/site/docs/static-files/index.html +655 -0
  32. data/site/docs/structure/index.html +794 -0
  33. data/site/docs/templates/index.html +1105 -0
  34. data/site/docs/themes/index.html +751 -0
  35. data/site/docs/troubleshooting/index.html +826 -0
  36. data/site/docs/upgrading/0-to-2/index.html +802 -0
  37. data/site/docs/upgrading/2-to-3/index.html +785 -0
  38. data/site/docs/upgrading/index.html +664 -0
  39. data/site/docs/usage/index.html +673 -0
  40. data/site/docs/variables/index.html +1013 -0
  41. data/site/docs/windows/index.html +775 -0
  42. data/site/feed.xml +222 -0
  43. data/site/github.html +10 -0
  44. data/site/help/index.html +246 -0
  45. data/site/img/article-footer.png +0 -0
  46. data/site/img/footer-logo.png +0 -0
  47. data/site/img/logo-2x.png +0 -0
  48. data/site/index.html +200 -16
  49. data/site/issues.html +10 -0
  50. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +524 -0
  51. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +524 -0
  52. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +525 -0
  53. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +522 -0
  54. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +524 -0
  55. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +523 -0
  56. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +519 -0
  57. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +519 -0
  58. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +526 -0
  59. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +520 -0
  60. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +518 -0
  61. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +553 -0
  62. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +522 -0
  63. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +537 -0
  64. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +519 -0
  65. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +518 -0
  66. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +527 -0
  67. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +518 -0
  68. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +523 -0
  69. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +539 -0
  70. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +519 -0
  71. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +521 -0
  72. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +536 -0
  73. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +533 -0
  74. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +522 -0
  75. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +542 -0
  76. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +528 -0
  77. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +551 -0
  78. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +529 -0
  79. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +519 -0
  80. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +526 -0
  81. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +521 -0
  82. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +522 -0
  83. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +542 -0
  84. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +517 -0
  85. data/site/news/2015/10/26/jekyll-3-0-released/index.html +546 -0
  86. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +530 -0
  87. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +520 -0
  88. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +553 -0
  89. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +537 -0
  90. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +532 -0
  91. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +523 -0
  92. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +519 -0
  93. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +525 -0
  94. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +521 -0
  95. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +526 -0
  96. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +530 -0
  97. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +518 -0
  98. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +520 -0
  99. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +521 -0
  100. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +630 -0
  101. data/site/news/index.html +2831 -10
  102. data/site/news/releases/index.html +2603 -10
  103. data/site/sitemap.xml +327 -0
  104. metadata +99 -111
  105. data/site/_config.yml +0 -25
  106. data/site/_data/docs.yml +0 -49
  107. data/site/_docs/assets.md +0 -94
  108. data/site/_docs/collections.md +0 -380
  109. data/site/_docs/conduct.md +0 -55
  110. data/site/_docs/configuration.md +0 -747
  111. data/site/_docs/continuous-integration.md +0 -221
  112. data/site/_docs/contributing.md +0 -124
  113. data/site/_docs/datafiles.md +0 -151
  114. data/site/_docs/deployment-methods.md +0 -213
  115. data/site/_docs/drafts.md +0 -20
  116. data/site/_docs/extras.md +0 -22
  117. data/site/_docs/frontmatter.md +0 -191
  118. data/site/_docs/github-pages.md +0 -133
  119. data/site/_docs/history.md +0 -2323
  120. data/site/_docs/index.md +0 -57
  121. data/site/_docs/installation.md +0 -106
  122. data/site/_docs/migrations.md +0 -9
  123. data/site/_docs/pages.md +0 -100
  124. data/site/_docs/pagination.md +0 -224
  125. data/site/_docs/permalinks.md +0 -308
  126. data/site/_docs/plugins.md +0 -903
  127. data/site/_docs/posts.md +0 -237
  128. data/site/_docs/quickstart.md +0 -26
  129. data/site/_docs/resources.md +0 -38
  130. data/site/_docs/sites.md +0 -23
  131. data/site/_docs/static_files.md +0 -52
  132. data/site/_docs/structure.md +0 -211
  133. data/site/_docs/templates.md +0 -451
  134. data/site/_docs/troubleshooting.md +0 -207
  135. data/site/_docs/upgrading.md +0 -10
  136. data/site/_docs/upgrading/0-to-2.md +0 -140
  137. data/site/_docs/upgrading/2-to-3.md +0 -126
  138. data/site/_docs/usage.md +0 -101
  139. data/site/_docs/variables.md +0 -390
  140. data/site/_docs/windows.md +0 -46
  141. data/site/_includes/analytics.html +0 -30
  142. data/site/_includes/anchor_links.html +0 -33
  143. data/site/_includes/docs_contents.html +0 -8
  144. data/site/_includes/docs_contents_mobile.html +0 -10
  145. data/site/_includes/docs_option.html +0 -11
  146. data/site/_includes/docs_ul.html +0 -17
  147. data/site/_includes/footer.html +0 -15
  148. data/site/_includes/header.html +0 -18
  149. data/site/_includes/news_contents.html +0 -33
  150. data/site/_includes/news_contents_mobile.html +0 -11
  151. data/site/_includes/news_item.html +0 -24
  152. data/site/_includes/primary-nav-items.html +0 -17
  153. data/site/_includes/section_nav.html +0 -39
  154. data/site/_includes/top.html +0 -17
  155. data/site/_layouts/default.html +0 -13
  156. data/site/_layouts/docs.html +0 -26
  157. data/site/_layouts/news.html +0 -19
  158. data/site/_layouts/news_item.html +0 -27
  159. data/site/_layouts/page.html +0 -18
  160. data/site/_posts/2013-05-06-jekyll-1-0-0-released.markdown +0 -23
  161. data/site/_posts/2013-05-08-jekyll-1-0-1-released.markdown +0 -27
  162. data/site/_posts/2013-05-12-jekyll-1-0-2-released.markdown +0 -28
  163. data/site/_posts/2013-06-07-jekyll-1-0-3-released.markdown +0 -25
  164. data/site/_posts/2013-07-14-jekyll-1-1-0-released.markdown +0 -27
  165. data/site/_posts/2013-07-24-jekyll-1-1-1-released.markdown +0 -31
  166. data/site/_posts/2013-07-25-jekyll-1-0-4-released.markdown +0 -20
  167. data/site/_posts/2013-07-25-jekyll-1-1-2-released.markdown +0 -20
  168. data/site/_posts/2013-09-06-jekyll-1-2-0-released.markdown +0 -23
  169. data/site/_posts/2013-09-14-jekyll-1-2-1-released.markdown +0 -19
  170. data/site/_posts/2013-10-28-jekyll-1-3-0-rc1-released.markdown +0 -17
  171. data/site/_posts/2013-11-04-jekyll-1-3-0-released.markdown +0 -43
  172. data/site/_posts/2013-11-26-jekyll-1-3-1-released.markdown +0 -21
  173. data/site/_posts/2013-12-07-jekyll-1-4-0-released.markdown +0 -30
  174. data/site/_posts/2013-12-09-jekyll-1-4-1-released.markdown +0 -18
  175. data/site/_posts/2013-12-16-jekyll-1-4-2-released.markdown +0 -18
  176. data/site/_posts/2014-01-13-jekyll-1-4-3-released.markdown +0 -26
  177. data/site/_posts/2014-03-24-jekyll-1-5-0-released.markdown +0 -19
  178. data/site/_posts/2014-03-27-jekyll-1-5-1-released.markdown +0 -26
  179. data/site/_posts/2014-05-06-jekyll-turns-2-0-0.markdown +0 -31
  180. data/site/_posts/2014-05-08-jekyll-2-0-3-released.markdown +0 -18
  181. data/site/_posts/2014-06-04-jekyll-stickers-1-dollar-stickermule.markdown +0 -19
  182. data/site/_posts/2014-06-28-jekyll-turns-21-i-mean-2-1-0.markdown +0 -31
  183. data/site/_posts/2014-07-01-jekyll-2-1-1-released.markdown +0 -30
  184. data/site/_posts/2014-07-29-jekyll-2-2-0-released.markdown +0 -19
  185. data/site/_posts/2014-08-10-jekyll-2-3-0-released.markdown +0 -41
  186. data/site/_posts/2014-09-09-jekyll-2-4-0-released.markdown +0 -25
  187. data/site/_posts/2014-11-06-jekylls-midlife-crisis-jekyll-turns-2-5-0.markdown +0 -47
  188. data/site/_posts/2014-11-08-jekyll-2-5-1-released.markdown +0 -29
  189. data/site/_posts/2014-11-12-jekyll-2-5-2-released.markdown +0 -18
  190. data/site/_posts/2014-12-17-alfredxing-welcome-to-jekyll-core.md +0 -27
  191. data/site/_posts/2014-12-22-jekyll-2-5-3-released.markdown +0 -20
  192. data/site/_posts/2015-01-20-jekyll-meet-and-greet.markdown +0 -20
  193. data/site/_posts/2015-01-24-jekyll-3-0-0-beta1-released.markdown +0 -40
  194. data/site/_posts/2015-02-26-introducing-jekyll-talk.markdown +0 -15
  195. data/site/_posts/2015-10-26-jekyll-3-0-released.markdown +0 -35
  196. data/site/_posts/2015-11-17-jekyll-3-0-1-released.markdown +0 -25
  197. data/site/_posts/2016-01-20-jekyll-3-0-2-released.markdown +0 -19
  198. data/site/_posts/2016-01-24-jekyll-3-1-0-released.markdown +0 -50
  199. data/site/_posts/2016-01-28-jekyll-3-1-1-released.markdown +0 -33
  200. data/site/_posts/2016-02-08-jekyll-3-0-3-released.markdown +0 -32
  201. data/site/_posts/2016-02-19-jekyll-3-1-2-released.markdown +0 -20
  202. data/site/_sass/_font-awesome.scss +0 -25
  203. data/site/_sass/_gridism.scss +0 -124
  204. data/site/_sass/_mixins.scss +0 -38
  205. data/site/_sass/_normalize.scss +0 -1
  206. data/site/_sass/_pygments.scss +0 -78
  207. data/site/_sass/_style.scss +0 -1002
  208. data/site/css/screen.scss +0 -9
  209. data/site/help/index.md +0 -41
  210. data/site/redirects/github.html +0 -4
  211. data/site/redirects/issues.html +0 -4
@@ -0,0 +1,1013 @@
1
+ <!DOCTYPE HTML>
2
+ <html lang="en-US">
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
+ <meta charset="UTF-8">
6
+ <meta name="viewport" content="width=device-width,initial-scale=1">
7
+ <meta name="generator" content="Jekyll v3.2.0">
8
+ <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
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
+ <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
+ <link rel="stylesheet" href="/css/screen.css">
12
+ <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
+ <!-- Begin Jekyll SEO tag v2.0.0 -->
14
+ <title>Variables - Jekyll • Simple, blog-aware, static sites</title>
15
+ <meta property="og:title" content="Variables">
16
+ <meta name="description" content="Transform your plain text into static websites and blogs">
17
+ <meta property="og:description" content="Transform your plain text into static websites and blogs">
18
+ <link rel="canonical" href="https://jekyllrb.com/docs/variables/">
19
+ <meta property="og:url" content="https://jekyllrb.com/docs/variables/">
20
+ <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
21
+ <meta property="og:type" content="article">
22
+ <meta property="article:published_time" content="2016-07-27T18:44:57-07:00">
23
+ <meta name="twitter:card" content="summary">
24
+ <meta name="twitter:site" content="@jekyllrb">
25
+ <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
26
+ <script type="application/ld+json">
27
+ {
28
+ "@context": "http://schema.org",
29
+ "@type": "BlogPosting",
30
+ "headline": "Variables",
31
+ "datePublished": "2016-07-27T18:44:57-07:00",
32
+ "description": "Transform your plain text into static websites and blogs",
33
+ "logo": "https://jekyllrb.comimg/logo-2x.png",
34
+ "url": "https://jekyllrb.com/docs/variables/"
35
+ }
36
+ </script>
37
+ <!-- End Jekyll SEO tag -->
38
+ <!--[if lt IE 9]>
39
+ <script src="/js/html5shiv.min.js"></script>
40
+ <script src="/js/respond.min.js"></script>
41
+ <![endif]-->
42
+ </head>
43
+
44
+
45
+ <body class="wrap">
46
+ <header>
47
+ <nav class="mobile-nav show-on-mobiles">
48
+ <ul>
49
+ <li class="">
50
+ <a href="/">Home</a>
51
+ </li>
52
+ <li class="current">
53
+ <a href="/docs/home/">Docs</a>
54
+ </li>
55
+ <li class="">
56
+ <a href="/news/">News</a>
57
+ </li>
58
+ <li class="">
59
+ <a href="/community/">Community</a>
60
+ </li>
61
+ <li class="">
62
+ <a href="/help/">Help</a>
63
+ </li>
64
+ <li>
65
+ <a href="https://github.com/jekyll/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a>
66
+ </li>
67
+ </ul>
68
+
69
+ </nav>
70
+ <div class="grid">
71
+ <div class="unit one-third center-on-mobiles">
72
+ <h1>
73
+ <a href="/">
74
+ <span class="sr-only">Jekyll</span>
75
+ <img src="/img/logo-2x.png" width="249" height="115" alt="Jekyll Logo">
76
+ </a>
77
+ </h1>
78
+ </div>
79
+ <nav class="main-nav unit two-thirds hide-on-mobiles">
80
+ <ul>
81
+ <li class="">
82
+ <a href="/">Home</a>
83
+ </li>
84
+ <li class="current">
85
+ <a href="/docs/home/">Docs</a>
86
+ </li>
87
+ <li class="">
88
+ <a href="/news/">News</a>
89
+ </li>
90
+ <li class="">
91
+ <a href="/community/">Community</a>
92
+ </li>
93
+ <li class="">
94
+ <a href="/help/">Help</a>
95
+ </li>
96
+ <li>
97
+ <a href="https://github.com/jekyll/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a>
98
+ </li>
99
+ </ul>
100
+
101
+ </nav>
102
+ </div>
103
+ </header>
104
+
105
+
106
+ <section class="docs">
107
+ <div class="grid">
108
+
109
+ <div class="docs-nav-mobile unit whole show-on-mobiles">
110
+ <select onchange="if (this.value) window.location.href=this.value">
111
+ <option value="">Navigate the docs…</option>
112
+
113
+ <optgroup label="Getting Started">
114
+
115
+
116
+
117
+ <option value="https://jekyllrb.com/docs/home/">Welcome</option>
118
+
119
+
120
+
121
+ <option value="https://jekyllrb.com/docs/quickstart/">Quick-start guide</option>
122
+
123
+
124
+
125
+ <option value="https://jekyllrb.com/docs/installation/">Installation</option>
126
+
127
+
128
+
129
+ <option value="https://jekyllrb.com/docs/usage/">Basic Usage</option>
130
+
131
+
132
+
133
+ <option value="https://jekyllrb.com/docs/structure/">Directory structure</option>
134
+
135
+
136
+
137
+ <option value="https://jekyllrb.com/docs/configuration/">Configuration</option>
138
+
139
+
140
+ </optgroup>
141
+
142
+ <optgroup label="Your Content">
143
+
144
+
145
+
146
+ <option value="https://jekyllrb.com/docs/frontmatter/">Front Matter</option>
147
+
148
+
149
+
150
+ <option value="https://jekyllrb.com/docs/posts/">Writing posts</option>
151
+
152
+
153
+
154
+ <option value="https://jekyllrb.com/docs/drafts/">Working with drafts</option>
155
+
156
+
157
+
158
+ <option value="https://jekyllrb.com/docs/pages/">Creating pages</option>
159
+
160
+
161
+
162
+ <option value="https://jekyllrb.com/docs/static-files/">Static Files</option>
163
+
164
+
165
+
166
+ <option value="https://jekyllrb.com/docs/variables/">Variables</option>
167
+
168
+
169
+
170
+ <option value="https://jekyllrb.com/docs/collections/">Collections</option>
171
+
172
+
173
+
174
+ <option value="https://jekyllrb.com/docs/datafiles/">Data Files</option>
175
+
176
+
177
+
178
+ <option value="https://jekyllrb.com/docs/assets/">Assets</option>
179
+
180
+
181
+
182
+ <option value="https://jekyllrb.com/docs/migrations/">Blog migrations</option>
183
+
184
+
185
+ </optgroup>
186
+
187
+ <optgroup label="Customization">
188
+
189
+
190
+
191
+ <option value="https://jekyllrb.com/docs/templates/">Templates</option>
192
+
193
+
194
+
195
+ <option value="https://jekyllrb.com/docs/permalinks/">Permalinks</option>
196
+
197
+
198
+
199
+ <option value="https://jekyllrb.com/docs/pagination/">Pagination</option>
200
+
201
+
202
+
203
+ <option value="https://jekyllrb.com/docs/plugins/">Plugins</option>
204
+
205
+
206
+
207
+ <option value="https://jekyllrb.com/docs/themes/">Themes</option>
208
+
209
+
210
+
211
+ <option value="https://jekyllrb.com/docs/extras/">Extras</option>
212
+
213
+
214
+ </optgroup>
215
+
216
+ <optgroup label="Deployment">
217
+
218
+
219
+
220
+ <option value="https://jekyllrb.com/docs/github-pages/">GitHub Pages</option>
221
+
222
+
223
+
224
+ <option value="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</option>
225
+
226
+
227
+
228
+ <option value="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</option>
229
+
230
+
231
+ </optgroup>
232
+
233
+ <optgroup label="Miscellaneous">
234
+
235
+
236
+
237
+ <option value="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</option>
238
+
239
+
240
+
241
+ <option value="https://jekyllrb.com/docs/sites/">Sites using Jekyll</option>
242
+
243
+
244
+
245
+ <option value="https://jekyllrb.com/docs/resources/">Resources</option>
246
+
247
+
248
+
249
+ <option value="https://jekyllrb.com/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
250
+
251
+
252
+
253
+ <option value="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
254
+
255
+
256
+ </optgroup>
257
+
258
+ <optgroup label="Meta">
259
+
260
+
261
+
262
+ <option value="https://jekyllrb.com/docs/contributing/">Contributing</option>
263
+
264
+
265
+
266
+ <option value="https://jekyllrb.com/docs/conduct/">Code of Conduct</option>
267
+
268
+
269
+
270
+ <option value="https://jekyllrb.com/docs/history/">History</option>
271
+
272
+
273
+ </optgroup>
274
+
275
+ </select>
276
+ </div>
277
+
278
+
279
+ <div class="unit four-fifths">
280
+ <article>
281
+ <div class="improve right hide-on-mobiles">
282
+ <a href="https://github.com/jekyll/jekyll/edit/master/site/_docs/variables.md"><i class="fa fa-pencil"></i>  Improve this page</a>
283
+ </div>
284
+ <h1>Variables</h1>
285
+ <p>Jekyll traverses your site looking for files to process. Any files with <a href="../frontmatter/">YAML
286
+ front matter</a> are subject to processing. For each of these
287
+ files, Jekyll makes a variety of data available via the <a href="https://github.com/Shopify/liquid/wiki">Liquid templating
288
+ system</a>. The
289
+ following is a reference of the available data.</p>
290
+
291
+ <h2 id="global-variables">Global Variables</h2>
292
+
293
+ <div class="mobile-side-scroller">
294
+ <table>
295
+ <thead>
296
+ <tr>
297
+ <th>Variable</th>
298
+ <th>Description</th>
299
+ </tr>
300
+ </thead>
301
+ <tbody>
302
+ <tr>
303
+ <td><p><code>site</code></p></td>
304
+ <td><p>
305
+
306
+ Sitewide information + configuration settings from
307
+ <code>_config.yml</code>. See below for details.
308
+
309
+ </p></td>
310
+ </tr>
311
+ <tr>
312
+ <td><p><code>page</code></p></td>
313
+ <td><p>
314
+
315
+ Page specific information + the <a href="../frontmatter/">YAML front
316
+ matter</a>. Custom variables set via the YAML Front Matter will be
317
+ available here. See below for details.
318
+
319
+ </p></td>
320
+ </tr>
321
+ <tr>
322
+ <td><p><code>layout</code></p></td>
323
+ <td><p>
324
+
325
+ Layout specific information + the <a href="../frontmatter/">YAML front
326
+ matter</a>. Custom variables set via the YAML Front Matter in
327
+ layouts will be available here.
328
+
329
+ </p></td>
330
+ </tr>
331
+ <tr>
332
+ <td><p><code>content</code></p></td>
333
+ <td><p>
334
+
335
+ In layout files, the rendered content of the Post or Page being wrapped.
336
+ Not defined in Post or Page files.
337
+
338
+ </p></td>
339
+ </tr>
340
+ <tr>
341
+ <td><p><code>paginator</code></p></td>
342
+ <td><p>
343
+
344
+ When the <code>paginate</code> configuration option is set, this
345
+ variable becomes available for use. See <a href="../pagination/">Pagination</a> for details.
346
+
347
+ </p></td>
348
+ </tr>
349
+ </tbody>
350
+ </table>
351
+ </div>
352
+
353
+ <h2 id="site-variables">Site Variables</h2>
354
+
355
+ <div class="mobile-side-scroller">
356
+ <table>
357
+ <thead>
358
+ <tr>
359
+ <th>Variable</th>
360
+ <th>Description</th>
361
+ </tr>
362
+ </thead>
363
+ <tbody>
364
+ <tr>
365
+ <td><p><code>site.time</code></p></td>
366
+ <td><p>
367
+
368
+ The current time (when you run the <code>jekyll</code> command).
369
+
370
+ </p></td>
371
+ </tr>
372
+ <tr>
373
+ <td><p><code>site.pages</code></p></td>
374
+ <td><p>
375
+
376
+ A list of all Pages.
377
+
378
+ </p></td>
379
+ </tr>
380
+ <tr>
381
+ <td><p><code>site.posts</code></p></td>
382
+ <td><p>
383
+
384
+ A reverse chronological list of all Posts.
385
+
386
+ </p></td>
387
+ </tr>
388
+ <tr>
389
+ <td><p><code>site.related_posts</code></p></td>
390
+ <td><p>
391
+
392
+ If the page being processed is a Post, this contains a list of up to ten
393
+ related Posts. By default, these are the ten most recent posts.
394
+ For high quality but slow to compute results, run the
395
+ <code>jekyll</code> command with the <code>--lsi</code> (latent semantic
396
+ indexing) option. Also note GitHub Pages does not support the <code>lsi</code> option when generating sites.
397
+
398
+ </p></td>
399
+ </tr>
400
+ <tr>
401
+ <td><p><code>site.static_files</code></p></td>
402
+ <td><p>
403
+
404
+ A list of all <a href="/docs/static-files/">static files</a> (i.e.
405
+ files not processed by Jekyll's converters or the Liquid renderer).
406
+ Each file has three properties: <code>path</code>,
407
+ <code>modified_time</code> and <code>extname</code>.
408
+
409
+ </p></td>
410
+ </tr>
411
+ <tr>
412
+ <td><p><code>site.html_pages</code></p></td>
413
+ <td><p>
414
+
415
+ A subset of `site.pages` listing those which end in `.html`.
416
+
417
+ </p></td>
418
+ </tr>
419
+ <tr>
420
+ <td><p><code>site.html_files</code></p></td>
421
+ <td><p>
422
+
423
+ A subset of `site.static_files` listing those which end in `.html`.
424
+
425
+ </p></td>
426
+ </tr>
427
+ <tr>
428
+ <td><p><code>site.collections</code></p></td>
429
+ <td><p>
430
+
431
+ A list of all the collections.
432
+
433
+ </p></td>
434
+ </tr>
435
+ <tr>
436
+ <td><p><code>site.data</code></p></td>
437
+ <td><p>
438
+
439
+ A list containing the data loaded from the YAML files located in the <code>_data</code> directory.
440
+
441
+ </p></td>
442
+ </tr>
443
+ <tr>
444
+ <td><p><code>site.documents</code></p></td>
445
+ <td><p>
446
+
447
+ A list of all the documents in every collection.
448
+
449
+ </p></td>
450
+ </tr>
451
+ <tr>
452
+ <td><p><code>site.categories.CATEGORY</code></p></td>
453
+ <td><p>
454
+
455
+ The list of all Posts in category <code>CATEGORY</code>.
456
+
457
+ </p></td>
458
+ </tr>
459
+ <tr>
460
+ <td><p><code>site.tags.TAG</code></p></td>
461
+ <td><p>
462
+
463
+ The list of all Posts with tag <code>TAG</code>.
464
+
465
+ </p></td>
466
+ </tr>
467
+ <tr>
468
+ <td><p><code>site.[CONFIGURATION_DATA]</code></p></td>
469
+ <td><p>
470
+
471
+ All the variables set via the command line and your
472
+ <code>_config.yml</code> are available through the <code>site</code>
473
+ variable. For example, if you have <code>url: http://mysite.com</code>
474
+ in your configuration file, then in your Posts and Pages it will be
475
+ stored in <code>site.url</code>. Jekyll does not parse changes to
476
+ <code>_config.yml</code> in <code>watch</code> mode, you must restart
477
+ Jekyll to see changes to variables.
478
+
479
+ </p></td>
480
+ </tr>
481
+ </tbody>
482
+ </table>
483
+ </div>
484
+
485
+ <h2 id="page-variables">Page Variables</h2>
486
+
487
+ <div class="mobile-side-scroller">
488
+ <table>
489
+ <thead>
490
+ <tr>
491
+ <th>Variable</th>
492
+ <th>Description</th>
493
+ </tr>
494
+ </thead>
495
+ <tbody>
496
+ <tr>
497
+ <td><p><code>page.content</code></p></td>
498
+ <td><p>
499
+
500
+ The content of the Page, rendered or un-rendered depending upon
501
+ what Liquid is being processed and what <code>page</code> is.
502
+
503
+ </p></td>
504
+ </tr>
505
+ <tr>
506
+ <td><p><code>page.title</code></p></td>
507
+ <td><p>
508
+
509
+ The title of the Page.
510
+
511
+ </p></td>
512
+ </tr>
513
+ <tr>
514
+ <td><p><code>page.excerpt</code></p></td>
515
+ <td><p>
516
+
517
+ The un-rendered excerpt of the Page.
518
+
519
+ </p></td>
520
+ </tr>
521
+ <tr>
522
+ <td><p><code>page.url</code></p></td>
523
+ <td><p>
524
+
525
+ The URL of the Post without the domain, but
526
+ with a leading slash, e.g.
527
+ <code>/2008/12/14/my-post.html</code>
528
+
529
+ </p></td>
530
+ </tr>
531
+ <tr>
532
+ <td><p><code>page.date</code></p></td>
533
+ <td><p>
534
+
535
+ The Date assigned to the Post. This can be overridden in a Post’s front
536
+ matter by specifying a new date/time in the format
537
+ <code>YYYY-MM-DD HH:MM:SS</code> (assuming UTC), or
538
+ <code>YYYY-MM-DD HH:MM:SS +/-TTTT</code> (to specify a time zone using
539
+ an offset from UTC. e.g. <code>2008-12-14 10:30:00 +0900</code>).
540
+
541
+ </p></td>
542
+ </tr>
543
+ <tr>
544
+ <td><p><code>page.id</code></p></td>
545
+ <td><p>
546
+
547
+ An identifier unique to the Post (useful in RSS feeds). e.g.
548
+ <code>/2008/12/14/my-post</code>
549
+
550
+ </p></td>
551
+ </tr>
552
+ <tr>
553
+ <td><p><code>page.categories</code></p></td>
554
+ <td><p>
555
+
556
+ The list of categories to which this post belongs. Categories are
557
+ derived from the directory structure above the <code>_posts</code>
558
+ directory. For example, a post at
559
+ <code>/work/code/_posts/2008-12-24-closures.md</code> would have this
560
+ field set to <code>['work', 'code']</code>. These can also be specified
561
+ in the <a href="../frontmatter/">YAML Front Matter</a>.
562
+
563
+ </p></td>
564
+ </tr>
565
+ <tr>
566
+ <td><p><code>page.tags</code></p></td>
567
+ <td><p>
568
+
569
+ The list of tags to which this post belongs. These can be specified in
570
+ the <a href="../frontmatter/">YAML Front Matter</a>.
571
+
572
+ </p></td>
573
+ </tr>
574
+ <tr>
575
+ <td><p><code>page.path</code></p></td>
576
+ <td><p>
577
+
578
+ The path to the raw post or page. Example usage: Linking back to the
579
+ page or post’s source on GitHub. This can be overridden in the
580
+ <a href="../frontmatter/">YAML Front Matter</a>.
581
+
582
+ </p></td>
583
+ </tr>
584
+ <tr>
585
+ <td><p><code>page.next</code></p></td>
586
+ <td><p>
587
+
588
+ The next post relative to the position of the current post in
589
+ <code>site.posts</code>. Returns <code>nil</code> for the last entry.
590
+
591
+ </p></td>
592
+ </tr>
593
+ <tr>
594
+ <td><p><code>page.previous</code></p></td>
595
+ <td><p>
596
+
597
+ The previous post relative to the position of the current post in
598
+ <code>site.posts</code>. Returns <code>nil</code> for the first entry.
599
+
600
+ </p></td>
601
+ </tr>
602
+ </tbody>
603
+ </table>
604
+ </div>
605
+
606
+ <div class="note">
607
+ <h5>ProTip™: Use Custom Front Matter</h5>
608
+ <p>
609
+
610
+ Any custom front matter that you specify will be available under
611
+ <code>page</code>. For example, if you specify <code>custom_css: true</code>
612
+ in a page’s front matter, that value will be available as
613
+ <code>page.custom_css</code>.
614
+
615
+ </p>
616
+ <p>
617
+
618
+ If you specify front matter in a layout, access that via <code>layout</code>.
619
+ For example, if you specify <code>class: full_page</code>
620
+ in a page’s front matter, that value will be available as
621
+ <code>layout.class</code> in the layout and its parents.
622
+
623
+ </p>
624
+ </div>
625
+
626
+ <h2 id="paginator">Paginator</h2>
627
+
628
+ <div class="mobile-side-scroller">
629
+ <table>
630
+ <thead>
631
+ <tr>
632
+ <th>Variable</th>
633
+ <th>Description</th>
634
+ </tr>
635
+ </thead>
636
+ <tbody>
637
+ <tr>
638
+ <td><p><code>paginator.per_page</code></p></td>
639
+ <td><p>Number of Posts per page.</p></td>
640
+ </tr>
641
+ <tr>
642
+ <td><p><code>paginator.posts</code></p></td>
643
+ <td><p>Posts available for that page.</p></td>
644
+ </tr>
645
+ <tr>
646
+ <td><p><code>paginator.total_posts</code></p></td>
647
+ <td><p>Total number of Posts.</p></td>
648
+ </tr>
649
+ <tr>
650
+ <td><p><code>paginator.total_pages</code></p></td>
651
+ <td><p>Total number of pages.</p></td>
652
+ </tr>
653
+ <tr>
654
+ <td><p><code>paginator.page</code></p></td>
655
+ <td><p>The number of the current page.</p></td>
656
+ </tr>
657
+ <tr>
658
+ <td><p><code>paginator.previous_page</code></p></td>
659
+ <td><p>The number of the previous page.</p></td>
660
+ </tr>
661
+ <tr>
662
+ <td><p><code>paginator.previous_page_path</code></p></td>
663
+ <td><p>The path to the previous page.</p></td>
664
+ </tr>
665
+ <tr>
666
+ <td><p><code>paginator.next_page</code></p></td>
667
+ <td><p>The number of the next page.</p></td>
668
+ </tr>
669
+ <tr>
670
+ <td><p><code>paginator.next_page_path</code></p></td>
671
+ <td><p>The path to the next page.</p></td>
672
+ </tr>
673
+ </tbody>
674
+ </table>
675
+ </div>
676
+
677
+ <div class="note info">
678
+ <h5>Paginator variable availability</h5>
679
+ <p>
680
+
681
+ These are only available in index files, however they can be located in a
682
+ subdirectory, such as <code>/blog/index.html</code>.
683
+
684
+ </p>
685
+ </div>
686
+
687
+
688
+
689
+
690
+
691
+
692
+
693
+
694
+
695
+
696
+
697
+
698
+
699
+
700
+
701
+
702
+
703
+
704
+
705
+
706
+
707
+
708
+
709
+
710
+
711
+
712
+
713
+
714
+
715
+
716
+
717
+
718
+
719
+
720
+
721
+
722
+
723
+
724
+
725
+
726
+
727
+
728
+ <div class="section-nav">
729
+ <div class="left align-right">
730
+
731
+
732
+
733
+ <a href="/docs/static-files/" class="prev">Back</a>
734
+
735
+ </div>
736
+ <div class="right align-left">
737
+
738
+
739
+
740
+ <a href="/docs/collections/" class="next">Next</a>
741
+
742
+ </div>
743
+ </div>
744
+ <div class="clear"></div>
745
+
746
+ </article>
747
+ </div>
748
+
749
+ <div class="unit one-fifth hide-on-mobiles">
750
+ <aside>
751
+
752
+ <h4>Getting Started</h4>
753
+ <ul>
754
+
755
+
756
+
757
+ <li class=""><a href="https://jekyllrb.com/docs/home/">Welcome</a></li>
758
+
759
+
760
+
761
+ <li class=""><a href="https://jekyllrb.com/docs/quickstart/">Quick-start guide</a></li>
762
+
763
+
764
+
765
+ <li class=""><a href="https://jekyllrb.com/docs/installation/">Installation</a></li>
766
+
767
+
768
+
769
+ <li class=""><a href="https://jekyllrb.com/docs/usage/">Basic Usage</a></li>
770
+
771
+
772
+
773
+ <li class=""><a href="https://jekyllrb.com/docs/structure/">Directory structure</a></li>
774
+
775
+
776
+
777
+ <li class=""><a href="https://jekyllrb.com/docs/configuration/">Configuration</a></li>
778
+
779
+ </ul>
780
+
781
+
782
+ <h4>Your Content</h4>
783
+ <ul>
784
+
785
+
786
+
787
+ <li class=""><a href="https://jekyllrb.com/docs/frontmatter/">Front Matter</a></li>
788
+
789
+
790
+
791
+ <li class=""><a href="https://jekyllrb.com/docs/posts/">Writing posts</a></li>
792
+
793
+
794
+
795
+ <li class=""><a href="https://jekyllrb.com/docs/drafts/">Working with drafts</a></li>
796
+
797
+
798
+
799
+ <li class=""><a href="https://jekyllrb.com/docs/pages/">Creating pages</a></li>
800
+
801
+
802
+
803
+ <li class=""><a href="https://jekyllrb.com/docs/static-files/">Static Files</a></li>
804
+
805
+
806
+
807
+ <li class="current"><a href="https://jekyllrb.com/docs/variables/">Variables</a></li>
808
+
809
+
810
+
811
+ <li class=""><a href="https://jekyllrb.com/docs/collections/">Collections</a></li>
812
+
813
+
814
+
815
+ <li class=""><a href="https://jekyllrb.com/docs/datafiles/">Data Files</a></li>
816
+
817
+
818
+
819
+ <li class=""><a href="https://jekyllrb.com/docs/assets/">Assets</a></li>
820
+
821
+
822
+
823
+ <li class=""><a href="https://jekyllrb.com/docs/migrations/">Blog migrations</a></li>
824
+
825
+ </ul>
826
+
827
+
828
+ <h4>Customization</h4>
829
+ <ul>
830
+
831
+
832
+
833
+ <li class=""><a href="https://jekyllrb.com/docs/templates/">Templates</a></li>
834
+
835
+
836
+
837
+ <li class=""><a href="https://jekyllrb.com/docs/permalinks/">Permalinks</a></li>
838
+
839
+
840
+
841
+ <li class=""><a href="https://jekyllrb.com/docs/pagination/">Pagination</a></li>
842
+
843
+
844
+
845
+ <li class=""><a href="https://jekyllrb.com/docs/plugins/">Plugins</a></li>
846
+
847
+
848
+
849
+ <li class=""><a href="https://jekyllrb.com/docs/themes/">Themes</a></li>
850
+
851
+
852
+
853
+ <li class=""><a href="https://jekyllrb.com/docs/extras/">Extras</a></li>
854
+
855
+ </ul>
856
+
857
+
858
+ <h4>Deployment</h4>
859
+ <ul>
860
+
861
+
862
+
863
+ <li class=""><a href="https://jekyllrb.com/docs/github-pages/">GitHub Pages</a></li>
864
+
865
+
866
+
867
+ <li class=""><a href="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</a></li>
868
+
869
+
870
+
871
+ <li class=""><a href="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</a></li>
872
+
873
+ </ul>
874
+
875
+
876
+ <h4>Miscellaneous</h4>
877
+ <ul>
878
+
879
+
880
+
881
+ <li class=""><a href="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</a></li>
882
+
883
+
884
+
885
+ <li class=""><a href="https://jekyllrb.com/docs/sites/">Sites using Jekyll</a></li>
886
+
887
+
888
+
889
+ <li class=""><a href="https://jekyllrb.com/docs/resources/">Resources</a></li>
890
+
891
+
892
+
893
+ <li class=""><a href="https://jekyllrb.com/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
894
+
895
+
896
+
897
+ <li class=""><a href="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
898
+
899
+ </ul>
900
+
901
+
902
+ <h4>Meta</h4>
903
+ <ul>
904
+
905
+
906
+
907
+ <li class=""><a href="https://jekyllrb.com/docs/contributing/">Contributing</a></li>
908
+
909
+
910
+
911
+ <li class=""><a href="https://jekyllrb.com/docs/conduct/">Code of Conduct</a></li>
912
+
913
+
914
+
915
+ <li class=""><a href="https://jekyllrb.com/docs/history/">History</a></li>
916
+
917
+ </ul>
918
+
919
+
920
+ </aside>
921
+ </div>
922
+
923
+
924
+ <div class="clear"></div>
925
+
926
+ </div>
927
+ </section>
928
+
929
+
930
+ <footer>
931
+ <div class="grid">
932
+ <div class="unit one-third center-on-mobiles">
933
+ <p>The contents of this website are <br>© 2016 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
934
+ </div>
935
+ <div class="unit two-thirds align-right center-on-mobiles">
936
+ <p>
937
+ Proudly hosted by
938
+ <a href="https://github.com">
939
+ <img src="/img/footer-logo.png" width="100" height="30" alt="GitHub • Social coding">
940
+ </a>
941
+ </p>
942
+ </div>
943
+ </div>
944
+ </footer>
945
+
946
+ <script>
947
+ var anchorForId = function (id) {
948
+ var anchor = document.createElement("a");
949
+ anchor.className = "header-link";
950
+ anchor.href = "#" + id;
951
+ anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
952
+ anchor.title = "Permalink";
953
+ return anchor;
954
+ };
955
+
956
+ var linkifyAnchors = function (level, containingElement) {
957
+ var headers = containingElement.getElementsByTagName("h" + level);
958
+ for (var h = 0; h < headers.length; h++) {
959
+ var header = headers[h];
960
+
961
+ if (typeof header.id !== "undefined" && header.id !== "") {
962
+ header.appendChild(anchorForId(header.id));
963
+ }
964
+ }
965
+ };
966
+
967
+ document.onreadystatechange = function () {
968
+ if (this.readyState === "complete") {
969
+ var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
970
+ if (!contentBlock) {
971
+ return;
972
+ }
973
+ for (var level = 1; level <= 6; level++) {
974
+ linkifyAnchors(level, contentBlock);
975
+ }
976
+ }
977
+ };
978
+ </script>
979
+
980
+
981
+ <!-- Gauges (http://gaug.es/) -->
982
+ <script>
983
+ var _gauges = _gauges || [];
984
+ (function() {
985
+ var t = document.createElement('script');
986
+ t.type = 'text/javascript';
987
+ t.async = true;
988
+ t.id = 'gauges-tracker';
989
+ t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
990
+ t.src = '//secure.gaug.es/track.js';
991
+ var s = document.getElementsByTagName('script')[0];
992
+ s.parentNode.insertBefore(t, s);
993
+ })();
994
+ </script>
995
+
996
+
997
+
998
+ <!-- Google Analytics (http://google.com/analytics) -->
999
+ <script>
1000
+ !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
1001
+ (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
1002
+ L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
1003
+ L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
1004
+
1005
+ ga('create', 'UA-50755011-1', 'jekyllrb.com');
1006
+ ga('send', 'pageview');
1007
+
1008
+ </script>
1009
+
1010
+
1011
+
1012
+ </body>
1013
+ </html>