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,775 @@
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>Jekyll on Windows - Jekyll • Simple, blog-aware, static sites</title>
15
+ <meta property="og:title" content="Jekyll on Windows">
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/windows/">
19
+ <meta property="og:url" content="https://jekyllrb.com/docs/windows/">
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": "Jekyll on Windows",
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/windows/"
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/windows.md"><i class="fa fa-pencil"></i>  Improve this page</a>
283
+ </div>
284
+ <h1>Jekyll on Windows</h1>
285
+ <p>While Windows is not an officially-supported platform, it can be used to run
286
+ Jekyll with the proper tweaks. This page aims to collect some of the general
287
+ knowledge and lessons that have been unearthed by Windows users.</p>
288
+
289
+ <h2 id="installation">Installation</h2>
290
+
291
+ <p>A quick way to install Jekyll is to follow the <a href="https://davidburela.wordpress.com/2015/11/28/easily-install-jekyll-on-windows-with-3-command-prompt-entries-and-chocolatey/">installation instructions by David Burela</a>:</p>
292
+
293
+ <ol>
294
+ <li>Install a package manager for Windows called <a href="https://chocolatey.org/install">Chocolatey</a>
295
+ </li>
296
+ <li>Install Ruby via Chocolatey: <code class="highlighter-rouge">choco install ruby -y</code>
297
+ </li>
298
+ <li>Reopen a command prompt and install Jekyll: <code class="highlighter-rouge">gem install jekyll</code>
299
+ </li>
300
+ </ol>
301
+
302
+ <p>For a more conventional way of installing Jekyll you can follow the <a href="http://jekyll-windows.juthilo.com/">installation instruction by Julian Thilo</a>. The instructions were written for Ruby 2.0.0, but should work for later
303
+ versions <a href="https://github.com/copiousfreetime/hitimes/issues/40">prior to 2.2</a>.</p>
304
+
305
+ <h2 id="encoding">Encoding</h2>
306
+
307
+ <p>If you use UTF-8 encoding, make sure that no <code class="highlighter-rouge">BOM</code> header
308
+ characters exist in your files or very, very bad things will happen to
309
+ Jekyll. This is especially relevant if you’re running Jekyll on Windows.</p>
310
+
311
+ <p>Additionally, you might need to change the code page of the console window to UTF-8
312
+ in case you get a “Liquid Exception: Incompatible character encoding” error during
313
+ the site generation process. It can be done with the following command:</p>
314
+
315
+ <figure class="highlight"><pre><code class="language-shell" data-lang="shell"><span class="gp">$ </span>chcp 65001</code></pre></figure>
316
+
317
+ <h2 id="auto-regeneration">Auto-regeneration</h2>
318
+
319
+ <p>As of v1.3.0, Jekyll uses the <code class="highlighter-rouge">listen</code> gem to watch for changes when the
320
+ <code class="highlighter-rouge">--watch</code> switch is specified during a build or serve. While <code class="highlighter-rouge">listen</code> has
321
+ built-in support for UNIX systems, it requires an extra gem for compatibility
322
+ with Windows. Add the following to the Gemfile for your site:</p>
323
+
324
+ <figure class="highlight"><pre><code class="language-ruby" data-lang="ruby"><span class="n">gem</span> <span class="s1">'wdm'</span><span class="p">,</span> <span class="s1">'~&gt; 0.1.0'</span> <span class="k">if</span> <span class="no">Gem</span><span class="p">.</span><span class="nf">win_platform?</span></code></pre></figure>
325
+
326
+ <h3 id="how-to-install-github-pages">How to install github-pages</h3>
327
+
328
+ <p>This section is part of an article written by <a href="http://jwillmer.de/blog/tutorial/how-to-install-jekyll-and-pages-gem-on-windows-10-x46" title="Installation instructions by Jens Willmer">Jens Willmer</a>. To follow the instructions you need to have <a href="https://chocolatey.org/install" title="Package manager for Windows">Chocolatey</a> installed on your system. If you already have a version of Ruby installed you need to uninstall it before you can continue.</p>
329
+
330
+ <h4 id="install-ruby-and-ruby-development-kit">Install Ruby and Ruby development kit</h4>
331
+
332
+ <p>Open a command prompt and execute the following commands:</p>
333
+
334
+ <ul>
335
+ <li><code class="highlighter-rouge">choco install ruby -version 2.2.4</code></li>
336
+ <li>
337
+ <code class="highlighter-rouge">choco install ruby2.devkit</code> - <em>needed for compilation of json gem</em>
338
+ </li>
339
+ </ul>
340
+
341
+ <h4 id="configure-ruby-development-kit">Configure Ruby development kit</h4>
342
+
343
+ <p>The development kit did not set the environment path for Ruby so we need to do it.</p>
344
+
345
+ <ul>
346
+ <li>Open command prompt in <code class="highlighter-rouge">C:\tools\DevKit2</code>
347
+ </li>
348
+ <li>Execute <code class="highlighter-rouge">ruby dk.rb init</code> to create a file called <code class="highlighter-rouge">config.yml</code>
349
+ </li>
350
+ <li>Edit the <code class="highlighter-rouge">config.yml</code> file and include the path to Ruby <code class="highlighter-rouge">- C:/tools/ruby22</code>
351
+ </li>
352
+ <li>Execute the following command to set the path: <code class="highlighter-rouge">ruby dk.rb install</code>
353
+ </li>
354
+ </ul>
355
+
356
+ <h4 id="nokogiri-gem-installation">Nokogiri gem installation</h4>
357
+
358
+ <p>This gem is also needed in the github-pages and to get it running on Windows x64 we have to install a few things.</p>
359
+
360
+ <p><strong>Note:</strong> In the current <a href="https://github.com/sparklemotion/nokogiri/issues/1456#issuecomment-206481794" title="Nokogiri fails to install on Ruby 2.3 for Windows">pre release</a> it works out of the box with Windows x64 but this version is not referenced in the github-pages.</p>
361
+
362
+ <p><code class="language-ruby highlighter-rouge"><span class="n">cinst</span> <span class="o">-</span><span class="no">Source</span> <span class="s2">"https://go.microsoft.com/fwlink/?LinkID=230477"</span> <span class="n">libxml2</span></code></p>
363
+
364
+ <p><code class="language-ruby highlighter-rouge"><span class="n">cinst</span> <span class="o">-</span><span class="no">Source</span> <span class="s2">"https://go.microsoft.com/fwlink/?LinkID=230477"</span> <span class="n">libxslt</span></code></p>
365
+
366
+ <p><code class="language-ruby highlighter-rouge"><span class="n">cinst</span> <span class="o">-</span><span class="no">Source</span> <span class="s2">"https://go.microsoft.com/fwlink/?LinkID=230477"</span> <span class="n">libiconv</span></code></p>
367
+
368
+ <pre><code class="language-language-ruby"> gem install nokogiri --^
369
+ --with-xml2-include=C:\Chocolatey\lib\libxml2.2.7.8.7\build\native\include^
370
+ --with-xml2-lib=C:\Chocolatey\lib\libxml2.redist.2.7.8.7\build\native\bin\v110\x64\Release\dynamic\cdecl^
371
+ --with-iconv-include=C:\Chocolatey\lib\libiconv.1.14.0.11\build\native\include^
372
+ --with-iconv-lib=C:\Chocolatey\lib\libiconv.redist.1.14.0.11\build\native\bin\v110\x64\Release\dynamic\cdecl^
373
+ --with-xslt-include=C:\Chocolatey\lib\libxslt.1.1.28.0\build\native\include^
374
+ --with-xslt-lib=C:\Chocolatey\lib\libxslt.redist.1.1.28.0\build\native\bin\v110\x64\Release\dynamic
375
+ </code></pre>
376
+
377
+ <h4 id="install-github-pages">Install github-pages</h4>
378
+
379
+ <ul>
380
+ <li>Open command prompt and install <a href="http://bundler.io/" title="Ruby Dependencie Manager">Bundler</a>: <code class="highlighter-rouge">gem install bundler</code>
381
+ </li>
382
+ <li>Create a file called <code class="highlighter-rouge">Gemfile</code> without any extension in your root directory of your blog</li>
383
+ <li>Copy &amp; past the two lines into the file:</li>
384
+ </ul>
385
+
386
+ <pre><code class="language-language-ruby">source 'http://rubygems.org'
387
+ gem 'github-pages'
388
+ </code></pre>
389
+
390
+ <ul>
391
+ <li>
392
+ <strong>Note:</strong> We use an unsecure connection because SSL throws exceptions in the version of Ruby</li>
393
+ <li>Open a command prompt, target your local blog repository root, and install github-pages: <code class="highlighter-rouge">bundle install</code>
394
+ </li>
395
+ </ul>
396
+
397
+ <p>After this process you should have github-pages installed on your system and you can host your blog again with <code class="highlighter-rouge">jekyll s</code>. <br>
398
+ There will be a warning on startup that you should include <code class="highlighter-rouge">gem 'wdm', '&gt;= 0.1.0' if Gem.win_platform?</code> to your <code class="highlighter-rouge">Gemfile</code> but I could not get <code class="highlighter-rouge">jekyll s</code> working if I include that line so for the moment I ignore that warning.</p>
399
+
400
+ <p>In the future the installation process of the github-pages should be as simple as the setup of the blog. But as long as the new version of the Nokogiri (<a href="https://github.com/sparklemotion/nokogiri/releases" title="Nokogiri Releases">v1.6.8</a>) is not stable and referenced, it is work to get it up and running on Windows.</p>
401
+
402
+
403
+
404
+
405
+
406
+
407
+
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
+
458
+
459
+
460
+
461
+
462
+
463
+
464
+
465
+
466
+
467
+
468
+
469
+
470
+
471
+
472
+
473
+
474
+
475
+
476
+
477
+
478
+
479
+
480
+
481
+
482
+
483
+
484
+
485
+
486
+
487
+
488
+
489
+
490
+
491
+
492
+
493
+
494
+
495
+
496
+
497
+
498
+
499
+
500
+
501
+
502
+
503
+
504
+
505
+
506
+
507
+
508
+ </article>
509
+ </div>
510
+
511
+ <div class="unit one-fifth hide-on-mobiles">
512
+ <aside>
513
+
514
+ <h4>Getting Started</h4>
515
+ <ul>
516
+
517
+
518
+
519
+ <li class=""><a href="https://jekyllrb.com/docs/home/">Welcome</a></li>
520
+
521
+
522
+
523
+ <li class=""><a href="https://jekyllrb.com/docs/quickstart/">Quick-start guide</a></li>
524
+
525
+
526
+
527
+ <li class=""><a href="https://jekyllrb.com/docs/installation/">Installation</a></li>
528
+
529
+
530
+
531
+ <li class=""><a href="https://jekyllrb.com/docs/usage/">Basic Usage</a></li>
532
+
533
+
534
+
535
+ <li class=""><a href="https://jekyllrb.com/docs/structure/">Directory structure</a></li>
536
+
537
+
538
+
539
+ <li class=""><a href="https://jekyllrb.com/docs/configuration/">Configuration</a></li>
540
+
541
+ </ul>
542
+
543
+
544
+ <h4>Your Content</h4>
545
+ <ul>
546
+
547
+
548
+
549
+ <li class=""><a href="https://jekyllrb.com/docs/frontmatter/">Front Matter</a></li>
550
+
551
+
552
+
553
+ <li class=""><a href="https://jekyllrb.com/docs/posts/">Writing posts</a></li>
554
+
555
+
556
+
557
+ <li class=""><a href="https://jekyllrb.com/docs/drafts/">Working with drafts</a></li>
558
+
559
+
560
+
561
+ <li class=""><a href="https://jekyllrb.com/docs/pages/">Creating pages</a></li>
562
+
563
+
564
+
565
+ <li class=""><a href="https://jekyllrb.com/docs/static-files/">Static Files</a></li>
566
+
567
+
568
+
569
+ <li class=""><a href="https://jekyllrb.com/docs/variables/">Variables</a></li>
570
+
571
+
572
+
573
+ <li class=""><a href="https://jekyllrb.com/docs/collections/">Collections</a></li>
574
+
575
+
576
+
577
+ <li class=""><a href="https://jekyllrb.com/docs/datafiles/">Data Files</a></li>
578
+
579
+
580
+
581
+ <li class=""><a href="https://jekyllrb.com/docs/assets/">Assets</a></li>
582
+
583
+
584
+
585
+ <li class=""><a href="https://jekyllrb.com/docs/migrations/">Blog migrations</a></li>
586
+
587
+ </ul>
588
+
589
+
590
+ <h4>Customization</h4>
591
+ <ul>
592
+
593
+
594
+
595
+ <li class=""><a href="https://jekyllrb.com/docs/templates/">Templates</a></li>
596
+
597
+
598
+
599
+ <li class=""><a href="https://jekyllrb.com/docs/permalinks/">Permalinks</a></li>
600
+
601
+
602
+
603
+ <li class=""><a href="https://jekyllrb.com/docs/pagination/">Pagination</a></li>
604
+
605
+
606
+
607
+ <li class=""><a href="https://jekyllrb.com/docs/plugins/">Plugins</a></li>
608
+
609
+
610
+
611
+ <li class=""><a href="https://jekyllrb.com/docs/themes/">Themes</a></li>
612
+
613
+
614
+
615
+ <li class=""><a href="https://jekyllrb.com/docs/extras/">Extras</a></li>
616
+
617
+ </ul>
618
+
619
+
620
+ <h4>Deployment</h4>
621
+ <ul>
622
+
623
+
624
+
625
+ <li class=""><a href="https://jekyllrb.com/docs/github-pages/">GitHub Pages</a></li>
626
+
627
+
628
+
629
+ <li class=""><a href="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</a></li>
630
+
631
+
632
+
633
+ <li class=""><a href="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</a></li>
634
+
635
+ </ul>
636
+
637
+
638
+ <h4>Miscellaneous</h4>
639
+ <ul>
640
+
641
+
642
+
643
+ <li class=""><a href="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</a></li>
644
+
645
+
646
+
647
+ <li class=""><a href="https://jekyllrb.com/docs/sites/">Sites using Jekyll</a></li>
648
+
649
+
650
+
651
+ <li class=""><a href="https://jekyllrb.com/docs/resources/">Resources</a></li>
652
+
653
+
654
+
655
+ <li class=""><a href="https://jekyllrb.com/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
656
+
657
+
658
+
659
+ <li class=""><a href="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
660
+
661
+ </ul>
662
+
663
+
664
+ <h4>Meta</h4>
665
+ <ul>
666
+
667
+
668
+
669
+ <li class=""><a href="https://jekyllrb.com/docs/contributing/">Contributing</a></li>
670
+
671
+
672
+
673
+ <li class=""><a href="https://jekyllrb.com/docs/conduct/">Code of Conduct</a></li>
674
+
675
+
676
+
677
+ <li class=""><a href="https://jekyllrb.com/docs/history/">History</a></li>
678
+
679
+ </ul>
680
+
681
+
682
+ </aside>
683
+ </div>
684
+
685
+
686
+ <div class="clear"></div>
687
+
688
+ </div>
689
+ </section>
690
+
691
+
692
+ <footer>
693
+ <div class="grid">
694
+ <div class="unit one-third center-on-mobiles">
695
+ <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>
696
+ </div>
697
+ <div class="unit two-thirds align-right center-on-mobiles">
698
+ <p>
699
+ Proudly hosted by
700
+ <a href="https://github.com">
701
+ <img src="/img/footer-logo.png" width="100" height="30" alt="GitHub • Social coding">
702
+ </a>
703
+ </p>
704
+ </div>
705
+ </div>
706
+ </footer>
707
+
708
+ <script>
709
+ var anchorForId = function (id) {
710
+ var anchor = document.createElement("a");
711
+ anchor.className = "header-link";
712
+ anchor.href = "#" + id;
713
+ anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
714
+ anchor.title = "Permalink";
715
+ return anchor;
716
+ };
717
+
718
+ var linkifyAnchors = function (level, containingElement) {
719
+ var headers = containingElement.getElementsByTagName("h" + level);
720
+ for (var h = 0; h < headers.length; h++) {
721
+ var header = headers[h];
722
+
723
+ if (typeof header.id !== "undefined" && header.id !== "") {
724
+ header.appendChild(anchorForId(header.id));
725
+ }
726
+ }
727
+ };
728
+
729
+ document.onreadystatechange = function () {
730
+ if (this.readyState === "complete") {
731
+ var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
732
+ if (!contentBlock) {
733
+ return;
734
+ }
735
+ for (var level = 1; level <= 6; level++) {
736
+ linkifyAnchors(level, contentBlock);
737
+ }
738
+ }
739
+ };
740
+ </script>
741
+
742
+
743
+ <!-- Gauges (http://gaug.es/) -->
744
+ <script>
745
+ var _gauges = _gauges || [];
746
+ (function() {
747
+ var t = document.createElement('script');
748
+ t.type = 'text/javascript';
749
+ t.async = true;
750
+ t.id = 'gauges-tracker';
751
+ t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
752
+ t.src = '//secure.gaug.es/track.js';
753
+ var s = document.getElementsByTagName('script')[0];
754
+ s.parentNode.insertBefore(t, s);
755
+ })();
756
+ </script>
757
+
758
+
759
+
760
+ <!-- Google Analytics (http://google.com/analytics) -->
761
+ <script>
762
+ !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
763
+ (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
764
+ L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
765
+ L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
766
+
767
+ ga('create', 'UA-50755011-1', 'jekyllrb.com');
768
+ ga('send', 'pageview');
769
+
770
+ </script>
771
+
772
+
773
+
774
+ </body>
775
+ </html>