jekyll-docs 3.2.1 → 3.3.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 (102) hide show
  1. checksums.yaml +4 -4
  2. data/site/404.html +2 -2
  3. data/site/community/index.html +4 -4
  4. data/site/css/screen.css +16 -8
  5. data/site/docs/assets/index.html +90 -79
  6. data/site/docs/collections/index.html +106 -84
  7. data/site/docs/conduct/index.html +70 -70
  8. data/site/docs/configuration/index.html +143 -93
  9. data/site/docs/continuous-integration/index.html +137 -95
  10. data/site/docs/contributing/index.html +70 -70
  11. data/site/docs/datafiles/index.html +116 -87
  12. data/site/docs/deployment-methods/index.html +108 -84
  13. data/site/docs/drafts/index.html +75 -72
  14. data/site/docs/extras/index.html +74 -71
  15. data/site/docs/frontmatter/index.html +82 -76
  16. data/site/docs/github-pages/index.html +88 -83
  17. data/site/docs/history/index.html +185 -74
  18. data/site/docs/home/index.html +70 -70
  19. data/site/docs/installation/index.html +94 -82
  20. data/site/docs/migrations/index.html +70 -70
  21. data/site/docs/pages/index.html +80 -74
  22. data/site/docs/pagination/index.html +91 -76
  23. data/site/docs/permalinks/index.html +70 -70
  24. data/site/docs/plugins/index.html +142 -96
  25. data/site/docs/posts/index.html +117 -87
  26. data/site/docs/quickstart/index.html +77 -73
  27. data/site/docs/resources/index.html +76 -71
  28. data/site/docs/sites/index.html +70 -70
  29. data/site/docs/static-files/index.html +88 -72
  30. data/site/docs/structure/index.html +79 -76
  31. data/site/docs/templates/index.html +210 -84
  32. data/site/docs/themes/index.html +106 -81
  33. data/site/docs/troubleshooting/index.html +155 -91
  34. data/site/docs/upgrading/0-to-2/index.html +74 -71
  35. data/site/docs/upgrading/2-to-3/index.html +99 -79
  36. data/site/docs/upgrading/index.html +70 -70
  37. data/site/docs/usage/index.html +95 -80
  38. data/site/docs/variables/index.html +71 -72
  39. data/site/docs/windows/index.html +89 -77
  40. data/site/feed.xml +111 -35
  41. data/site/help/index.html +2 -2
  42. data/site/index.html +3 -8
  43. data/site/latest_version.txt +1 -1
  44. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +18 -6
  45. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +18 -6
  46. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +18 -6
  47. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +18 -6
  48. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +18 -6
  49. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +18 -6
  50. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +18 -6
  51. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +18 -6
  52. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +18 -6
  53. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +18 -6
  54. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +18 -6
  55. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +18 -6
  56. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +18 -6
  57. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +18 -6
  58. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +18 -6
  59. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +18 -6
  60. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +18 -6
  61. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +18 -6
  62. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +18 -6
  63. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +18 -6
  64. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +18 -6
  65. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +18 -6
  66. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +18 -6
  67. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +18 -6
  68. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +18 -6
  69. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +18 -6
  70. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +18 -6
  71. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +18 -6
  72. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +18 -6
  73. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +18 -6
  74. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +18 -6
  75. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +18 -6
  76. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +18 -6
  77. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +18 -6
  78. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +18 -6
  79. data/site/news/2015/10/26/jekyll-3-0-released/index.html +18 -6
  80. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +18 -6
  81. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +18 -6
  82. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +18 -6
  83. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +18 -6
  84. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +18 -6
  85. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +18 -6
  86. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +18 -6
  87. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +18 -6
  88. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +18 -6
  89. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +18 -6
  90. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +18 -6
  91. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +18 -6
  92. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +18 -6
  93. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +18 -6
  94. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +19 -7
  95. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +18 -6
  96. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +536 -0
  97. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +615 -0
  98. data/site/news/index.html +172 -7
  99. data/site/news/releases/index.html +135 -7
  100. data/site/sitemap.xml +8 -0
  101. metadata +6 -5
  102. data/site/README.md +0 -16
