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.
- checksums.yaml +4 -4
- data/site/404.html +2 -2
- data/site/community/index.html +4 -4
- data/site/css/screen.css +16 -8
- data/site/docs/assets/index.html +90 -79
- data/site/docs/collections/index.html +106 -84
- data/site/docs/conduct/index.html +70 -70
- data/site/docs/configuration/index.html +143 -93
- data/site/docs/continuous-integration/index.html +137 -95
- data/site/docs/contributing/index.html +70 -70
- data/site/docs/datafiles/index.html +116 -87
- data/site/docs/deployment-methods/index.html +108 -84
- data/site/docs/drafts/index.html +75 -72
- data/site/docs/extras/index.html +74 -71
- data/site/docs/frontmatter/index.html +82 -76
- data/site/docs/github-pages/index.html +88 -83
- data/site/docs/history/index.html +185 -74
- data/site/docs/home/index.html +70 -70
- data/site/docs/installation/index.html +94 -82
- data/site/docs/migrations/index.html +70 -70
- data/site/docs/pages/index.html +80 -74
- data/site/docs/pagination/index.html +91 -76
- data/site/docs/permalinks/index.html +70 -70
- data/site/docs/plugins/index.html +142 -96
- data/site/docs/posts/index.html +117 -87
- data/site/docs/quickstart/index.html +77 -73
- data/site/docs/resources/index.html +76 -71
- data/site/docs/sites/index.html +70 -70
- data/site/docs/static-files/index.html +88 -72
- data/site/docs/structure/index.html +79 -76
- data/site/docs/templates/index.html +210 -84
- data/site/docs/themes/index.html +106 -81
- data/site/docs/troubleshooting/index.html +155 -91
- data/site/docs/upgrading/0-to-2/index.html +74 -71
- data/site/docs/upgrading/2-to-3/index.html +99 -79
- data/site/docs/upgrading/index.html +70 -70
- data/site/docs/usage/index.html +95 -80
- data/site/docs/variables/index.html +71 -72
- data/site/docs/windows/index.html +89 -77
- data/site/feed.xml +111 -35
- data/site/help/index.html +2 -2
- data/site/index.html +3 -8
- data/site/latest_version.txt +1 -1
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +18 -6
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +18 -6
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +18 -6
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +18 -6
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +18 -6
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +18 -6
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +18 -6
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +18 -6
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +18 -6
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +18 -6
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +18 -6
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +18 -6
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +18 -6
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +18 -6
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +18 -6
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +18 -6
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +18 -6
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +18 -6
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +18 -6
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +18 -6
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +18 -6
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +18 -6
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +18 -6
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +18 -6
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +18 -6
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +18 -6
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +18 -6
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +18 -6
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +18 -6
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +18 -6
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +18 -6
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +18 -6
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +18 -6
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +18 -6
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +18 -6
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +18 -6
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +18 -6
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +18 -6
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +18 -6
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +18 -6
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +18 -6
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +18 -6
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +18 -6
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +18 -6
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +18 -6
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +18 -6
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +18 -6
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +18 -6
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +18 -6
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +18 -6
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +19 -7
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +18 -6
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +536 -0
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +615 -0
- data/site/news/index.html +172 -7
- data/site/news/releases/index.html +135 -7
- data/site/sitemap.xml +8 -0
- metadata +6 -5
- 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.
|
|
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-
|
|
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-
|
|
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.
|
|
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="
|
|
117
|
+
<option value="/docs/home/">Welcome</option>
|
|
118
118
|
|
|
119
119
|
|
|
120
120
|
|
|
121
|
-
<option value="
|
|
121
|
+
<option value="/docs/quickstart/">Quick-start guide</option>
|
|
122
122
|
|
|
123
123
|
|
|
124
124
|
|
|
125
|
-
<option value="
|
|
125
|
+
<option value="/docs/installation/">Installation</option>
|
|
126
126
|
|
|
127
127
|
|
|
128
128
|
|
|
129
|
-
<option value="
|
|
129
|
+
<option value="/docs/usage/">Basic Usage</option>
|
|
130
130
|
|
|
131
131
|
|
|
132
132
|
|
|
133
|
-
<option value="
|
|
133
|
+
<option value="/docs/structure/">Directory structure</option>
|
|
134
134
|
|
|
135
135
|
|
|
136
136
|
|
|
137
|
-
<option value="
|
|
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="
|
|
146
|
+
<option value="/docs/frontmatter/">Front Matter</option>
|
|
147
147
|
|
|
148
148
|
|
|
149
149
|
|
|
150
|
-
<option value="
|
|
150
|
+
<option value="/docs/posts/">Writing posts</option>
|
|
151
151
|
|
|
152
152
|
|
|
153
153
|
|
|
154
|
-
<option value="
|
|
154
|
+
<option value="/docs/drafts/">Working with drafts</option>
|
|
155
155
|
|
|
156
156
|
|
|
157
157
|
|
|
158
|
-
<option value="
|
|
158
|
+
<option value="/docs/pages/">Creating pages</option>
|
|
159
159
|
|
|
160
160
|
|
|
161
161
|
|
|
162
|
-
<option value="
|
|
162
|
+
<option value="/docs/static-files/">Static Files</option>
|
|
163
163
|
|
|
164
164
|
|
|
165
165
|
|
|
166
|
-
<option value="
|
|
166
|
+
<option value="/docs/variables/">Variables</option>
|
|
167
167
|
|
|
168
168
|
|
|
169
169
|
|
|
170
|
-
<option value="
|
|
170
|
+
<option value="/docs/collections/">Collections</option>
|
|
171
171
|
|
|
172
172
|
|
|
173
173
|
|
|
174
|
-
<option value="
|
|
174
|
+
<option value="/docs/datafiles/">Data Files</option>
|
|
175
175
|
|
|
176
176
|
|
|
177
177
|
|
|
178
|
-
<option value="
|
|
178
|
+
<option value="/docs/assets/">Assets</option>
|
|
179
179
|
|
|
180
180
|
|
|
181
181
|
|
|
182
|
-
<option value="
|
|
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="
|
|
191
|
+
<option value="/docs/templates/">Templates</option>
|
|
192
192
|
|
|
193
193
|
|
|
194
194
|
|
|
195
|
-
<option value="
|
|
195
|
+
<option value="/docs/permalinks/">Permalinks</option>
|
|
196
196
|
|
|
197
197
|
|
|
198
198
|
|
|
199
|
-
<option value="
|
|
199
|
+
<option value="/docs/pagination/">Pagination</option>
|
|
200
200
|
|
|
201
201
|
|
|
202
202
|
|
|
203
|
-
<option value="
|
|
203
|
+
<option value="/docs/plugins/">Plugins</option>
|
|
204
204
|
|
|
205
205
|
|
|
206
206
|
|
|
207
|
-
<option value="
|
|
207
|
+
<option value="/docs/themes/">Themes</option>
|
|
208
208
|
|
|
209
209
|
|
|
210
210
|
|
|
211
|
-
<option value="
|
|
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="
|
|
220
|
+
<option value="/docs/github-pages/">GitHub Pages</option>
|
|
221
221
|
|
|
222
222
|
|
|
223
223
|
|
|
224
|
-
<option value="
|
|
224
|
+
<option value="/docs/deployment-methods/">Deployment methods</option>
|
|
225
225
|
|
|
226
226
|
|
|
227
227
|
|
|
228
|
-
<option value="
|
|
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="
|
|
237
|
+
<option value="/docs/troubleshooting/">Troubleshooting</option>
|
|
238
238
|
|
|
239
239
|
|
|
240
240
|
|
|
241
|
-
<option value="
|
|
241
|
+
<option value="/docs/sites/">Sites using Jekyll</option>
|
|
242
242
|
|
|
243
243
|
|
|
244
244
|
|
|
245
|
-
<option value="
|
|
245
|
+
<option value="/docs/resources/">Resources</option>
|
|
246
246
|
|
|
247
247
|
|
|
248
248
|
|
|
249
|
-
<option value="
|
|
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="
|
|
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="
|
|
262
|
+
<option value="/docs/contributing/">Contributing</option>
|
|
263
263
|
|
|
264
264
|
|
|
265
265
|
|
|
266
|
-
<option value="
|
|
266
|
+
<option value="/docs/conduct/">Code of Conduct</option>
|
|
267
267
|
|
|
268
268
|
|
|
269
269
|
|
|
270
|
-
<option value="
|
|
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
|
-
<
|
|
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
|
-
<
|
|
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
|
-
<
|
|
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
|
-
<
|
|
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
|
|
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
|
-
<
|
|
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
|
|
344
|
+
<p>On macOS, you may need to update RubyGems (using <code class="highlighter-rouge">sudo</code> only if necessary):</p>
|
|
329
345
|
|
|
330
|
-
<
|
|
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
|
|
352
|
+
Tools (such as <code class="highlighter-rouge">gcc</code>) using the following command:</p>
|
|
334
353
|
|
|
335
|
-
<
|
|
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
|
-
<
|
|
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
|
|
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
|
-
<
|
|
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
|
-
<
|
|
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
|
-
<
|
|
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
|
-
<
|
|
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
|
-
<
|
|
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
|
-
<
|
|
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
|
-
<
|
|
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
|
-
<
|
|
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
|
-
<
|
|
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="
|
|
634
|
+
<li class=""><a href="/docs/home/">Welcome</a></li>
|
|
571
635
|
|
|
572
636
|
|
|
573
637
|
|
|
574
|
-
<li class=""><a href="
|
|
638
|
+
<li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
|
|
575
639
|
|
|
576
640
|
|
|
577
641
|
|
|
578
|
-
<li class=""><a href="
|
|
642
|
+
<li class=""><a href="/docs/installation/">Installation</a></li>
|
|
579
643
|
|
|
580
644
|
|
|
581
645
|
|
|
582
|
-
<li class=""><a href="
|
|
646
|
+
<li class=""><a href="/docs/usage/">Basic Usage</a></li>
|
|
583
647
|
|
|
584
648
|
|
|
585
649
|
|
|
586
|
-
<li class=""><a href="
|
|
650
|
+
<li class=""><a href="/docs/structure/">Directory structure</a></li>
|
|
587
651
|
|
|
588
652
|
|
|
589
653
|
|
|
590
|
-
<li class=""><a href="
|
|
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="
|
|
664
|
+
<li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
|
|
601
665
|
|
|
602
666
|
|
|
603
667
|
|
|
604
|
-
<li class=""><a href="
|
|
668
|
+
<li class=""><a href="/docs/posts/">Writing posts</a></li>
|
|
605
669
|
|
|
606
670
|
|
|
607
671
|
|
|
608
|
-
<li class=""><a href="
|
|
672
|
+
<li class=""><a href="/docs/drafts/">Working with drafts</a></li>
|
|
609
673
|
|
|
610
674
|
|
|
611
675
|
|
|
612
|
-
<li class=""><a href="
|
|
676
|
+
<li class=""><a href="/docs/pages/">Creating pages</a></li>
|
|
613
677
|
|
|
614
678
|
|
|
615
679
|
|
|
616
|
-
<li class=""><a href="
|
|
680
|
+
<li class=""><a href="/docs/static-files/">Static Files</a></li>
|
|
617
681
|
|
|
618
682
|
|
|
619
683
|
|
|
620
|
-
<li class=""><a href="
|
|
684
|
+
<li class=""><a href="/docs/variables/">Variables</a></li>
|
|
621
685
|
|
|
622
686
|
|
|
623
687
|
|
|
624
|
-
<li class=""><a href="
|
|
688
|
+
<li class=""><a href="/docs/collections/">Collections</a></li>
|
|
625
689
|
|
|
626
690
|
|
|
627
691
|
|
|
628
|
-
<li class=""><a href="
|
|
692
|
+
<li class=""><a href="/docs/datafiles/">Data Files</a></li>
|
|
629
693
|
|
|
630
694
|
|
|
631
695
|
|
|
632
|
-
<li class=""><a href="
|
|
696
|
+
<li class=""><a href="/docs/assets/">Assets</a></li>
|
|
633
697
|
|
|
634
698
|
|
|
635
699
|
|
|
636
|
-
<li class=""><a href="
|
|
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="
|
|
710
|
+
<li class=""><a href="/docs/templates/">Templates</a></li>
|
|
647
711
|
|
|
648
712
|
|
|
649
713
|
|
|
650
|
-
<li class=""><a href="
|
|
714
|
+
<li class=""><a href="/docs/permalinks/">Permalinks</a></li>
|
|
651
715
|
|
|
652
716
|
|
|
653
717
|
|
|
654
|
-
<li class=""><a href="
|
|
718
|
+
<li class=""><a href="/docs/pagination/">Pagination</a></li>
|
|
655
719
|
|
|
656
720
|
|
|
657
721
|
|
|
658
|
-
<li class=""><a href="
|
|
722
|
+
<li class=""><a href="/docs/plugins/">Plugins</a></li>
|
|
659
723
|
|
|
660
724
|
|
|
661
725
|
|
|
662
|
-
<li class=""><a href="
|
|
726
|
+
<li class=""><a href="/docs/themes/">Themes</a></li>
|
|
663
727
|
|
|
664
728
|
|
|
665
729
|
|
|
666
|
-
<li class=""><a href="
|
|
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="
|
|
740
|
+
<li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
|
|
677
741
|
|
|
678
742
|
|
|
679
743
|
|
|
680
|
-
<li class=""><a href="
|
|
744
|
+
<li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
|
|
681
745
|
|
|
682
746
|
|
|
683
747
|
|
|
684
|
-
<li class=""><a href="
|
|
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="
|
|
758
|
+
<li class="current"><a href="/docs/troubleshooting/">Troubleshooting</a></li>
|
|
695
759
|
|
|
696
760
|
|
|
697
761
|
|
|
698
|
-
<li class=""><a href="
|
|
762
|
+
<li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
|
|
699
763
|
|
|
700
764
|
|
|
701
765
|
|
|
702
|
-
<li class=""><a href="
|
|
766
|
+
<li class=""><a href="/docs/resources/">Resources</a></li>
|
|
703
767
|
|
|
704
768
|
|
|
705
769
|
|
|
706
|
-
<li class=""><a href="
|
|
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="
|
|
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="
|
|
784
|
+
<li class=""><a href="/docs/contributing/">Contributing</a></li>
|
|
721
785
|
|
|
722
786
|
|
|
723
787
|
|
|
724
|
-
<li class=""><a href="
|
|
788
|
+
<li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
|
|
725
789
|
|
|
726
790
|
|
|
727
791
|
|
|
728
|
-
<li class=""><a href="
|
|
792
|
+
<li class=""><a href="/docs/history/">History</a></li>
|
|
729
793
|
|
|
730
794
|
</ul>
|
|
731
795
|
|