jekyll-docs 3.5.2 → 3.6.0
Sign up to get free protection for your applications and to get access to all the features.
- 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
|