@@ -4,7 +4,7 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.2.1">
7
+ <meta name="generator" content="Jekyll v3.3.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
@@ -19,7 +19,7 @@
19
19
  <meta property="og:url" content="https://jekyllrb.com/docs/troubleshooting/">
20
20
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
21
21
  <meta property="og:type" content="article">
22
- <meta property="article:published_time" content="2016-08-02T18:14:35-07:00">
22
+ <meta property="article:published_time" content="2016-10-06T11:16:34-07:00">
23
23
  <meta name="twitter:card" content="summary">
24
24
  <meta name="twitter:site" content="@jekyllrb">
25
25
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
@@ -28,9 +28,9 @@
28
28
  "@context": "http://schema.org",
29
29
  "@type": "BlogPosting",
30
30
  "headline": "Troubleshooting",
31
- "datePublished": "2016-08-02T18:14:35-07:00",
31
+ "datePublished": "2016-10-06T11:16:34-07:00",
32
32
  "description": "If you ever run into problems installing or using Jekyll, here are a few tipsthat might be of help. If the problem you’re experiencing isn’t covered below,please check out our other help resources as well.",
33
- "logo": "https://jekyllrb.comimg/logo-2x.png",
33
+ "logo": "https://jekyllrb.com/img/logo-2x.png",
34
34
  "url": "https://jekyllrb.com/docs/troubleshooting/"
35
35
  }
36
36
  </script>
@@ -114,27 +114,27 @@
114
114
 
115
115
 
116
116
 
117
- <option value="https://jekyllrb.com/docs/home/">Welcome</option>
117
+ <option value="/docs/home/">Welcome</option>
118
118
 
119
119
 
120
120
 
121
- <option value="https://jekyllrb.com/docs/quickstart/">Quick-start guide</option>
121
+ <option value="/docs/quickstart/">Quick-start guide</option>
122
122
 
123
123
 
124
124
 
125
- <option value="https://jekyllrb.com/docs/installation/">Installation</option>
125
+ <option value="/docs/installation/">Installation</option>
126
126
 
127
127
 
128
128
 
129
- <option value="https://jekyllrb.com/docs/usage/">Basic Usage</option>
129
+ <option value="/docs/usage/">Basic Usage</option>
130
130
 
131
131
 
132
132
 
133
- <option value="https://jekyllrb.com/docs/structure/">Directory structure</option>
133
+ <option value="/docs/structure/">Directory structure</option>
134
134
 
135
135
 
136
136
 
137
- <option value="https://jekyllrb.com/docs/configuration/">Configuration</option>
137
+ <option value="/docs/configuration/">Configuration</option>
138
138
 
139
139
 
140
140
  </optgroup>
@@ -143,43 +143,43 @@
143
143
 
144
144
 
145
145
 
146
- <option value="https://jekyllrb.com/docs/frontmatter/">Front Matter</option>
146
+ <option value="/docs/frontmatter/">Front Matter</option>
147
147
 
148
148
 
149
149
 
150
- <option value="https://jekyllrb.com/docs/posts/">Writing posts</option>
150
+ <option value="/docs/posts/">Writing posts</option>
151
151
 
152
152
 
153
153
 
154
- <option value="https://jekyllrb.com/docs/drafts/">Working with drafts</option>
154
+ <option value="/docs/drafts/">Working with drafts</option>
155
155
 
156
156
 
157
157
 
158
- <option value="https://jekyllrb.com/docs/pages/">Creating pages</option>
158
+ <option value="/docs/pages/">Creating pages</option>
159
159
 
160
160
 
161
161
 
162
- <option value="https://jekyllrb.com/docs/static-files/">Static Files</option>
162
+ <option value="/docs/static-files/">Static Files</option>
163
163
 
164
164
 
165
165
 
166
- <option value="https://jekyllrb.com/docs/variables/">Variables</option>
166
+ <option value="/docs/variables/">Variables</option>
167
167
 
168
168
 
169
169
 
170
- <option value="https://jekyllrb.com/docs/collections/">Collections</option>
170
+ <option value="/docs/collections/">Collections</option>
171
171
 
