jekyll-docs 3.1.6 → 3.2.0

Sign up to get free protection for your applications and to get access to all the features.
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,742 @@
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>Data Files - Jekyll • Simple, blog-aware, static sites</title>
15
+ <meta property="og:title" content="Data Files">
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/datafiles/">
19
+ <meta property="og:url" content="https://jekyllrb.com/docs/datafiles/">
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": "Data Files",
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/datafiles/"
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/datafiles.md"><i class="fa fa-pencil"></i>  Improve this page</a>
283
+ </div>
284
+ <h1>Data Files</h1>
285
+ <p>In addition to the <a href="../variables/">built-in variables</a> available from Jekyll,
286
+ you can specify your own custom data that can be accessed via the <a href="https://wiki.github.com/shopify/liquid/liquid-for-designers">Liquid
287
+ templating system</a>.</p>
288
+
289
+ <p>Jekyll supports loading data from <a href="http://yaml.org/">YAML</a>, <a href="http://www.json.org/">JSON</a>,
290
+ and <a href="https://en.wikipedia.org/wiki/Comma-separated_values">CSV</a> files located in the <code class="highlighter-rouge">_data</code> directory.
291
+ Note that CSV files <em>must</em> contain a header row.</p>
292
+
293
+ <p>This powerful feature allows you to avoid repetition in your templates and to
294
+ set site specific options without changing <code class="highlighter-rouge">_config.yml</code>.</p>
295
+
296
+ <p>Plugins/themes can also leverage Data Files to set configuration variables.</p>
297
+
298
+ <h2 id="the-data-folder">The Data Folder</h2>
299
+
300
+ <p>As explained on the <a href="../structure/">directory structure</a> page, the <code class="highlighter-rouge">_data</code>
301
+ folder is where you can store additional data for Jekyll to use when generating
302
+ your site. These files must be YAML, JSON, or CSV files (using either
303
+ the <code class="highlighter-rouge">.yml</code>, <code class="highlighter-rouge">.yaml</code>, <code class="highlighter-rouge">.json</code> or <code class="highlighter-rouge">.csv</code> extension), and they will be
304
+ accessible via <code class="highlighter-rouge">site.data</code>.</p>
305
+
306
+ <h2 id="example-list-of-members">Example: List of members</h2>
307
+
308
+ <p>Here is a basic example of using Data Files to avoid copy-pasting large chunks
309
+ of code in your Jekyll templates:</p>
310
+
311
+ <p>In <code class="highlighter-rouge">_data/members.yml</code>:</p>
312
+
313
+ <figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="pi">-</span> <span class="s">name</span><span class="pi">:</span> <span class="s">Eric Mill</span>
314
+ <span class="s">github</span><span class="pi">:</span> <span class="s">konklone</span>
315
+
316
+ <span class="pi">-</span> <span class="s">name</span><span class="pi">:</span> <span class="s">Parker Moore</span>
317
+ <span class="s">github</span><span class="pi">:</span> <span class="s">parkr</span>
318
+
319
+ <span class="pi">-</span> <span class="s">name</span><span class="pi">:</span> <span class="s">Liu Fengyun</span>
320
+ <span class="s">github</span><span class="pi">:</span> <span class="s">liufengyun</span></code></pre></figure>
321
+
322
+ <p>Or <code class="highlighter-rouge">_data/members.csv</code>:</p>
323
+
324
+ <figure class="highlight"><pre><code class="language-text" data-lang="text">name,github
325
+ Eric Mill,konklone
326
+ Parker Moore,parkr
327
+ Liu Fengyun,liufengyun</code></pre></figure>
328
+
329
+ <p>This data can be accessed via <code class="highlighter-rouge">site.data.members</code> (notice that the filename
330
+ determines the variable name).</p>
331
+
332
+ <p>You can now render the list of members in a template:</p>
333
+
334
+ <figure class="highlight"><pre><code class="language-html" data-lang="html"><span class="nt">&lt;ul&gt;</span>
335
+ {% for member in site.data.members %}
336
+ <span class="nt">&lt;li&gt;</span>
337
+ <span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"https://github.com/{{ member.github }}"</span><span class="nt">&gt;</span>
338
+ {{ member.name }}
339
+ <span class="nt">&lt;/a&gt;</span>
340
+ <span class="nt">&lt;/li&gt;</span>
341
+ {% endfor %}
342
+ <span class="nt">&lt;/ul&gt;</span></code></pre></figure>
343
+
344
+ <h2 id="example-organizations">Example: Organizations</h2>
345
+
346
+ <p>Data files can also be placed in sub-folders of the <code class="highlighter-rouge">_data</code> folder. Each folder
347
+ level will be added to a variable’s namespace. The example below shows how
348
+ GitHub organizations could be defined separately in a file under the <code class="highlighter-rouge">orgs</code>
349
+ folder:</p>
350
+
351
+ <p>In <code class="highlighter-rouge">_data/orgs/jekyll.yml</code>:</p>
352
+
353
+ <figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">username</span><span class="pi">:</span> <span class="s">jekyll</span>
354
+ <span class="s">name</span><span class="pi">:</span> <span class="s">Jekyll</span>
355
+ <span class="s">members</span><span class="pi">:</span>
356
+ <span class="pi">-</span> <span class="s">name</span><span class="pi">:</span> <span class="s">Tom Preston-Werner</span>
357
+ <span class="s">github</span><span class="pi">:</span> <span class="s">mojombo</span>
358
+
359
+ <span class="pi">-</span> <span class="s">name</span><span class="pi">:</span> <span class="s">Parker Moore</span>
360
+ <span class="s">github</span><span class="pi">:</span> <span class="s">parkr</span></code></pre></figure>
361
+
362
+ <p>In <code class="highlighter-rouge">_data/orgs/doeorg.yml</code>:</p>
363
+
364
+ <figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">username</span><span class="pi">:</span> <span class="s">doeorg</span>
365
+ <span class="s">name</span><span class="pi">:</span> <span class="s">Doe Org</span>
366
+ <span class="s">members</span><span class="pi">:</span>
367
+ <span class="pi">-</span> <span class="s">name</span><span class="pi">:</span> <span class="s">John Doe</span>
368
+ <span class="s">github</span><span class="pi">:</span> <span class="s">jdoe</span></code></pre></figure>
369
+
370
+ <p>The organizations can then be accessed via <code class="highlighter-rouge">site.data.orgs</code>, followed by the
371
+ file name:</p>
372
+
373
+ <figure class="highlight"><pre><code class="language-html" data-lang="html"><span class="nt">&lt;ul&gt;</span>
374
+ {% for org_hash in site.data.orgs %}
375
+ {% assign org = org_hash[1] %}
376
+ <span class="nt">&lt;li&gt;</span>
377
+ <span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"https://github.com/{{ org.username }}"</span><span class="nt">&gt;</span>
378
+ {{ org.name }}
379
+ <span class="nt">&lt;/a&gt;</span>
380
+ ({{ org.members | size }} members)
381
+ <span class="nt">&lt;/li&gt;</span>
382
+ {% endfor %}
383
+ <span class="nt">&lt;/ul&gt;</span></code></pre></figure>
384
+
385
+ <h2 id="example-accessing-a-specific-author">Example: Accessing a specific author</h2>
386
+
387
+ <p>Pages and posts can also access a specific data item. The example below shows how to access a specific item:</p>
388
+
389
+ <p><code class="highlighter-rouge">_data/people.yml</code>:</p>
390
+
391
+ <figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">dave</span><span class="pi">:</span>
392
+ <span class="s">name</span><span class="pi">:</span> <span class="s">David Smith</span>
393
+ <span class="s">twitter</span><span class="pi">:</span> <span class="s">DavidSilvaSmith</span></code></pre></figure>
394
+
395
+ <p>The author can then be specified as a page variable in a post’s frontmatter:</p>
396
+
397
+ <figure class="highlight"><pre><code class="language-html" data-lang="html">---
398
+ title: sample post
399
+ author: dave
400
+ ---
401
+
402
+ {% assign author = site.data.people[page.author] %}
403
+ <span class="nt">&lt;a</span> <span class="na">rel=</span><span class="s">"author"</span>
404
+ <span class="na">href=</span><span class="s">"{{ author.twitter }}"</span>
405
+ <span class="na">title=</span><span class="s">"{{ author.name }}"</span><span class="nt">&gt;</span>
406
+ {{ author.name }}
407
+ <span class="nt">&lt;/a&gt;</span></code></pre></figure>
408
+
409
+
410
+
411
+
412
+
413
+
414
+
415
+
416
+
417
+
418
+
419
+
420
+
421
+
422
+
423
+
424
+
425
+
426
+
427
+
428
+
429
+
430
+
431
+
432
+
433
+
434
+
435
+
436
+
437
+
438
+
439
+
440
+
441
+
442
+
443
+
444
+
445
+
446
+
447
+
448
+
449
+
450
+
451
+
452
+
453
+
454
+
455
+
456
+
457
+ <div class="section-nav">
458
+ <div class="left align-right">
459
+
460
+
461
+
462
+ <a href="/docs/collections/" class="prev">Back</a>
463
+
464
+ </div>
465
+ <div class="right align-left">
466
+
467
+
468
+
469
+ <a href="/docs/assets/" class="next">Next</a>
470
+
471
+ </div>
472
+ </div>
473
+ <div class="clear"></div>
474
+
475
+ </article>
476
+ </div>
477
+
478
+ <div class="unit one-fifth hide-on-mobiles">
479
+ <aside>
480
+
481
+ <h4>Getting Started</h4>
482
+ <ul>
483
+
484
+
485
+
486
+ <li class=""><a href="https://jekyllrb.com/docs/home/">Welcome</a></li>
487
+
488
+
489
+
490
+ <li class=""><a href="https://jekyllrb.com/docs/quickstart/">Quick-start guide</a></li>
491
+
492
+
493
+
494
+ <li class=""><a href="https://jekyllrb.com/docs/installation/">Installation</a></li>
495
+
496
+
497
+
498
+ <li class=""><a href="https://jekyllrb.com/docs/usage/">Basic Usage</a></li>
499
+
500
+
501
+
502
+ <li class=""><a href="https://jekyllrb.com/docs/structure/">Directory structure</a></li>
503
+
504
+
505
+
506
+ <li class=""><a href="https://jekyllrb.com/docs/configuration/">Configuration</a></li>
507
+
508
+ </ul>
509
+
510
+
511
+ <h4>Your Content</h4>
512
+ <ul>
513
+
514
+
515
+
516
+ <li class=""><a href="https://jekyllrb.com/docs/frontmatter/">Front Matter</a></li>
517
+
518
+
519
+
520
+ <li class=""><a href="https://jekyllrb.com/docs/posts/">Writing posts</a></li>
521
+
522
+
523
+
524
+ <li class=""><a href="https://jekyllrb.com/docs/drafts/">Working with drafts</a></li>
525
+
526
+
527
+
528
+ <li class=""><a href="https://jekyllrb.com/docs/pages/">Creating pages</a></li>
529
+
530
+
531
+
532
+ <li class=""><a href="https://jekyllrb.com/docs/static-files/">Static Files</a></li>
533
+
534
+
535
+
536
+ <li class=""><a href="https://jekyllrb.com/docs/variables/">Variables</a></li>
537
+
538
+
539
+
540
+ <li class=""><a href="https://jekyllrb.com/docs/collections/">Collections</a></li>
541
+
542
+
543
+
544
+ <li class="current"><a href="https://jekyllrb.com/docs/datafiles/">Data Files</a></li>
545
+
546
+
547
+
548
+ <li class=""><a href="https://jekyllrb.com/docs/assets/">Assets</a></li>
549
+
550
+
551
+
552
+ <li class=""><a href="https://jekyllrb.com/docs/migrations/">Blog migrations</a></li>
553
+
554
+ </ul>
555
+
556
+
557
+ <h4>Customization</h4>
558
+ <ul>
559
+
560
+
561
+
562
+ <li class=""><a href="https://jekyllrb.com/docs/templates/">Templates</a></li>
563
+
564
+
565
+
566
+ <li class=""><a href="https://jekyllrb.com/docs/permalinks/">Permalinks</a></li>
567
+
568
+
569
+
570
+ <li class=""><a href="https://jekyllrb.com/docs/pagination/">Pagination</a></li>
571
+
572
+
573
+
574
+ <li class=""><a href="https://jekyllrb.com/docs/plugins/">Plugins</a></li>
575
+
576
+
577
+
578
+ <li class=""><a href="https://jekyllrb.com/docs/themes/">Themes</a></li>
579
+
580
+
581
+
582
+ <li class=""><a href="https://jekyllrb.com/docs/extras/">Extras</a></li>
583
+
584
+ </ul>
585
+
586
+
587
+ <h4>Deployment</h4>
588
+ <ul>
589
+
590
+
591
+
592
+ <li class=""><a href="https://jekyllrb.com/docs/github-pages/">GitHub Pages</a></li>
593
+
594
+
595
+
596
+ <li class=""><a href="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</a></li>
597
+
598
+
599
+
600
+ <li class=""><a href="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</a></li>
601
+
602
+ </ul>
603
+
604
+
605
+ <h4>Miscellaneous</h4>
606
+ <ul>
607
+
608
+
609
+
610
+ <li class=""><a href="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</a></li>
611
+
612
+
613
+
614
+ <li class=""><a href="https://jekyllrb.com/docs/sites/">Sites using Jekyll</a></li>
615
+
616
+
617
+
618
+ <li class=""><a href="https://jekyllrb.com/docs/resources/">Resources</a></li>
619
+
620
+
621
+
622
+ <li class=""><a href="https://jekyllrb.com/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
623
+
624
+
625
+
626
+ <li class=""><a href="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
627
+
628
+ </ul>
629
+
630
+
631
+ <h4>Meta</h4>
632
+ <ul>
633
+
634
+
635
+
636
+ <li class=""><a href="https://jekyllrb.com/docs/contributing/">Contributing</a></li>
637
+
638
+
639
+
640
+ <li class=""><a href="https://jekyllrb.com/docs/conduct/">Code of Conduct</a></li>
641
+
642
+
643
+
644
+ <li class=""><a href="https://jekyllrb.com/docs/history/">History</a></li>
645
+
646
+ </ul>
647
+
648
+
649
+ </aside>
650
+ </div>
651
+
652
+
653
+ <div class="clear"></div>
654
+
655
+ </div>
656
+ </section>
657
+
658
+
659
+ <footer>
660
+ <div class="grid">
661
+ <div class="unit one-third center-on-mobiles">
662
+ <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>
663
+ </div>
664
+ <div class="unit two-thirds align-right center-on-mobiles">
665
+ <p>
666
+ Proudly hosted by
667
+ <a href="https://github.com">
668
+ <img src="/img/footer-logo.png" width="100" height="30" alt="GitHub • Social coding">
669
+ </a>
670
+ </p>
671
+ </div>
672
+ </div>
673
+ </footer>
674
+
675
+ <script>
676
+ var anchorForId = function (id) {
677
+ var anchor = document.createElement("a");
678
+ anchor.className = "header-link";
679
+ anchor.href = "#" + id;
680
+ anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
681
+ anchor.title = "Permalink";
682
+ return anchor;
683
+ };
684
+
685
+ var linkifyAnchors = function (level, containingElement) {
686
+ var headers = containingElement.getElementsByTagName("h" + level);
687
+ for (var h = 0; h < headers.length; h++) {
688
+ var header = headers[h];
689
+
690
+ if (typeof header.id !== "undefined" && header.id !== "") {
691
+ header.appendChild(anchorForId(header.id));
692
+ }
693
+ }
694
+ };
695
+
696
+ document.onreadystatechange = function () {
697
+ if (this.readyState === "complete") {
698
+ var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
699
+ if (!contentBlock) {
700
+ return;
701
+ }
702
+ for (var level = 1; level <= 6; level++) {
703
+ linkifyAnchors(level, contentBlock);
704
+ }
705
+ }
706
+ };
707
+ </script>
708
+
709
+
710
+ <!-- Gauges (http://gaug.es/) -->
711
+ <script>
712
+ var _gauges = _gauges || [];
713
+ (function() {
714
+ var t = document.createElement('script');
715
+ t.type = 'text/javascript';
716
+ t.async = true;
717
+ t.id = 'gauges-tracker';
718
+ t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
719
+ t.src = '//secure.gaug.es/track.js';
720
+ var s = document.getElementsByTagName('script')[0];
721
+ s.parentNode.insertBefore(t, s);
722
+ })();
723
+ </script>
724
+
725
+
726
+
727
+ <!-- Google Analytics (http://google.com/analytics) -->
728
+ <script>
729
+ !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
730
+ (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
731
+ L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
732
+ L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
733
+
734
+ ga('create', 'UA-50755011-1', 'jekyllrb.com');
735
+ ga('send', 'pageview');
736
+
737
+ </script>
738
+
739
+
740
+
741
+ </body>
742
+ </html>