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
data/site/docs/datafiles/index.html ADDED
@@ -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>