172
172
 
173
173
 
174
- <option value="https://jekyllrb.com/docs/datafiles/">Data Files</option>
174
+ <option value="/docs/datafiles/">Data Files</option>
175
175
 
176
176
 
177
177
 
178
- <option value="https://jekyllrb.com/docs/assets/">Assets</option>
178
+ <option value="/docs/assets/">Assets</option>
179
179
 
180
180
 
181
181
 
182
- <option value="https://jekyllrb.com/docs/migrations/">Blog migrations</option>
182
+ <option value="/docs/migrations/">Blog migrations</option>
183
183
 
184
184
 
185
185
  </optgroup>
@@ -188,27 +188,27 @@
188
188
 
189
189
 
190
190
 
191
- <option value="https://jekyllrb.com/docs/templates/">Templates</option>
191
+ <option value="/docs/templates/">Templates</option>
192
192
 
193
193
 
194
194
 
195
- <option value="https://jekyllrb.com/docs/permalinks/">Permalinks</option>
195
+ <option value="/docs/permalinks/">Permalinks</option>
196
196
 
197
197
 
198
198
 
199
- <option value="https://jekyllrb.com/docs/pagination/">Pagination</option>
199
+ <option value="/docs/pagination/">Pagination</option>
200
200
 
201
201
 
202
202
 
203
- <option value="https://jekyllrb.com/docs/plugins/">Plugins</option>
203
+ <option value="/docs/plugins/">Plugins</option>
204
204
 
205
205
 
206
206
 
207
- <option value="https://jekyllrb.com/docs/themes/">Themes</option>
207
+ <option value="/docs/themes/">Themes</option>
208
208
 
209
209
 
210
210
 
211
- <option value="https://jekyllrb.com/docs/extras/">Extras</option>
211
+ <option value="/docs/extras/">Extras</option>
212
212
 
213
213
 
214
214
  </optgroup>
@@ -217,15 +217,15 @@
217
217
 
218
218
 
219
219
 
220
- <option value="https://jekyllrb.com/docs/github-pages/">GitHub Pages</option>
220
+ <option value="/docs/github-pages/">GitHub Pages</option>
221
221
 
222
222
 
223
223
 
224
- <option value="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</option>
224
+ <option value="/docs/deployment-methods/">Deployment methods</option>
225
225
 
226
226
 
227
227
 
228
- <option value="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</option>
228
+ <option value="/docs/continuous-integration/">Continuous Integration</option>
229
229
 
230
230
 
231
231
  </optgroup>
@@ -234,23 +234,23 @@
234
234
 
235
235
 
236
236
 
237
- <option value="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</option>
237
+ <option value="/docs/troubleshooting/">Troubleshooting</option>
238
238
 
239
239
 
240
240
 
241
- <option value="https://jekyllrb.com/docs/sites/">Sites using Jekyll</option>
241
+ <option value="/docs/sites/">Sites using Jekyll</option>
242
242
 
243
243
 
244
244
 
245
- <option value="https://jekyllrb.com/docs/resources/">Resources</option>
245
+ <option value="/docs/resources/">Resources</option>
246
246
 
247
247
 
248
248
 
249
- <option value="https://jekyllrb.com/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
249
+ <option value="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
250
250
 
251
251
 
252
252
 
253
- <option value="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
253
+ <option value="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
254
254
 
255
255
 
256
256
  </optgroup>
@@ -259,15 +259,15 @@
259
259
 
260
260
 
261
261
 
262
- <option value="https://jekyllrb.com/docs/contributing/">Contributing</option>
262
+ <option value="/docs/contributing/">Contributing</option>
263
263
 
264
264
 
265
265
 
266
- <option value="https://jekyllrb.com/docs/conduct/">Code of Conduct</option>
266
+ <option value="/docs/conduct/">Code of Conduct</option>
267
267
 
268
268
 
269
269
 
270
- <option value="https://jekyllrb.com/docs/history/">History</option>
270
+ <option value="/docs/history/">History</option>
271
271
 
272
272
 
273
273
  </optgroup>
