jekyll-docs 3.5.2 → 3.6.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 +3 -3
- data/site/community/index.html +5 -5
- data/site/docs/assets/index.html +14 -22
- data/site/docs/code_of_conduct/index.html +730 -0
- data/site/docs/collections/index.html +65 -80
- data/site/docs/conduct/index.html +4 -4
- data/site/docs/configuration/index.html +130 -156
- data/site/docs/continuous-integration/buddyworks/index.html +14 -16
- data/site/docs/continuous-integration/circleci/index.html +13 -21
- data/site/docs/continuous-integration/index.html +5 -5
- data/site/docs/continuous-integration/travis-ci/index.html +45 -73
- data/site/docs/contributing/index.html +10 -10
- data/site/docs/datafiles/index.html +37 -53
- data/site/docs/deployment-methods/index.html +54 -64
- data/site/docs/drafts/index.html +6 -8
- data/site/docs/extras/index.html +8 -12
- data/site/docs/frontmatter/index.html +10 -14
- data/site/docs/github-pages/index.html +10 -14
- data/site/docs/history/index.html +539 -440
- data/site/docs/home/index.html +4 -4
- data/site/docs/includes/index.html +42 -70
- data/site/docs/installation/index.html +23 -37
- data/site/docs/maintaining/affinity-team-captain/index.html +4 -4
- data/site/docs/maintaining/avoiding-burnout/index.html +4 -4
- data/site/docs/maintaining/becoming-a-maintainer/index.html +4 -4
- data/site/docs/maintaining/index.html +4 -4
- data/site/docs/maintaining/merging-a-pull-request/index.html +6 -8
- data/site/docs/maintaining/reviewing-a-pull-request/index.html +4 -4
- data/site/docs/maintaining/special-labels/index.html +4 -4
- data/site/docs/maintaining/triaging-an-issue/index.html +4 -4
- data/site/docs/migrations/index.html +4 -4
- data/site/docs/pages/index.html +8 -12
- data/site/docs/pagination/index.html +13 -21
- data/site/docs/permalinks/index.html +43 -34
- data/site/docs/plugins/index.html +51 -79
- data/site/docs/posts/index.html +26 -48
- data/site/docs/quickstart/index.html +6 -8
- data/site/docs/resources/index.html +45 -21
- data/site/docs/sites/index.html +4 -4
- data/site/docs/static-files/index.html +12 -16
- data/site/docs/structure/index.html +6 -8
- data/site/docs/templates/index.html +36 -68
- data/site/docs/themes/index.html +32 -49
- data/site/docs/troubleshooting/index.html +44 -82
- data/site/docs/upgrading/0-to-2/index.html +7 -9
- data/site/docs/upgrading/2-to-3/index.html +19 -31
- data/site/docs/upgrading/index.html +4 -4
- data/site/docs/usage/index.html +20 -30
- data/site/docs/variables/index.html +26 -10
- data/site/docs/windows/index.html +36 -58
- data/site/feed.xml +47 -53
- data/site/help/index.html +3 -3
- data/site/index.html +3 -3
- data/site/latest_version.txt +1 -1
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +16 -8
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +16 -8
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +16 -8
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +16 -8
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +16 -8
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +16 -8
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +16 -8
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +16 -8
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +16 -8
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +16 -8
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +16 -8
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +16 -8
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +16 -8
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +16 -8
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +16 -8
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +16 -8
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +16 -8
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +16 -8
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +16 -8
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +16 -8
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +16 -8
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +16 -8
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +16 -8
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +16 -8
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +16 -8
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +16 -8
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +16 -8
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +16 -8
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +16 -8
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +16 -8
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +16 -8
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +16 -8
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +16 -8
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +17 -9
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +16 -8
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +16 -8
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +16 -8
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +16 -8
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +16 -8
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +16 -8
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +16 -8
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +16 -8
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +16 -8
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +20 -12
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +16 -8
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +16 -8
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +16 -8
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +16 -8
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +16 -8
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +16 -8
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +16 -8
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +16 -8
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +16 -8
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +16 -8
- data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +16 -8
- data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +16 -8
- data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +27 -29
- data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +23 -17
- data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +20 -14
- data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +21 -13
- data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +18 -10
- data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +573 -0
- data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +565 -0
- data/site/news/index.html +122 -48
- data/site/news/releases/index.html +122 -48
- data/site/sitemap.xml +64 -52
- data/site/tutorials/convert-site-to-jekyll/index.html +80 -138
- data/site/tutorials/custom-404-page/index.html +13 -21
- data/site/tutorials/home/index.html +4 -4
- data/site/tutorials/navigation/index.html +144 -180
- data/site/tutorials/orderofinterpretation/index.html +27 -45
- metadata +8 -5
data/site/docs/themes/index.html
CHANGED
|
@@ -4,13 +4,13 @@
|
|
|
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.6.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">
|
|
11
11
|
<link rel="stylesheet" href="/css/screen.css">
|
|
12
12
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
|
13
|
-
<!-- Begin Jekyll SEO tag v2.
|
|
13
|
+
<!-- Begin Jekyll SEO tag v2.3.0 -->
|
|
14
14
|
<title>Themes | Jekyll • Simple, blog-aware, static sites</title>
|
|
15
15
|
<meta property="og:title" content="Themes">
|
|
16
16
|
<meta property="og:locale" content="en_US">
|
|
@@ -20,12 +20,12 @@
|
|
|
20
20
|
<meta property="og:url" content="https://jekyllrb.com/docs/themes/">
|
|
21
21
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
|
|
22
22
|
<meta property="og:type" content="article">
|
|
23
|
-
<meta property="article:published_time" content="2017-
|
|
23
|
+
<meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
|
|
24
24
|
<meta name="twitter:card" content="summary">
|
|
25
25
|
<meta name="twitter:site" content="@jekyllrb">
|
|
26
26
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
|
|
27
27
|
<script type="application/ld+json">
|
|
28
|
-
{"
|
|
28
|
+
{"name":null,"description":"Jekyll has an extensive theme system that allows you to leverage community-maintained templates and styles to customize your site’s presentation. Jekyll themes package up layouts, includes, and stylesheets in a way that can be overridden by your site’s content.","url":"https://jekyllrb.com/docs/themes/","headline":"Themes","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/themes/"},"@context":"http://schema.org"}</script>
|
|
29
29
|
<!-- End Jekyll SEO tag -->
|
|
30
30
|
|
|
31
31
|
<!--[if lt IE 9]>
|
|
@@ -297,16 +297,14 @@
|
|
|
297
297
|
|
|
298
298
|
<p>In the case of Minima, you see only the following files in your Jekyll site directory:</p>
|
|
299
299
|
|
|
300
|
-
<div class="highlighter-rouge"
|
|
301
|
-
<pre class="highlight"><code>├── Gemfile
|
|
300
|
+
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>├── Gemfile
|
|
302
301
|
├── Gemfile.lock
|
|
303
302
|
├── _config.yml
|
|
304
303
|
├── _posts
|
|
305
304
|
│ └── 2016-12-04-welcome-to-jekyll.markdown
|
|
306
305
|
├── about.md
|
|
307
306
|
└── index.md
|
|
308
|
-
</code></pre>
|
|
309
|
-
</div>
|
|
307
|
+
</code></pre></div></div>
|
|
310
308
|
|
|
311
309
|
<p>The <code class="highlighter-rouge">Gemfile</code> and <code class="highlighter-rouge">Gemfile.lock</code> files are used by Bundler to keep track of the required gems and gem versions you need to build your Jekyll site.</p>
|
|
312
310
|
|
|
@@ -336,17 +334,16 @@
|
|
|
336
334
|
<p>Open the theme’s directory in Finder or Explorer:</p>
|
|
337
335
|
|
|
338
336
|
<div class="language-shell highlighter-rouge">
|
|
339
|
-
<pre class="highlight"><code><span class="c"># On MacOS</span>
|
|
337
|
+
<div class="highlight"><pre class="highlight"><code><span class="c"># On MacOS</span>
|
|
340
338
|
open <span class="k">$(</span>bundle show minima<span class="k">)</span>
|
|
341
339
|
<span class="c"># On Windows</span>
|
|
342
340
|
explorer /usr/local/lib/ruby/gems/2.3.0/gems/minima-2.1.0
|
|
343
|
-
</code></pre>
|
|
344
|
-
</div>
|
|
341
|
+
</code></pre></div> </div>
|
|
345
342
|
|
|
346
343
|
<p>A Finder or Explorer window opens showing the theme’s files and directories. The Minima theme gem contains these files:</p>
|
|
347
344
|
|
|
348
345
|
<div class="highlighter-rouge">
|
|
349
|
-
<pre class="highlight"><code> ├── LICENSE.txt
|
|
346
|
+
<div class="highlight"><pre class="highlight"><code> ├── LICENSE.txt
|
|
350
347
|
├── README.md
|
|
351
348
|
├── _includes
|
|
352
349
|
│ ├── disqus_comments.html
|
|
@@ -371,8 +368,7 @@ explorer /usr/local/lib/ruby/gems/2.3.0/gems/minima-2.1.0
|
|
|
371
368
|
│ └── minima.scss
|
|
372
369
|
└── assets
|
|
373
370
|
└── main.scss
|
|
374
|
-
</code></pre>
|
|
375
|
-
</div>
|
|
371
|
+
</code></pre></div> </div>
|
|
376
372
|
</li>
|
|
377
373
|
</ol>
|
|
378
374
|
|
|
@@ -423,33 +419,29 @@ explorer /usr/local/lib/ruby/gems/2.3.0/gems/minima-2.1.0
|
|
|
423
419
|
<p>Add the theme to your site’s <code class="highlighter-rouge">Gemfile</code>:</p>
|
|
424
420
|
|
|
425
421
|
<div class="language-sh highlighter-rouge">
|
|
426
|
-
<pre class="highlight"><code>gem <span class="s2">"jekyll-theme-awesome"</span>
|
|
427
|
-
</code></pre>
|
|
428
|
-
</div>
|
|
422
|
+
<div class="highlight"><pre class="highlight"><code>gem <span class="s2">"jekyll-theme-awesome"</span>
|
|
423
|
+
</code></pre></div> </div>
|
|
429
424
|
</li>
|
|
430
425
|
<li>
|
|
431
426
|
<p>Install the theme:</p>
|
|
432
427
|
|
|
433
428
|
<div class="language-sh highlighter-rouge">
|
|
434
|
-
<pre class="highlight"><code>bundle install
|
|
435
|
-
</code></pre>
|
|
436
|
-
</div>
|
|
429
|
+
<div class="highlight"><pre class="highlight"><code>bundle install
|
|
430
|
+
</code></pre></div> </div>
|
|
437
431
|
</li>
|
|
438
432
|
<li>
|
|
439
433
|
<p>Add the following to your site’s <code class="highlighter-rouge">_config.yml</code> to activate the theme:</p>
|
|
440
434
|
|
|
441
435
|
<div class="language-sh highlighter-rouge">
|
|
442
|
-
<pre class="highlight"><code>theme: jekyll-theme-awesome
|
|
443
|
-
</code></pre>
|
|
444
|
-
</div>
|
|
436
|
+
<div class="highlight"><pre class="highlight"><code>theme: jekyll-theme-awesome
|
|
437
|
+
</code></pre></div> </div>
|
|
445
438
|
</li>
|
|
446
439
|
<li>
|
|
447
440
|
<p>Build your site:</p>
|
|
448
441
|
|
|
449
442
|
<div class="language-sh highlighter-rouge">
|
|
450
|
-
<pre class="highlight"><code>bundle <span class="nb">exec </span>jekyll serve
|
|
451
|
-
</code></pre>
|
|
452
|
-
</div>
|
|
443
|
+
<div class="highlight"><pre class="highlight"><code>bundle <span class="nb">exec </span>jekyll serve
|
|
444
|
+
</code></pre></div> </div>
|
|
453
445
|
</li>
|
|
454
446
|
</ol>
|
|
455
447
|
|
|
@@ -465,8 +457,7 @@ explorer /usr/local/lib/ruby/gems/2.3.0/gems/minima-2.1.0
|
|
|
465
457
|
|
|
466
458
|
<p>Here is an example:</p>
|
|
467
459
|
|
|
468
|
-
<div class="language-sh highlighter-rouge">
|
|
469
|
-
<pre class="highlight"><code>jekyll new-theme jekyll-theme-awesome
|
|
460
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jekyll new-theme jekyll-theme-awesome
|
|
470
461
|
create /path/to/jekyll-theme-awesome/_layouts
|
|
471
462
|
create /path/to/jekyll-theme-awesome/_includes
|
|
472
463
|
create /path/to/jekyll-theme-awesome/_sass
|
|
@@ -481,8 +472,7 @@ explorer /usr/local/lib/ruby/gems/2.3.0/gems/minima-2.1.0
|
|
|
481
472
|
create /path/to/jekyll-theme-awesome/.gitignore
|
|
482
473
|
Your new Jekyll theme, jekyll-theme-awesome, is ready <span class="k">for </span>you <span class="k">in</span> /path/to/jekyll-theme-awesome!
|
|
483
474
|
For <span class="nb">help </span>getting started, <span class="nb">read</span> /path/to/jekyll-theme-awesome/README.md.
|
|
484
|
-
</code></pre>
|
|
485
|
-
</div>
|
|
475
|
+
</code></pre></div></div>
|
|
486
476
|
|
|
487
477
|
<p>Add your template files in the corresponding folders. Then complete the <code class="highlighter-rouge">.gemspec</code> and the README files according to your needs.</p>
|
|
488
478
|
|
|
@@ -509,18 +499,14 @@ For <span class="nb">help </span>getting started, <span class="nb">read</span> /
|
|
|
509
499
|
|
|
510
500
|
<p>Your theme’s stylesheets should be placed in your theme’s <code class="highlighter-rouge">_sass</code> folder, again, just as you would when authoring a Jekyll site.</p>
|
|
511
501
|
|
|
512
|
-
<div class="highlighter-rouge">
|
|
513
|
-
<pre class="highlight"><code>_sass
|
|
502
|
+
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>_sass
|
|
514
503
|
├── jekyll-theme-awesome.scss
|
|
515
|
-
</code></pre>
|
|
516
|
-
</div>
|
|
504
|
+
</code></pre></div></div>
|
|
517
505
|
|
|
518
506
|
<p>Your theme’s styles can be included in the user’s stylesheet using the <code class="highlighter-rouge">@import</code> directive.</p>
|
|
519
507
|
|
|
520
|
-
<div class="language-css highlighter-rouge">
|
|
521
|
-
|
|
522
|
-
</code></pre>
|
|
523
|
-
</div>
|
|
508
|
+
<div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">@import</span> <span class="s1">"{{ site.theme }}"</span><span class="p">;</span>
|
|
509
|
+
</code></pre></div></div>
|
|
524
510
|
|
|
525
511
|
<h3 id="theme-gem-dependencies">Theme-gem dependencies</h3>
|
|
526
512
|
|
|
@@ -551,27 +537,24 @@ For <span class="nb">help </span>getting started, <span class="nb">read</span> /
|
|
|
551
537
|
<p>First, you need to have it in a git repository:</p>
|
|
552
538
|
|
|
553
539
|
<div class="language-sh highlighter-rouge">
|
|
554
|
-
<pre class="highlight"><code>git init <span class="c"># Only the first time</span>
|
|
555
|
-
git add
|
|
556
|
-
git commit
|
|
557
|
-
</code></pre>
|
|
558
|
-
</div>
|
|
540
|
+
<div class="highlight"><pre class="highlight"><code>git init <span class="c"># Only the first time</span>
|
|
541
|
+
git add <span class="nt">-A</span>
|
|
542
|
+
git commit <span class="nt">-m</span> <span class="s2">"Init commit"</span>
|
|
543
|
+
</code></pre></div> </div>
|
|
559
544
|
</li>
|
|
560
545
|
<li>
|
|
561
546
|
<p>Next, package your theme, by running the following command, replacing <code class="highlighter-rouge">jekyll-theme-awesome</code> with the name of your theme:</p>
|
|
562
547
|
|
|
563
548
|
<div class="language-sh highlighter-rouge">
|
|
564
|
-
<pre class="highlight"><code>gem build jekyll-theme-awesome.gemspec
|
|
565
|
-
</code></pre>
|
|
566
|
-
</div>
|
|
549
|
+
<div class="highlight"><pre class="highlight"><code>gem build jekyll-theme-awesome.gemspec
|
|
550
|
+
</code></pre></div> </div>
|
|
567
551
|
</li>
|
|
568
552
|
<li>
|
|
569
553
|
<p>Finally, push your packaged theme up to the RubyGems service, by running the following command, again replacing <code class="highlighter-rouge">jekyll-theme-awesome</code> with the name of your theme:</p>
|
|
570
554
|
|
|
571
555
|
<div class="language-sh highlighter-rouge">
|
|
572
|
-
<pre class="highlight"><code>gem push jekyll-theme-awesome-<span class="k">*</span>.gem
|
|
573
|
-
</code></pre>
|
|
574
|
-
</div>
|
|
556
|
+
<div class="highlight"><pre class="highlight"><code>gem push jekyll-theme-awesome-<span class="k">*</span>.gem
|
|
557
|
+
</code></pre></div> </div>
|
|
575
558
|
</li>
|
|
576
559
|
<li>
|
|
577
560
|
<p>To release a new version of your theme, update the version number in the gemspec file, ( <code class="highlighter-rouge">jekyll-theme-awesome.gemspec</code> in this example ), and then repeat Steps 1 - 3 above. We recommend that you follow <a href="http://semver.org/">Semantic Versioning</a> while bumping your theme-version.</p>
|
|
@@ -4,13 +4,13 @@
|
|
|
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.6.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">
|
|
11
11
|
<link rel="stylesheet" href="/css/screen.css">
|
|
12
12
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
|
13
|
-
<!-- Begin Jekyll SEO tag v2.
|
|
13
|
+
<!-- Begin Jekyll SEO tag v2.3.0 -->
|
|
14
14
|
<title>Troubleshooting | Jekyll • Simple, blog-aware, static sites</title>
|
|
15
15
|
<meta property="og:title" content="Troubleshooting">
|
|
16
16
|
<meta property="og:locale" content="en_US">
|
|
@@ -20,12 +20,12 @@
|
|
|
20
20
|
<meta property="og:url" content="https://jekyllrb.com/docs/troubleshooting/">
|
|
21
21
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
|
|
22
22
|
<meta property="og:type" content="article">
|
|
23
|
-
<meta property="article:published_time" content="2017-
|
|
23
|
+
<meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
|
|
24
24
|
<meta name="twitter:card" content="summary">
|
|
25
25
|
<meta name="twitter:site" content="@jekyllrb">
|
|
26
26
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
|
|
27
27
|
<script type="application/ld+json">
|
|
28
|
-
{"
|
|
28
|
+
{"name":null,"description":"If you ever run into problems installing or using Jekyll, here are a few tips that might be of help. If the problem you’re experiencing isn’t covered below, please check out our other help resources as well.","url":"https://jekyllrb.com/docs/troubleshooting/","headline":"Troubleshooting","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/troubleshooting/"},"@context":"http://schema.org"}</script>
|
|
29
29
|
<!-- End Jekyll SEO tag -->
|
|
30
30
|
|
|
31
31
|
<!--[if lt IE 9]>
|
|
@@ -306,24 +306,18 @@ that might be of help. If the problem you’re experiencing isn’t covered belo
|
|
|
306
306
|
the header files for compiling extension modules for Ruby 2.x This
|
|
307
307
|
can be done on Ubuntu or Debian by running:</p>
|
|
308
308
|
|
|
309
|
-
<div class="language-sh highlighter-rouge">
|
|
310
|
-
|
|
311
|
-
</code></pre>
|
|
312
|
-
</div>
|
|
309
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>apt-get install ruby2.3-dev
|
|
310
|
+
</code></pre></div></div>
|
|
313
311
|
|
|
314
312
|
<p>On Red Hat, CentOS, and Fedora systems you can do this by running:</p>
|
|
315
313
|
|
|
316
|
-
<div class="language-sh highlighter-rouge">
|
|
317
|
-
|
|
318
|
-
</code></pre>
|
|
319
|
-
</div>
|
|
314
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>yum install ruby-devel
|
|
315
|
+
</code></pre></div></div>
|
|
320
316
|
|
|
321
317
|
<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>
|
|
322
318
|
|
|
323
|
-
<div class="language-sh highlighter-rouge">
|
|
324
|
-
|
|
325
|
-
</code></pre>
|
|
326
|
-
</div>
|
|
319
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>dnf install redhat-rpm-config
|
|
320
|
+
</code></pre></div></div>
|
|
327
321
|
|
|
328
322
|
<p>On Ubuntu if you get stuck after <code class="highlighter-rouge">bundle exec jekyll serve</code> and see error
|
|
329
323
|
messages like <code class="highlighter-rouge">Could not locate Gemfile</code> or <code class="highlighter-rouge">.bundle/ directory</code>, it’s likely
|
|
@@ -331,61 +325,47 @@ because all requirements have not been fully met. Recent stock Ubuntu
|
|
|
331
325
|
distributions require the installation of both the <code class="highlighter-rouge">ruby</code> and <code class="highlighter-rouge">ruby-all-dev</code>
|
|
332
326
|
packages:</p>
|
|
333
327
|
|
|
334
|
-
<div class="language-sh highlighter-rouge">
|
|
335
|
-
|
|
336
|
-
</code></pre>
|
|
337
|
-
</div>
|
|
328
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>apt-get install ruby ruby-all-dev
|
|
329
|
+
</code></pre></div></div>
|
|
338
330
|
|
|
339
331
|
<p>On <a href="https://www.nearlyfreespeech.net/">NearlyFreeSpeech</a> you need to run the
|
|
340
332
|
following commands before installing Jekyll:</p>
|
|
341
333
|
|
|
342
|
-
<div class="language-sh highlighter-rouge">
|
|
343
|
-
<pre class="highlight"><code><span class="nb">export </span><span class="nv">GEM_HOME</span><span class="o">=</span>/home/private/gems
|
|
334
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">export </span><span class="nv">GEM_HOME</span><span class="o">=</span>/home/private/gems
|
|
344
335
|
<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/
|
|
345
336
|
<span class="nb">export </span><span class="nv">PATH</span><span class="o">=</span><span class="nv">$PATH</span>:/home/private/gems/bin
|
|
346
337
|
<span class="nb">export </span><span class="nv">RB_USER_INSTALL</span><span class="o">=</span><span class="s1">'true'</span>
|
|
347
|
-
</code></pre>
|
|
348
|
-
</div>
|
|
338
|
+
</code></pre></div></div>
|
|
349
339
|
|
|
350
340
|
<p>To install RubyGems on Gentoo:</p>
|
|
351
341
|
|
|
352
|
-
<div class="language-sh highlighter-rouge">
|
|
353
|
-
|
|
354
|
-
</code></pre>
|
|
355
|
-
</div>
|
|
342
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>emerge <span class="nt">-av</span> dev-ruby/rubygems
|
|
343
|
+
</code></pre></div></div>
|
|
356
344
|
|
|
357
345
|
<p>On Windows, you may need to install <a href="https://wiki.github.com/oneclick/rubyinstaller/development-kit">RubyInstaller
|
|
358
346
|
DevKit</a>.</p>
|
|
359
347
|
|
|
360
348
|
<p>On Android (with Termux) you can install all requirements by running:</p>
|
|
361
349
|
|
|
362
|
-
<div class="language-sh highlighter-rouge">
|
|
363
|
-
|
|
364
|
-
</code></pre>
|
|
365
|
-
</div>
|
|
350
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>apt update <span class="o">&&</span> apt install libffi-dev clang ruby-dev make
|
|
351
|
+
</code></pre></div></div>
|
|
366
352
|
|
|
367
353
|
<p>On macOS, you may need to update RubyGems (using <code class="highlighter-rouge">sudo</code> only if necessary):</p>
|
|
368
354
|
|
|
369
|
-
<div class="language-sh highlighter-rouge">
|
|
370
|
-
|
|
371
|
-
</code></pre>
|
|
372
|
-
</div>
|
|
355
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>gem update <span class="nt">--system</span>
|
|
356
|
+
</code></pre></div></div>
|
|
373
357
|
|
|
374
358
|
<p>If you still have issues, you can download and install new Command Line
|
|
375
359
|
Tools (such as <code class="highlighter-rouge">gcc</code>) using the following command:</p>
|
|
376
360
|
|
|
377
|
-
<div class="language-sh highlighter-rouge">
|
|
378
|
-
|
|
379
|
-
</code></pre>
|
|
380
|
-
</div>
|
|
361
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>xcode-select <span class="nt">--install</span>
|
|
362
|
+
</code></pre></div></div>
|
|
381
363
|
|
|
382
364
|
<p>which may allow you to install native gems using this command (again using
|
|
383
365
|
<code class="highlighter-rouge">sudo</code> only if necessary):</p>
|
|
384
366
|
|
|
385
|
-
<div class="language-sh highlighter-rouge">
|
|
386
|
-
|
|
387
|
-
</code></pre>
|
|
388
|
-
</div>
|
|
367
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>gem install jekyll
|
|
368
|
+
</code></pre></div></div>
|
|
389
369
|
|
|
390
370
|
<p>Note that upgrading macOS does not automatically upgrade Xcode itself
|
|
391
371
|
(that can be done separately via the App Store), and having an out-of-date
|
|
@@ -401,25 +381,19 @@ longer available. Given these changes, there are a couple of simple ways to get
|
|
|
401
381
|
up and running. One option is to change the location where the gem will be
|
|
402
382
|
installed (again using <code class="highlighter-rouge">sudo</code> only if necessary):</p>
|
|
403
383
|
|
|
404
|
-
<div class="language-sh highlighter-rouge">
|
|
405
|
-
|
|
406
|
-
</code></pre>
|
|
407
|
-
</div>
|
|
384
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>gem install <span class="nt">-n</span> /usr/local/bin jekyll
|
|
385
|
+
</code></pre></div></div>
|
|
408
386
|
|
|
409
387
|
<p>Alternatively, Homebrew can be installed and used to set up Ruby. This can be
|
|
410
388
|
done as follows:</p>
|
|
411
389
|
|
|
412
|
-
<div class="language-sh highlighter-rouge">
|
|
413
|
-
|
|
414
|
-
</code></pre>
|
|
415
|
-
</div>
|
|
390
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ruby <span class="nt">-e</span> <span class="s2">"</span><span class="k">$(</span>curl <span class="nt">-fsSL</span> https://raw.githubusercontent.com/Homebrew/install/master/install<span class="k">)</span><span class="s2">"</span>
|
|
391
|
+
</code></pre></div></div>
|
|
416
392
|
|
|
417
393
|
<p>Once Homebrew is installed, the second step is easy:</p>
|
|
418
394
|
|
|
419
|
-
<div class="language-sh highlighter-rouge">
|
|
420
|
-
|
|
421
|
-
</code></pre>
|
|
422
|
-
</div>
|
|
395
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>brew install ruby
|
|
396
|
+
</code></pre></div></div>
|
|
423
397
|
|
|
424
398
|
<p>Advanced users (with more complex needs) may find it helpful to choose one of a
|
|
425
399
|
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
|
|
@@ -428,17 +402,13 @@ which to install Jekyll.</p>
|
|
|
428
402
|
<p>If you elect to use one of the above methods to install Ruby, it might be
|
|
429
403
|
necessary to modify your <code class="highlighter-rouge">$PATH</code> variable using the following command:</p>
|
|
430
404
|
|
|
431
|
-
<div class="language-sh highlighter-rouge">
|
|
432
|
-
|
|
433
|
-
</code></pre>
|
|
434
|
-
</div>
|
|
405
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><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>
|
|
406
|
+
</code></pre></div></div>
|
|
435
407
|
|
|
436
408
|
<p>GUI apps can modify the <code class="highlighter-rouge">$PATH</code> as follows:</p>
|
|
437
409
|
|
|
438
|
-
<div class="language-sh highlighter-rouge">
|
|
439
|
-
|
|
440
|
-
</code></pre>
|
|
441
|
-
</div>
|
|
410
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>launchctl setenv PATH <span class="s2">"/usr/local/bin:</span><span class="nv">$PATH</span><span class="s2">"</span>
|
|
411
|
+
</code></pre></div></div>
|
|
442
412
|
|
|
443
413
|
<p>Either of these approaches are useful because <code class="highlighter-rouge">/usr/local</code> is considered a
|
|
444
414
|
“safe” location on systems which have SIP enabled, they avoid potential
|
|
@@ -462,24 +432,18 @@ in order to have the <code class="highlighter-rouge">jekyll</code> executable be
|
|
|
462
432
|
|
|
463
433
|
<p>If you are using base-url option like:</p>
|
|
464
434
|
|
|
465
|
-
<div class="language-sh highlighter-rouge">
|
|
466
|
-
|
|
467
|
-
</code></pre>
|
|
468
|
-
</div>
|
|
435
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jekyll serve <span class="nt">--baseurl</span> <span class="s1">'/blog'</span>
|
|
436
|
+
</code></pre></div></div>
|
|
469
437
|
|
|
470
438
|
<p>… then make sure that you access the site at:</p>
|
|
471
439
|
|
|
472
|
-
<div class="language-sh highlighter-rouge">
|
|
473
|
-
|
|
474
|
-
</code></pre>
|
|
475
|
-
</div>
|
|
440
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:4000/blog/index.html
|
|
441
|
+
</code></pre></div></div>
|
|
476
442
|
|
|
477
443
|
<p>It won’t work to just access:</p>
|
|
478
444
|
|
|
479
|
-
<div class="language-sh highlighter-rouge">
|
|
480
|
-
|
|
481
|
-
</code></pre>
|
|
482
|
-
</div>
|
|
445
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:4000/blog
|
|
446
|
+
</code></pre></div></div>
|
|
483
447
|
|
|
484
448
|
<h2 id="configuration-problems">Configuration problems</h2>
|
|
485
449
|
|
|
@@ -509,14 +473,12 @@ problems.</p>
|
|
|
509
473
|
|
|
510
474
|
<h3 id="liquid">Liquid</h3>
|
|
511
475
|
|
|
512
|
-
<p>The latest version, version 2.0, seems to break the use of <code class="highlighter-rouge"
|
|
513
|
-
templates. Unlike previous versions, using <code class="highlighter-rouge"
|
|
476
|
+
<p>The latest version, version 2.0, seems to break the use of <code class="highlighter-rouge">{{</code> in
|
|
477
|
+
templates. Unlike previous versions, using <code class="highlighter-rouge">{{</code> in 2.0 triggers the
|
|
514
478
|
following error:</p>
|
|
515
479
|
|
|
516
|
-
<div class="language-sh highlighter-rouge">
|
|
517
|
-
|
|
518
|
-
</code></pre>
|
|
519
|
-
</div>
|
|
480
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><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>
|
|
481
|
+
</code></pre></div></div>
|
|
520
482
|
|
|
521
483
|
<h3 id="excerpts">Excerpts</h3>
|
|
522
484
|
|
|
@@ -4,13 +4,13 @@
|
|
|
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.6.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">
|
|
11
11
|
<link rel="stylesheet" href="/css/screen.css">
|
|
12
12
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
|
13
|
-
<!-- Begin Jekyll SEO tag v2.
|
|
13
|
+
<!-- Begin Jekyll SEO tag v2.3.0 -->
|
|
14
14
|
<title>Upgrading from 0.x to 2.x | Jekyll • Simple, blog-aware, static sites</title>
|
|
15
15
|
<meta property="og:title" content="Upgrading from 0.x to 2.x">
|
|
16
16
|
<meta property="og:locale" content="en_US">
|
|
@@ -20,12 +20,12 @@
|
|
|
20
20
|
<meta property="og:url" content="https://jekyllrb.com/docs/upgrading/0-to-2/">
|
|
21
21
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
|
|
22
22
|
<meta property="og:type" content="article">
|
|
23
|
-
<meta property="article:published_time" content="2017-
|
|
23
|
+
<meta property="article:published_time" content="2017-10-24T08:07:43-07:00">
|
|
24
24
|
<meta name="twitter:card" content="summary">
|
|
25
25
|
<meta name="twitter:site" content="@jekyllrb">
|
|
26
26
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
|
|
27
27
|
<script type="application/ld+json">
|
|
28
|
-
{"
|
|
28
|
+
{"name":null,"description":"Upgrading from an older version of Jekyll? A few things have changed in 1.0 and 2.0 that you’ll want to know about.","url":"https://jekyllrb.com/docs/upgrading/0-to-2/","headline":"Upgrading from 0.x to 2.x","dateModified":"2017-10-24T08:07:43-07:00","datePublished":"2017-10-24T08:07:43-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/upgrading/0-to-2/"},"@context":"http://schema.org"}</script>
|
|
29
29
|
<!-- End Jekyll SEO tag -->
|
|
30
30
|
|
|
31
31
|
<!--[if lt IE 9]>
|
|
@@ -292,10 +292,8 @@ and 2.0 that you’ll want to know about.</p>
|
|
|
292
292
|
|
|
293
293
|
<p>Before we dive in, go ahead and fetch the latest version of Jekyll:</p>
|
|
294
294
|
|
|
295
|
-
<div class="language-sh highlighter-rouge">
|
|
296
|
-
|
|
297
|
-
</code></pre>
|
|
298
|
-
</div>
|
|
295
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>gem update jekyll
|
|
296
|
+
</code></pre></div></div>
|
|
299
297
|
|
|
300
298
|
<div class="note feature">
|
|
301
299
|
<h5>Diving in</h5>
|
|
@@ -413,7 +411,7 @@ such as previewing locally before pushing to GitHub Pages. Jekyll 1.0 makes
|
|
|
413
411
|
that easier with the new <code class="highlighter-rouge">--baseurl</code> flag. To take advantage of this
|
|
414
412
|
feature, first add the production <code class="highlighter-rouge">baseurl</code> to your site’s <code class="highlighter-rouge">_config.yml</code>
|
|
415
413
|
file. Then, throughout the site, simply prefix relative URLs
|
|
416
|
-
with <code class="highlighter-rouge"
|
|
414
|
+
with <code class="highlighter-rouge">{{ site.baseurl }}</code>.
|
|
417
415
|
When you’re ready to preview your site locally, pass along the <code class="highlighter-rouge">--baseurl</code>
|
|
418
416
|
flag with your local baseurl (most likely <code class="highlighter-rouge">/</code>) to <code class="highlighter-rouge">jekyll serve</code> and Jekyll
|
|
419
417
|
will swap in whatever you’ve passed along, ensuring all your links work as
|