@@ -292,6 +292,7 @@ that might be of help. If the problem you’re experiencing isn’t covered belo
292
292
  <li><a href="#base-url-problems">Base-URL Problems</a></li>
293
293
  <li><a href="#configuration-problems">Configuration problems</a></li>
294
294
  <li><a href="#markup-problems">Markup Problems</a></li>
295
+ <li><a href="#production-problems">Production Problems</a></li>
295
296
  </ul>
296
297
 
297
298
  <h2 id="installation-problems">Installation Problems</h2>
@@ -300,46 +301,70 @@ that might be of help. If the problem you’re experiencing isn’t covered belo
300
301
  the header files for compiling extension modules for Ruby 2.0.0. This
301
302
  can be done on Ubuntu or Debian by running:</p>
302
303
 
303
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell">sudo apt-get install ruby2.0.0-dev</code></pre></figure>
304
+ <div class="language-sh highlighter-rouge">
305
+ <pre class="highlight"><code>sudo apt-get install ruby2.0.0-dev
306
+ </code></pre>
307
+ </div>
304
308
 
305
309
  <p>On Red Hat, CentOS, and Fedora systems you can do this by running:</p>
306
310
 
307
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell">sudo yum install ruby-devel</code></pre></figure>
311
+ <div class="language-sh highlighter-rouge">
312
+ <pre class="highlight"><code>sudo yum install ruby-devel
313
+ </code></pre>
314
+ </div>
308
315
 
309
316
  <p>If you installed the above - specifically on Fedora 23 - but the extensions would still not compile, you are probably running a Fedora image that misses the <code class="highlighter-rouge">redhat-rpm-config</code> package. To solve this, simply run:</p>
310
317
 
311
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell">sudo dnf install redhat-rpm-config</code></pre></figure>
318
+ <div class="language-sh highlighter-rouge">
319
+ <pre class="highlight"><code>sudo dnf install redhat-rpm-config
320
+ </code></pre>
321
+ </div>
312
322
 
313
323
  <p>On <a href="https://www.nearlyfreespeech.net/">NearlyFreeSpeech</a> you need to run the
314
324
  following commands before installing Jekyll:</p>
315
325
 
316
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell"><span class="nb">export </span><span class="nv">GEM_HOME</span><span class="o">=</span>/home/private/gems
326
+ <div class="language-sh highlighter-rouge">
327
+ <pre class="highlight"><code><span class="nb">export </span><span class="nv">GEM_HOME</span><span class="o">=</span>/home/private/gems
317
328
  <span class="nb">export </span><span class="nv">GEM_PATH</span><span class="o">=</span>/home/private/gems:/usr/local/lib/ruby/gems/1.8/
318
329
  <span class="nb">export </span><span class="nv">PATH</span><span class="o">=</span><span class="nv">$PATH</span>:/home/private/gems/bin
319
- <span class="nb">export </span><span class="nv">RB_USER_INSTALL</span><span class="o">=</span><span class="s1">'true'</span></code></pre></figure>
330
+ <span class="nb">export </span><span class="nv">RB_USER_INSTALL</span><span class="o">=</span><span class="s1">'true'</span>
331
+ </code></pre>
332
+ </div>
320
333
 
321
334
  <p>To install RubyGems on Gentoo:</p>
322
335
 
323
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell">sudo emerge -av dev-ruby/rubygems</code></pre></figure>
336
+ <div class="language-sh highlighter-rouge">
337
+ <pre class="highlight"><code>sudo emerge -av dev-ruby/rubygems
338
+ </code></pre>
339
+ </div>
324
340
 
325
341
  <p>On Windows, you may need to install <a href="https://wiki.github.com/oneclick/rubyinstaller/development-kit">RubyInstaller
326
342
  DevKit</a>.</p>
327
343
 
328
- <p>On Mac OS X, you may need to update RubyGems (using <code class="highlighter-rouge">sudo</code> only if necessary):</p>
344
+ <p>On macOS, you may need to update RubyGems (using <code class="highlighter-rouge">sudo</code> only if necessary):</p>
329
345
 
330
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell">sudo gem update --system</code></pre></figure>
346
+ <div class="language-sh highlighter-rouge">
347
+ <pre class="highlight"><code>sudo gem update --system
348
+ </code></pre>
349
+ </div>
331
350
 
332
351
  <p>If you still have issues, you can download and install new Command Line
333
- Tools (such as <code class="highlighter-rouge">gcc</code>) using the command</p>
352
+ Tools (such as <code class="highlighter-rouge">gcc</code>) using the following command:</p>
334
353
 
335
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell">xcode-select --install</code></pre></figure>
354
+ <div class="language-sh highlighter-rouge">
355
+ <pre class="highlight"><code>xcode-select --install
356
+ </code></pre>
357
+ </div>
336
358
 
337
359
  <p>which may allow you to install native gems using this command (again using
338
360
  <code class="highlighter-rouge">sudo</code> only if necessary):</p>
339
361
 
340
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell">sudo gem install jekyll</code></pre></figure>
362
+ <div class="language-sh highlighter-rouge">
363
+ <pre class="highlight"><code>sudo gem install jekyll
364
+ </code></pre>
365
+ </div>
341
366
 
342
- <p>Note that upgrading Mac OS X does not automatically upgrade Xcode itself
367
+ <p>Note that upgrading macOS does not automatically upgrade Xcode itself
343
368
  (that can be done separately via the App Store), and having an out-of-date
344
369
  Xcode.app can interfere with the command line tools downloaded above. If
345
370
  you run into this issue, upgrade Xcode and install the upgraded Command
@@ -353,16 +378,25 @@ longer available. Given these changes, there are a couple of simple ways to get
353
378
  up and running. One option is to change the location where the gem will be
354
379
  installed (again using <code class="highlighter-rouge">sudo</code> only if necessary):</p>
355
380
 
356
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell">sudo gem install -n /usr/local/bin jekyll</code></pre></figure>
381
+ <div class="language-sh highlighter-rouge">
382
+ <pre class="highlight"><code>sudo gem install -n /usr/local/bin jekyll
383
+ </code></pre>
384
+ </div>
357
385
 
358
386
  <p>Alternatively, Homebrew can be installed and used to set up Ruby. This can be
359
387
  done as follows:</p>
360
388
 
361
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell">ruby -e <span class="s2">"</span><span class="k">$(</span>curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install<span class="k">)</span><span class="s2">"</span></code></pre></figure>
389
+ <div class="language-sh highlighter-rouge">
390
+ <pre class="highlight"><code>ruby -e <span class="s2">"</span><span class="k">$(</span>curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install<span class="k">)</span><span class="s2">"</span>
391
+ </code></pre>
392
+ </div>
362
393
 
363
394
  <p>Once Homebrew is installed, the second step is easy:</p>
364
395
 
365
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell">brew install ruby</code></pre></figure>
396
+ <div class="language-sh highlighter-rouge">
397
+ <pre class="highlight"><code>brew install ruby
398
+ </code></pre>
399
+ </div>
366
400
 
367
401
  <p>Advanced users (with more complex needs) may find it helpful to choose one of a
368
402
  number of Ruby version managers (<a href="https://rvm.io">RVM</a>, <a href="http://rbenv.org">rbenv</a>, <a href="https://github.com/postmodern/chruby">chruby</a>, <a href="https://github.com/rvm/rvm/blob/master/docs/alt.md">etc</a>.) in
@@ -371,11 +405,17 @@ which to install Jekyll.</p>
371
405
  <p>If you elect to use one of the above methods to install Ruby, it might be
372
406
  necessary to modify your <code class="highlighter-rouge">$PATH</code> variable using the following command:</p>
373
407
 
374
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell"><span class="nb">export </span><span class="nv">PATH</span><span class="o">=</span>/usr/local/bin:<span class="nv">$PATH</span></code></pre></figure>
408
+ <div class="language-sh highlighter-rouge">
409
+ <pre class="highlight"><code><span class="nb">export </span><span class="nv">PATH</span><span class="o">=</span>/usr/local/bin:<span class="nv">$PATH</span>
410
+ </code></pre>
411
+ </div>
375
412
 
376
413
  <p>GUI apps can modify the <code class="highlighter-rouge">$PATH</code> as follows:</p>
377
414
 
378
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell">launchctl setenv PATH <span class="s2">"/usr/local/bin:</span><span class="nv">$PATH</span><span class="s2">"</span></code></pre></figure>
415
+ <div class="language-sh highlighter-rouge">
416
+ <pre class="highlight"><code>launchctl setenv PATH <span class="s2">"/usr/local/bin:</span><span class="nv">$PATH</span><span class="s2">"</span>
417
+ </code></pre>
418
+ </div>
379
419
 
380
420
  <p>Either of these approaches are useful because <code class="highlighter-rouge">/usr/local</code> is considered a
381
421
  “safe” location on systems which have SIP enabled, they avoid potential
@@ -399,15 +439,24 @@ in order to have the <code class="highlighter-rouge">jekyll</code> executable be
399
439
 
400
440
  <p>If you are using base-url option like:</p>
401
441
 
402
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell">jekyll serve --baseurl <span class="s1">'/blog'</span></code></pre></figure>
442
+ <div class="language-sh highlighter-rouge">
443
+ <pre class="highlight"><code>jekyll serve --baseurl <span class="s1">'/blog'</span>
444
+ </code></pre>
445
+ </div>
403
446
 
404
447
  <p>… then make sure that you access the site at:</p>
405
448
 
406
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell">http://localhost:4000/blog/index.html</code></pre></figure>
449
+ <div class="language-sh highlighter-rouge">
450
+ <pre class="highlight"><code>http://localhost:4000/blog/index.html
451
+ </code></pre>
452
+ </div>
407
453
 
408
454
  <p>It won’t work to just access:</p>
409
455
 
410
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell">http://localhost:4000/blog</code></pre></figure>
456
+ <div class="language-sh highlighter-rouge">
457
+ <pre class="highlight"><code>http://localhost:4000/blog
458
+ </code></pre>
459
+ </div>
411
460
 
412
461
  <h2 id="configuration-problems">Configuration problems</h2>
413
462
 
@@ -424,6 +473,11 @@ is as follows:</p>
424
473
  and flags specified at the command-line will override all other settings
425
474
  specified elsewhere.</p>
426
475
 
476
+ <p>If you encounter an error in building the site, with the error message
477
+ “‘0000-00-00-welcome-to-jekyll.markdown.erb’ does not have a valid date in the
478
+ YAML front matter.” try including the line <code class="highlighter-rouge">exclude: [vendor]</code>
479
+ in <code class="highlighter-rouge">_config.yml</code>.</p>
480
+
427
481
  <h2 id="markup-problems">Markup Problems</h2>
428
482
 
429
483
  <p>The various markup engines that Jekyll uses may have some issues. This
@@ -436,7 +490,10 @@ problems.</p>
436
490
  templates. Unlike previous versions, using <code class="highlighter-rouge"><span class="p">{</span><span class="err">{</span></code> in 2.0 triggers the
437
491
  following error:</p>
438
492
 
439
- <figure class="highlight"><pre><code class="language-shell" data-lang="shell"><span class="s1">'{{'</span> was not properly terminated with regexp: /<span class="se">\}\}</span>/ <span class="o">(</span>Liquid::SyntaxError<span class="o">)</span></code></pre></figure>
493
+ <div class="language-sh highlighter-rouge">
494
+ <pre class="highlight"><code><span class="s1">'{{'</span> was not properly terminated with regexp: /<span class="se">\}\}</span>/ <span class="o">(</span>Liquid::SyntaxError<span class="o">)</span>
495
+ </code></pre>
496
+ </div>
440
497
 
441
498
  <h3 id="excerpts">Excerpts</h3>
442
499
 
@@ -446,6 +503,13 @@ strange errors where references don’t exist or a tag hasn’t been closed. If
446
503
  run into these errors, try setting <code class="highlighter-rouge">excerpt_separator: ""</code> in your
447
504
  <code class="highlighter-rouge">_config.yml</code>, or set it to some nonsense string.</p>
448
505
 
506
+ <h2 id="production-problems">Production Problems</h2>
507
+
508
+ <p>If you run into an issue that a static file can’t be found in your
509
+ production environment during build since v3.2.0 you should set your
510
+ <a href="../configuration/#specifying-a-jekyll-environment-at-build-time">environment to <code class="highlighter-rouge">production</code></a>.
511
+ The issue is caused by trying to copy a non-existing symlink.</p>
512
+
449
513
  <div class="note">
450
514
  <h5>Please report issues you encounter!</h5>
451
515
  <p>
@@ -567,27 +631,27 @@ run into these errors, try setting <code class="highlighter-rouge">excerpt_separ
567
631
 
568
632
 
569
633
 
570
- <li class=""><a href="https://jekyllrb.com/docs/home/">Welcome</a></li>
634
+ <li class=""><a href="/docs/home/">Welcome</a></li>
571
635
 
572
636
 
573
637
 
574
- <li class=""><a href="https://jekyllrb.com/docs/quickstart/">Quick-start guide</a></li>
638
+ <li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
575
639
 
576
640
 
577
641
 
578
- <li class=""><a href="https://jekyllrb.com/docs/installation/">Installation</a></li>
642
+ <li class=""><a href="/docs/installation/">Installation</a></li>
579
643
 
580
644
 
581
645
 
582
- <li class=""><a href="https://jekyllrb.com/docs/usage/">Basic Usage</a></li>
646
+ <li class=""><a href="/docs/usage/">Basic Usage</a></li>
583
647
 
584
648
 
585
649
 
586
- <li class=""><a href="https://jekyllrb.com/docs/structure/">Directory structure</a></li>
650
+ <li class=""><a href="/docs/structure/">Directory structure</a></li>
587
651
 
588
652
 
589
653
 
590
- <li class=""><a href="https://jekyllrb.com/docs/configuration/">Configuration</a></li>
654
+ <li class=""><a href="/docs/configuration/">Configuration</a></li>
591
655
 
592
656
  </ul>
593
657
 
@@ -597,43 +661,43 @@ run into these errors, try setting <code class="highlighter-rouge">excerpt_separ
597
661
 
598
662
 
599
663
 
600
- <li class=""><a href="https://jekyllrb.com/docs/frontmatter/">Front Matter</a></li>
664
+ <li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
601
665
 
602
666
 
603
667
 
604
- <li class=""><a href="https://jekyllrb.com/docs/posts/">Writing posts</a></li>
668
+ <li class=""><a href="/docs/posts/">Writing posts</a></li>
605
669
 
606
670
 
607
671
 
608
- <li class=""><a href="https://jekyllrb.com/docs/drafts/">Working with drafts</a></li>
672
+ <li class=""><a href="/docs/drafts/">Working with drafts</a></li>
609
673
 
610
674
 
611
675
 
612
- <li class=""><a href="https://jekyllrb.com/docs/pages/">Creating pages</a></li>
676
+ <li class=""><a href="/docs/pages/">Creating pages</a></li>
613
677
 
614
678
 
615
679
 
616
- <li class=""><a href="https://jekyllrb.com/docs/static-files/">Static Files</a></li>
680
+ <li class=""><a href="/docs/static-files/">Static Files</a></li>
617
681
 
618
682
 
619
683
 
620
- <li class=""><a href="https://jekyllrb.com/docs/variables/">Variables</a></li>
684
+ <li class=""><a href="/docs/variables/">Variables</a></li>
621
685
 
622
686
 
623
687
 
624
- <li class=""><a href="https://jekyllrb.com/docs/collections/">Collections</a></li>
688
+ <li class=""><a href="/docs/collections/">Collections</a></li>
625
689
 
626
690
 
627
691
 
628
- <li class=""><a href="https://jekyllrb.com/docs/datafiles/">Data Files</a></li>
692
+ <li class=""><a href="/docs/datafiles/">Data Files</a></li>
629
693
 
630
694
 
631
695
 
632
- <li class=""><a href="https://jekyllrb.com/docs/assets/">Assets</a></li>
696
+ <li class=""><a href="/docs/assets/">Assets</a></li>
633
697
 
634
698
 
635
699
 
636
- <li class=""><a href="https://jekyllrb.com/docs/migrations/">Blog migrations</a></li>
700
+ <li class=""><a href="/docs/migrations/">Blog migrations</a></li>
637
701
 
638
702
  </ul>
639
703
 
@@ -643,27 +707,27 @@ run into these errors, try setting <code class="highlighter-rouge">excerpt_separ
643
707
 
644
708
 
645
709
 
646
- <li class=""><a href="https://jekyllrb.com/docs/templates/">Templates</a></li>
710
+ <li class=""><a href="/docs/templates/">Templates</a></li>
647
711
 
648
712
 
649
713
 
650
- <li class=""><a href="https://jekyllrb.com/docs/permalinks/">Permalinks</a></li>
714
+ <li class=""><a href="/docs/permalinks/">Permalinks</a></li>
651
715
 
652
716
 
653
717
 
654
- <li class=""><a href="https://jekyllrb.com/docs/pagination/">Pagination</a></li>
718
+ <li class=""><a href="/docs/pagination/">Pagination</a></li>
655
719
 
656
720
 
657
721
 
658
- <li class=""><a href="https://jekyllrb.com/docs/plugins/">Plugins</a></li>
722
+ <li class=""><a href="/docs/plugins/">Plugins</a></li>
659
723
 
660
724
 
661
725
 
662
- <li class=""><a href="https://jekyllrb.com/docs/themes/">Themes</a></li>
726
+ <li class=""><a href="/docs/themes/">Themes</a></li>
663
727
 
664
728
 
665
729
 
666
- <li class=""><a href="https://jekyllrb.com/docs/extras/">Extras</a></li>
730
+ <li class=""><a href="/docs/extras/">Extras</a></li>
667
731
 
668
732
  </ul>
669
733
 
@@ -673,15 +737,15 @@ run into these errors, try setting <code class="highlighter-rouge">excerpt_separ
673
737
 
674
738
 
675
739
 
676
- <li class=""><a href="https://jekyllrb.com/docs/github-pages/">GitHub Pages</a></li>
740
+ <li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
677
741
 
678
742
 
679
743
 
680
- <li class=""><a href="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</a></li>
744
+ <li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
681
745
 
682
746
 
683
747
 
684
- <li class=""><a href="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</a></li>
748
+ <li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
685
749
 
686
750
  </ul>
687
751
 
@@ -691,23 +755,23 @@ run into these errors, try setting <code class="highlighter-rouge">excerpt_separ
691
755
 
692
756
 
693
757
 
694
- <li class="current"><a href="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</a></li>
758
+ <li class="current"><a href="/docs/troubleshooting/">Troubleshooting</a></li>
695
759
 
696
760
 
697
761
 
698
- <li class=""><a href="https://jekyllrb.com/docs/sites/">Sites using Jekyll</a></li>
762
+ <li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
699
763
 
700
764
 
701
765
 
702
- <li class=""><a href="https://jekyllrb.com/docs/resources/">Resources</a></li>
766
+ <li class=""><a href="/docs/resources/">Resources</a></li>
703
767
 
704
768
 
705
769
 
706
- <li class=""><a href="https://jekyllrb.com/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
770
+ <li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
707
771
 
708
772
 
709
773
 
710
- <li class=""><a href="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
774
+ <li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
711
775
 
712
776
  </ul>
713
777
 
@@ -717,15 +781,15 @@ run into these errors, try setting <code class="highlighter-rouge">excerpt_separ
717
781
 
718
782
 
719
783
 
720
- <li class=""><a href="https://jekyllrb.com/docs/contributing/">Contributing</a></li>
784
+ <li class=""><a href="/docs/contributing/">Contributing</a></li>
721
785
 
722
786
 
723
787
 
724
- <li class=""><a href="https://jekyllrb.com/docs/conduct/">Code of Conduct</a></li>
788
+ <li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
725
789
 
726
790
 
727
791
 
728
- <li class=""><a href="https://jekyllrb.com/docs/history/">History</a></li>
792
+ <li class=""><a href="/docs/history/">History</a></li>
729
793
 
730
794
  </ul>
731
795