jekyll-docs 3.9.0 → 4.0.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/lib/jekyll-docs.rb +3 -3
- data/site/404.html +10 -7
- data/site/css/screen.css +3 -1
- data/site/css/screen.css.map +28 -0
- data/site/docs/assets/index.html +412 -453
- data/site/docs/code_of_conduct/index.html +447 -501
- data/site/docs/collections/index.html +487 -674
- data/site/docs/community/bug/index.html +603 -0
- data/site/docs/community/index.html +635 -0
- data/site/docs/conduct/index.html +447 -515
- data/site/docs/configuration/default/index.html +682 -0
- data/site/docs/configuration/environments/index.html +641 -0
- data/site/docs/configuration/front-matter-defaults/index.html +738 -0
- data/site/docs/configuration/incremental-regeneration/index.html +631 -0
- data/site/docs/configuration/index.html +405 -1230
- data/site/docs/configuration/liquid/index.html +616 -0
- data/site/docs/configuration/markdown/index.html +766 -0
- data/site/docs/configuration/options/index.html +1011 -0
- data/site/docs/configuration/webrick/index.html +615 -0
- data/site/docs/continuous-integration/buddyworks/index.html +393 -479
- data/site/docs/continuous-integration/circleci/index.html +465 -481
- data/site/docs/continuous-integration/travis-ci/index.html +450 -507
- data/site/docs/contributing/index.html +425 -514
- data/site/docs/datafiles/index.html +411 -453
- data/site/docs/deployment-methods/index.html +9 -871
- data/site/docs/deployment/automated/index.html +663 -0
- data/site/docs/deployment/index.html +607 -0
- data/site/docs/deployment/manual/index.html +631 -0
- data/site/docs/deployment/third-party/index.html +639 -0
- data/site/docs/drafts/index.html +9 -634
- data/site/docs/extras/index.html +9 -687
- data/site/docs/front-matter/index.html +799 -0
- data/site/docs/frontmatter/index.html +9 -819
- data/site/docs/github-pages/index.html +407 -475
- data/site/docs/history/index.html +1370 -1154
- data/site/docs/home/index.html +9 -627
- data/site/docs/includes/index.html +425 -501
- data/site/docs/index.html +630 -9
- data/site/docs/installation/index.html +403 -540
- data/site/docs/installation/macos/index.html +716 -0
- data/site/docs/installation/other-linux/index.html +613 -0
- data/site/docs/installation/ubuntu/index.html +623 -0
- data/site/docs/installation/windows/index.html +733 -0
- data/site/docs/layouts/index.html +726 -0
- data/site/docs/liquid/filters/index.html +1169 -0
- data/site/docs/liquid/index.html +615 -0
- data/site/docs/liquid/tags/index.html +728 -0
- data/site/docs/maintaining/affinity-team-captain/index.html +395 -479
- data/site/docs/maintaining/avoiding-burnout/index.html +391 -475
- data/site/docs/maintaining/becoming-a-maintainer/index.html +391 -475
- data/site/docs/maintaining/index.html +391 -486
- data/site/docs/maintaining/merging-a-pull-request/index.html +406 -490
- data/site/docs/maintaining/releasing-a-new-version/index.html +409 -485
- data/site/docs/maintaining/reviewing-a-pull-request/index.html +392 -476
- data/site/docs/maintaining/special-labels/index.html +397 -481
- data/site/docs/maintaining/triaging-an-issue/index.html +394 -478
- data/site/docs/markdown-101/index.html +601 -0
- data/site/docs/migrations/index.html +396 -440
- data/site/docs/pages/index.html +408 -482
- data/site/docs/pagination/index.html +450 -509
- data/site/docs/permalinks/index.html +552 -587
- data/site/docs/plugins/commands/index.html +656 -0
- data/site/docs/plugins/converters/index.html +685 -0
- data/site/docs/plugins/filters/index.html +624 -0
- data/site/docs/plugins/generators/index.html +697 -0
- data/site/docs/plugins/hooks/index.html +838 -0
- data/site/docs/plugins/index.html +415 -1565
- data/site/docs/plugins/installation/index.html +681 -0
- data/site/docs/plugins/tags/index.html +699 -0
- data/site/docs/plugins/your-first-plugin/index.html +741 -0
- data/site/docs/posts/index.html +491 -627
- data/site/docs/quickstart/index.html +9 -645
- data/site/docs/resources/index.html +9 -761
- data/site/docs/ruby-101/index.html +640 -0
- data/site/docs/sites/index.html +9 -696
- data/site/docs/static-files/index.html +401 -433
- data/site/docs/step-by-step/01-setup/index.html +771 -0
- data/site/docs/step-by-step/02-liquid/index.html +756 -0
- data/site/docs/step-by-step/03-front-matter/index.html +730 -0
- data/site/docs/step-by-step/04-layouts/index.html +770 -0
- data/site/docs/step-by-step/05-includes/index.html +768 -0
- data/site/docs/step-by-step/06-data-files/index.html +738 -0
- data/site/docs/step-by-step/07-assets/index.html +773 -0
- data/site/docs/step-by-step/08-blogging/index.html +835 -0
- data/site/docs/step-by-step/09-collections/index.html +932 -0
- data/site/docs/step-by-step/10-deployment/index.html +842 -0
- data/site/docs/structure/index.html +411 -430
- data/site/docs/support/index.html +392 -476
- data/site/docs/templates/index.html +9 -1232
- data/site/docs/themes/index.html +487 -521
- data/site/docs/troubleshooting/index.html +443 -520
- data/site/docs/upgrading/0-to-2/index.html +437 -523
- data/site/docs/upgrading/2-to-3/index.html +422 -507
- data/site/docs/upgrading/3-to-4/index.html +765 -0
- data/site/docs/upgrading/index.html +395 -478
- data/site/docs/usage/index.html +409 -506
- data/site/docs/variables/index.html +504 -652
- data/site/docs/windows/index.html +9 -784
- data/site/feed.xml +269 -188
- data/site/feed/release.xml +324 -0
- data/site/fonts/lato-v14-latin-300.woff +0 -0
- data/site/fonts/lato-v14-latin-300.woff2 +0 -0
- data/site/fonts/lato-v14-latin-300italic.woff +0 -0
- data/site/fonts/lato-v14-latin-300italic.woff2 +0 -0
- data/site/fonts/lato-v14-latin-700.woff +0 -0
- data/site/fonts/lato-v14-latin-700.woff2 +0 -0
- data/site/fonts/lato-v14-latin-700italic.woff +0 -0
- data/site/fonts/lato-v14-latin-700italic.woff2 +0 -0
- data/site/fonts/lato-v14-latin-900.woff +0 -0
- data/site/fonts/lato-v14-latin-900.woff2 +0 -0
- data/site/fonts/lato-v14-latin-900italic.woff +0 -0
- data/site/fonts/lato-v14-latin-900italic.woff2 +0 -0
- data/site/fonts/lato-v14-latin-italic.woff +0 -0
- data/site/fonts/lato-v14-latin-italic.woff2 +0 -0
- data/site/fonts/lato-v14-latin-regular.woff +0 -0
- data/site/fonts/lato-v14-latin-regular.woff2 +0 -0
- data/site/help/index.html +9 -247
- data/site/img/forestry-logo.svg +19 -0
- data/site/img/jekyll-og.png +0 -0
- data/site/img/spacer.gif +0 -0
- data/site/index.html +56 -29
- data/site/jekyllconf/index.html +62 -35
- data/site/latest_version.txt +1 -1
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +180 -115
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +182 -117
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +183 -118
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +184 -119
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +183 -118
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +180 -115
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +182 -117
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +182 -117
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +185 -120
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +183 -118
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +180 -115
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +189 -124
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +181 -116
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +181 -116
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +180 -115
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +182 -117
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +181 -116
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +181 -116
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +181 -116
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +184 -119
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +180 -115
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +181 -116
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +185 -120
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +182 -117
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +181 -116
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +189 -124
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +187 -122
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +188 -123
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +180 -115
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +182 -117
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +179 -114
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +180 -115
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +179 -114
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +180 -115
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +180 -115
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +185 -120
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +184 -119
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +182 -117
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +186 -121
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +183 -118
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +181 -116
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +182 -117
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +179 -114
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +181 -116
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +181 -116
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +180 -115
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +186 -121
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +181 -116
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +181 -116
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +179 -114
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +184 -119
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +180 -115
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +179 -114
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +207 -142
- data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +181 -116
- data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +183 -118
- data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +181 -116
- data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +189 -124
- data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +190 -125
- data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +187 -122
- data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +182 -117
- data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +185 -120
- data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +181 -116
- data/site/news/2017/10/19/diversity-open-source/index.html +181 -116
- data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +183 -118
- data/site/news/2018/01/02/jekyll-3-7-0-released/index.html +184 -119
- data/site/news/2018/01/25/jekyll-3-7-2-released/index.html +189 -124
- data/site/news/2018/02/19/meet-jekyll-s-new-lead-developer/index.html +180 -115
- data/site/news/2018/02/24/jekyll-3-7-3-released/index.html +185 -120
- data/site/news/2018/04/19/development-update/index.html +699 -0
- data/site/news/2018/04/19/jekyll-3-8-0-released/index.html +715 -0
- data/site/news/2018/05/01/jekyll-3-8-1-released/index.html +182 -117
- data/site/news/2018/05/19/jekyll-3-8-2-released/index.html +181 -116
- data/site/news/2018/06/05/jekyll-3-8-3-released/index.html +183 -118
- data/site/news/2018/08/01/jekyll-sponsoring/index.html +748 -0
- data/site/news/2018/09/19/security-fixes-for-3-6-3-7-3-8/index.html +692 -0
- data/site/news/2018/11/04/jekyll-3-8-5-released/index.html +682 -0
- data/site/news/2019/03/18/jekyll-4-0-0-pre-alpha1-released/index.html +710 -0
- data/site/news/2019/07/02/jekyll-3-8-6-released/index.html +180 -115
- data/site/news/2019/07/20/jekyll-4-0-0-pre-beta1-released/index.html +11 -0
- data/site/news/2019/08/04/jekyll-4-0-0-pre-beta1-released/index.html +708 -0
- data/site/news/2019/08/20/jekyll-4-0-0-released/index.html +809 -0
- data/site/news/index.html +976 -326
- data/site/news/releases/index.html +820 -321
- data/site/{philosophy.html → philosophy/index.html} +1 -1
- data/site/redirects.json +1 -1
- data/site/resources/index.html +332 -0
- data/site/showcase/index.html +844 -0
- data/site/sitemap.xml +256 -81
- data/site/team/index.html +63 -77
- data/site/tutorials/cache-api/index.html +418 -0
- data/site/tutorials/convert-site-to-jekyll/index.html +155 -124
- data/site/tutorials/custom-404-page/index.html +76 -43
- data/site/tutorials/home/index.html +64 -37
- data/site/tutorials/navigation/index.html +186 -103
- data/site/tutorials/orderofinterpretation/index.html +80 -53
- data/site/tutorials/using-jekyll-with-bundler/index.html +80 -51
- data/site/tutorials/video-walkthroughs/index.html +62 -35
- metadata +102 -13
- data/site/community/index.html +0 -11
- data/site/docs/continuous-integration/index.html +0 -681
@@ -0,0 +1,716 @@
|
|
1
|
+
<!DOCTYPE HTML>
|
2
|
+
<html lang="en-US">
|
3
|
+
<head>
|
4
|
+
<meta charset="UTF-8">
|
5
|
+
<meta name="viewport" content="width=device-width,initial-scale=1">
|
6
|
+
<meta name="generator" content="Jekyll v4.0.0">
|
7
|
+
<link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
|
8
|
+
<link type="application/atom+xml" rel="alternate" href="/feed/release.xml" title="Jekyll releases posts" />
|
9
|
+
<link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
|
10
|
+
<link rel="preload" href="/fonts/lato-v14-latin-300.woff2" as="font" type="font/woff2" crossorigin />
|
11
|
+
<link rel="preload" href="/fonts/lato-v14-latin-700.woff2" as="font" type="font/woff2" crossorigin />
|
12
|
+
<link rel="preload" href="/css/screen.css" as="style">
|
13
|
+
<link rel="stylesheet" href="/css/screen.css">
|
14
|
+
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
15
|
+
<!-- Begin Jekyll SEO tag v2.6.1 -->
|
16
|
+
<title>Jekyll on macOS | Jekyll • Simple, blog-aware, static sites</title>
|
17
|
+
<meta name="generator" content="Jekyll v4.0.0" />
|
18
|
+
<meta property="og:title" content="Jekyll on macOS" />
|
19
|
+
<meta property="og:locale" content="en_US" />
|
20
|
+
<meta name="description" content="Install Command Line Tools First, you need to install the command-line tools to be able to compile native extensions, open a terminal and run:" />
|
21
|
+
<meta property="og:description" content="Install Command Line Tools First, you need to install the command-line tools to be able to compile native extensions, open a terminal and run:" />
|
22
|
+
<link rel="canonical" href="https://jekyllrb.com/docs/installation/macos/" />
|
23
|
+
<meta property="og:url" content="https://jekyllrb.com/docs/installation/macos/" />
|
24
|
+
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
|
25
|
+
<meta property="og:image" content="https://jekyllrb.com/img/jekyll-og.png" />
|
26
|
+
<meta property="og:type" content="article" />
|
27
|
+
<meta property="article:published_time" content="2019-09-11T07:30:27-07:00" />
|
28
|
+
<meta name="twitter:card" content="summary_large_image" />
|
29
|
+
<meta property="twitter:image" content="https://jekyllrb.com/img/jekyll-og.png" />
|
30
|
+
<meta property="twitter:title" content="Jekyll on macOS" />
|
31
|
+
<meta name="twitter:site" content="@jekyllrb" />
|
32
|
+
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
|
33
|
+
<script type="application/ld+json">
|
34
|
+
{"description":"Install Command Line Tools First, you need to install the command-line tools to be able to compile native extensions, open a terminal and run:","@type":"BlogPosting","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/installation/macos/"},"headline":"Jekyll on macOS","dateModified":"2019-09-11T07:30:27-07:00","url":"https://jekyllrb.com/docs/installation/macos/","datePublished":"2019-09-11T07:30:27-07:00","image":"https://jekyllrb.com/img/jekyll-og.png","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"@context":"https://schema.org"}</script>
|
35
|
+
<!-- End Jekyll SEO tag -->
|
36
|
+
|
37
|
+
<!--[if lt IE 9]>
|
38
|
+
<script src="/js/html5shiv.min.js"></script>
|
39
|
+
<script src="/js/respond.min.js"></script>
|
40
|
+
<![endif]-->
|
41
|
+
</head>
|
42
|
+
|
43
|
+
|
44
|
+
<body class="wrap">
|
45
|
+
<header>
|
46
|
+
<div class="flexbox">
|
47
|
+
<div class="center-on-mobiles">
|
48
|
+
<h1>
|
49
|
+
<a href="/" class="logo">
|
50
|
+
<span class="sr-only">Jekyll</span>
|
51
|
+
<img src="/img/logo-2x.png" width="140" height="65" alt="Jekyll Logo">
|
52
|
+
</a>
|
53
|
+
</h1>
|
54
|
+
</div>
|
55
|
+
<nav class="main-nav hide-on-mobiles">
|
56
|
+
<ul>
|
57
|
+
|
58
|
+
<li>
|
59
|
+
<a href="/">Home</a>
|
60
|
+
</li>
|
61
|
+
|
62
|
+
<li class="current">
|
63
|
+
<a href="/docs/">Docs</a>
|
64
|
+
</li>
|
65
|
+
|
66
|
+
<li>
|
67
|
+
<a href="/resources/">Resources</a>
|
68
|
+
</li>
|
69
|
+
|
70
|
+
<li>
|
71
|
+
<a href="/showcase/">Showcase</a>
|
72
|
+
</li>
|
73
|
+
|
74
|
+
<li>
|
75
|
+
<a href="/news/">News</a>
|
76
|
+
</li>
|
77
|
+
|
78
|
+
</ul>
|
79
|
+
|
80
|
+
</nav>
|
81
|
+
<div class="search hide-on-mobiles">
|
82
|
+
<input type="text" id="docsearch-input" placeholder="Search the docs…">
|
83
|
+
|
84
|
+
</div>
|
85
|
+
<div class="meta hide-on-mobiles">
|
86
|
+
<ul>
|
87
|
+
<li>
|
88
|
+
<a href="https://github.com/jekyll/jekyll/releases/tag/v4.0.0">v4.0.0</a>
|
89
|
+
</li>
|
90
|
+
<li>
|
91
|
+
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
92
|
+
</li>
|
93
|
+
</ul>
|
94
|
+
</div>
|
95
|
+
</div>
|
96
|
+
<nav class="mobile-nav show-on-mobiles">
|
97
|
+
<ul>
|
98
|
+
|
99
|
+
<li>
|
100
|
+
<a href="/">Home</a>
|
101
|
+
</li>
|
102
|
+
|
103
|
+
<li class="current">
|
104
|
+
<a href="/docs/">Docs</a>
|
105
|
+
</li>
|
106
|
+
|
107
|
+
<li>
|
108
|
+
<a href="/resources/">Resources</a>
|
109
|
+
</li>
|
110
|
+
|
111
|
+
|
112
|
+
<li>
|
113
|
+
<a href="/news/">News</a>
|
114
|
+
</li>
|
115
|
+
|
116
|
+
<li>
|
117
|
+
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
118
|
+
</li>
|
119
|
+
</ul>
|
120
|
+
|
121
|
+
</nav>
|
122
|
+
</header>
|
123
|
+
|
124
|
+
|
125
|
+
<section class="docs">
|
126
|
+
<div class="grid">
|
127
|
+
|
128
|
+
<div class="docs-nav-mobile unit whole show-on-mobiles">
|
129
|
+
<select onchange="if (this.value) window.location.href=this.value">
|
130
|
+
<option value="">Navigate the docs…</option>
|
131
|
+
|
132
|
+
<optgroup label="Getting Started">
|
133
|
+
|
134
|
+
|
135
|
+
<option value="/docs/">
|
136
|
+
Quickstart
|
137
|
+
</option>
|
138
|
+
|
139
|
+
|
140
|
+
<option value="/docs/ruby-101/">
|
141
|
+
Ruby 101
|
142
|
+
</option>
|
143
|
+
|
144
|
+
|
145
|
+
<option value="/docs/installation/">
|
146
|
+
Installation
|
147
|
+
</option>
|
148
|
+
|
149
|
+
|
150
|
+
<option value="/docs/community/">
|
151
|
+
Community
|
152
|
+
</option>
|
153
|
+
|
154
|
+
|
155
|
+
<option value="/docs/step-by-step/01-setup/">
|
156
|
+
Step by Step Tutorial
|
157
|
+
</option>
|
158
|
+
|
159
|
+
</optgroup>
|
160
|
+
|
161
|
+
<optgroup label="Build">
|
162
|
+
|
163
|
+
|
164
|
+
<option value="/docs/usage/">
|
165
|
+
Command Line Usage
|
166
|
+
</option>
|
167
|
+
|
168
|
+
|
169
|
+
<option value="/docs/configuration/">
|
170
|
+
Configuration
|
171
|
+
</option>
|
172
|
+
|
173
|
+
</optgroup>
|
174
|
+
|
175
|
+
<optgroup label="Content">
|
176
|
+
|
177
|
+
|
178
|
+
<option value="/docs/pages/">
|
179
|
+
Pages
|
180
|
+
</option>
|
181
|
+
|
182
|
+
|
183
|
+
<option value="/docs/posts/">
|
184
|
+
Posts
|
185
|
+
</option>
|
186
|
+
|
187
|
+
|
188
|
+
<option value="/docs/front-matter/">
|
189
|
+
Front Matter
|
190
|
+
</option>
|
191
|
+
|
192
|
+
|
193
|
+
<option value="/docs/collections/">
|
194
|
+
Collections
|
195
|
+
</option>
|
196
|
+
|
197
|
+
|
198
|
+
<option value="/docs/datafiles/">
|
199
|
+
Data Files
|
200
|
+
</option>
|
201
|
+
|
202
|
+
|
203
|
+
<option value="/docs/assets/">
|
204
|
+
Assets
|
205
|
+
</option>
|
206
|
+
|
207
|
+
|
208
|
+
<option value="/docs/static-files/">
|
209
|
+
Static Files
|
210
|
+
</option>
|
211
|
+
|
212
|
+
</optgroup>
|
213
|
+
|
214
|
+
<optgroup label="Site Structure">
|
215
|
+
|
216
|
+
|
217
|
+
<option value="/docs/structure/">
|
218
|
+
Directory Structure
|
219
|
+
</option>
|
220
|
+
|
221
|
+
|
222
|
+
<option value="/docs/liquid/">
|
223
|
+
Liquid
|
224
|
+
</option>
|
225
|
+
|
226
|
+
|
227
|
+
<option value="/docs/variables/">
|
228
|
+
Variables
|
229
|
+
</option>
|
230
|
+
|
231
|
+
|
232
|
+
<option value="/docs/includes/">
|
233
|
+
Includes
|
234
|
+
</option>
|
235
|
+
|
236
|
+
|
237
|
+
<option value="/docs/layouts/">
|
238
|
+
Layouts
|
239
|
+
</option>
|
240
|
+
|
241
|
+
|
242
|
+
<option value="/docs/permalinks/">
|
243
|
+
Permalinks
|
244
|
+
</option>
|
245
|
+
|
246
|
+
|
247
|
+
<option value="/docs/themes/">
|
248
|
+
Themes
|
249
|
+
</option>
|
250
|
+
|
251
|
+
|
252
|
+
<option value="/docs/pagination/">
|
253
|
+
Pagination
|
254
|
+
</option>
|
255
|
+
|
256
|
+
</optgroup>
|
257
|
+
|
258
|
+
<optgroup label="Guides">
|
259
|
+
|
260
|
+
|
261
|
+
<option value="/docs/plugins/">
|
262
|
+
Plugins
|
263
|
+
</option>
|
264
|
+
|
265
|
+
|
266
|
+
<option value="/docs/migrations/">
|
267
|
+
Blog Migrations
|
268
|
+
</option>
|
269
|
+
|
270
|
+
|
271
|
+
<option value="/docs/upgrading/">
|
272
|
+
Upgrading
|
273
|
+
</option>
|
274
|
+
|
275
|
+
|
276
|
+
<option value="/docs/deployment/">
|
277
|
+
Deployment
|
278
|
+
</option>
|
279
|
+
|
280
|
+
</optgroup>
|
281
|
+
|
282
|
+
</select>
|
283
|
+
</div>
|
284
|
+
|
285
|
+
|
286
|
+
<div class="unit four-fifths">
|
287
|
+
<article>
|
288
|
+
<div class="improve right hide-on-mobiles">
|
289
|
+
<a data-proofer-ignore href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/installation/macos.md"><i class="fa fa-pencil"></i> Improve this page</a>
|
290
|
+
</div>
|
291
|
+
<h1>Jekyll on macOS</h1>
|
292
|
+
<h2 id="install-command-line-tools">Install Command Line Tools</h2>
|
293
|
+
<p>First, you need to install the command-line tools to be able to compile native extensions, open a terminal and run:</p>
|
294
|
+
|
295
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>xcode-select <span class="nt">--install</span>
|
296
|
+
</code></pre></div></div>
|
297
|
+
|
298
|
+
<h2 id="install-ruby">Install Ruby</h2>
|
299
|
+
|
300
|
+
<p>Jekyll requires <strong>Ruby > 2.4.0</strong>.
|
301
|
+
As macOS Mojave 10.14 comes only with ruby 2.3.x, you’ll have to install a newer version of Ruby.</p>
|
302
|
+
|
303
|
+
<h3 id="brew">With Homebrew</h3>
|
304
|
+
<p>To run the latest Ruby version you need to install it through <a href="https://brew.sh">Homebrew</a>.</p>
|
305
|
+
|
306
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># Install Homebrew</span>
|
307
|
+
/usr/bin/ruby <span class="nt">-e</span> <span class="s2">"</span><span class="si">$(</span>curl <span class="nt">-fsSL</span> https://raw.githubusercontent.com/Homebrew/install/master/install<span class="si">)</span><span class="s2">"</span>
|
308
|
+
|
309
|
+
brew <span class="nb">install </span>ruby
|
310
|
+
</code></pre></div></div>
|
311
|
+
|
312
|
+
<p>Add the brew ruby path to your shell config :</p>
|
313
|
+
|
314
|
+
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>export PATH=/usr/local/opt/ruby/bin:$PATH
|
315
|
+
</code></pre></div></div>
|
316
|
+
|
317
|
+
<p>Then relaunch your terminal and check your updated Ruby setup:</p>
|
318
|
+
|
319
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>which ruby
|
320
|
+
<span class="c"># /usr/local/opt/ruby/bin/ruby</span>
|
321
|
+
|
322
|
+
ruby <span class="nt">-v</span>
|
323
|
+
ruby 2.6.3p62 <span class="o">(</span>2019-04-16 revision 67580<span class="o">)</span>
|
324
|
+
</code></pre></div></div>
|
325
|
+
|
326
|
+
<p>Yay, we are now running current stable Ruby!</p>
|
327
|
+
|
328
|
+
<h3 id="rbenv">With rbenv</h3>
|
329
|
+
|
330
|
+
<p>People often use <a href="https://github.com/rbenv/rbenv">rbenv</a> to manage multiple
|
331
|
+
Ruby versions. This is very useful when you need to be able to run a given Ruby version on a project.</p>
|
332
|
+
|
333
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># Install Homebrew</span>
|
334
|
+
/usr/bin/ruby <span class="nt">-e</span> <span class="s2">"</span><span class="si">$(</span>curl <span class="nt">-fsSL</span> https://raw.githubusercontent.com/Homebrew/install/master/install<span class="si">)</span><span class="s2">"</span>
|
335
|
+
|
336
|
+
<span class="c"># Install rbenv and ruby-build</span>
|
337
|
+
brew <span class="nb">install </span>rbenv
|
338
|
+
|
339
|
+
<span class="c"># Setup rbenv integration to your shell</span>
|
340
|
+
rbenv init
|
341
|
+
|
342
|
+
<span class="c"># Check your install</span>
|
343
|
+
curl <span class="nt">-fsSL</span> https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-doctor | bash
|
344
|
+
</code></pre></div></div>
|
345
|
+
|
346
|
+
<p>Restart your terminal for changes to take effect.
|
347
|
+
Now you can install the Ruby version of our choice, let’s go with current latest stable Ruby:</p>
|
348
|
+
|
349
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>rbenv <span class="nb">install </span>2.6.3
|
350
|
+
rbenv global 2.6.3
|
351
|
+
ruby <span class="nt">-v</span>
|
352
|
+
ruby 2.6.3p62 <span class="o">(</span>2019-04-16 revision 67580<span class="o">)</span>
|
353
|
+
</code></pre></div></div>
|
354
|
+
|
355
|
+
<p>That’s it! Head over <a href="https://github.com/rbenv/rbenv#command-reference">rbenv command references</a> to learn how to use different versions of Ruby in your projects.</p>
|
356
|
+
|
357
|
+
<h2 id="install-jekyll">Install Jekyll</h2>
|
358
|
+
|
359
|
+
<p>Now all that is left is installing <a href="/docs/ruby-101/#bundler">Bundler</a> and Jekyll.</p>
|
360
|
+
|
361
|
+
<h3 id="local-install">Local Install</h3>
|
362
|
+
|
363
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gem <span class="nb">install</span> <span class="nt">--user-install</span> bundler jekyll
|
364
|
+
</code></pre></div></div>
|
365
|
+
|
366
|
+
<p>and then get your Ruby version using</p>
|
367
|
+
|
368
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ruby <span class="nt">-v</span>
|
369
|
+
ruby 2.6.3p62 <span class="o">(</span>2019-04-16 revision 67580<span class="o">)</span>
|
370
|
+
</code></pre></div></div>
|
371
|
+
|
372
|
+
<p>Then append your path file with the following, replacing the <code class="highlighter-rouge">X.X</code> with the first two digits of your Ruby version.</p>
|
373
|
+
|
374
|
+
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>export PATH=$HOME/.gem/ruby/X.X.0/bin:$PATH
|
375
|
+
</code></pre></div></div>
|
376
|
+
|
377
|
+
<p>To check your that you gem paths point to your home directory run:</p>
|
378
|
+
|
379
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gem <span class="nb">env</span>
|
380
|
+
</code></pre></div></div>
|
381
|
+
|
382
|
+
<p>And check that <code class="highlighter-rouge">GEM PATHS:</code> points to a path in your home directory</p>
|
383
|
+
|
384
|
+
<p class="note">Every time you update Ruby to a version with a different first two digits, you will need to update your path to match.</p>
|
385
|
+
|
386
|
+
<h3 id="global-install">Global Install</h3>
|
387
|
+
|
388
|
+
<p class="note warning">We strongly recommend against installing Ruby gems globally to avoid file permissions problems and using <code class="highlighter-rouge">sudo</code>.</p>
|
389
|
+
|
390
|
+
<h4 id="on-mojave-1014">On Mojave (10.14)</h4>
|
391
|
+
|
392
|
+
<p>Because of SIP Protections in Mojave, you must run:</p>
|
393
|
+
|
394
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>gem <span class="nb">install </span>bundler
|
395
|
+
<span class="nb">sudo </span>gem <span class="nb">install</span> <span class="nt">-n</span> /usr/local/bin/ jekyll
|
396
|
+
</code></pre></div></div>
|
397
|
+
|
398
|
+
<h4 id="before-mojave-1014">Before Mojave (<10.14)</h4>
|
399
|
+
|
400
|
+
<p>You only have to run:</p>
|
401
|
+
|
402
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sudo </span>gem <span class="nb">install </span>bundler jekyll
|
403
|
+
</code></pre></div></div>
|
404
|
+
|
405
|
+
<h2 id="problems">Problems?</h2>
|
406
|
+
|
407
|
+
<p>Check out the <a href="/docs/troubleshooting/">troubleshooting</a> page or <a href="https://talk.jekyllrb.com">ask for help on our forum</a>.</p>
|
408
|
+
|
409
|
+
</article>
|
410
|
+
</div>
|
411
|
+
|
412
|
+
<div class="unit one-fifth hide-on-mobiles">
|
413
|
+
<aside>
|
414
|
+
|
415
|
+
<h4>Getting Started</h4>
|
416
|
+
<ul>
|
417
|
+
|
418
|
+
|
419
|
+
<li>
|
420
|
+
<a href="/docs/">
|
421
|
+
Quickstart
|
422
|
+
</a>
|
423
|
+
</li>
|
424
|
+
|
425
|
+
|
426
|
+
<li>
|
427
|
+
<a href="/docs/ruby-101/">
|
428
|
+
Ruby 101
|
429
|
+
</a>
|
430
|
+
</li>
|
431
|
+
|
432
|
+
|
433
|
+
<li>
|
434
|
+
<a href="/docs/installation/">
|
435
|
+
Installation
|
436
|
+
</a>
|
437
|
+
</li>
|
438
|
+
|
439
|
+
|
440
|
+
<li>
|
441
|
+
<a href="/docs/community/">
|
442
|
+
Community
|
443
|
+
</a>
|
444
|
+
</li>
|
445
|
+
|
446
|
+
|
447
|
+
<li>
|
448
|
+
<a href="/docs/step-by-step/01-setup/">
|
449
|
+
Step by Step Tutorial
|
450
|
+
</a>
|
451
|
+
</li>
|
452
|
+
|
453
|
+
</ul>
|
454
|
+
|
455
|
+
<h4>Build</h4>
|
456
|
+
<ul>
|
457
|
+
|
458
|
+
|
459
|
+
<li>
|
460
|
+
<a href="/docs/usage/">
|
461
|
+
Command Line Usage
|
462
|
+
</a>
|
463
|
+
</li>
|
464
|
+
|
465
|
+
|
466
|
+
<li>
|
467
|
+
<a href="/docs/configuration/">
|
468
|
+
Configuration
|
469
|
+
</a>
|
470
|
+
</li>
|
471
|
+
|
472
|
+
</ul>
|
473
|
+
|
474
|
+
<h4>Content</h4>
|
475
|
+
<ul>
|
476
|
+
|
477
|
+
|
478
|
+
<li>
|
479
|
+
<a href="/docs/pages/">
|
480
|
+
Pages
|
481
|
+
</a>
|
482
|
+
</li>
|
483
|
+
|
484
|
+
|
485
|
+
<li>
|
486
|
+
<a href="/docs/posts/">
|
487
|
+
Posts
|
488
|
+
</a>
|
489
|
+
</li>
|
490
|
+
|
491
|
+
|
492
|
+
<li>
|
493
|
+
<a href="/docs/front-matter/">
|
494
|
+
Front Matter
|
495
|
+
</a>
|
496
|
+
</li>
|
497
|
+
|
498
|
+
|
499
|
+
<li>
|
500
|
+
<a href="/docs/collections/">
|
501
|
+
Collections
|
502
|
+
</a>
|
503
|
+
</li>
|
504
|
+
|
505
|
+
|
506
|
+
<li>
|
507
|
+
<a href="/docs/datafiles/">
|
508
|
+
Data Files
|
509
|
+
</a>
|
510
|
+
</li>
|
511
|
+
|
512
|
+
|
513
|
+
<li>
|
514
|
+
<a href="/docs/assets/">
|
515
|
+
Assets
|
516
|
+
</a>
|
517
|
+
</li>
|
518
|
+
|
519
|
+
|
520
|
+
<li>
|
521
|
+
<a href="/docs/static-files/">
|
522
|
+
Static Files
|
523
|
+
</a>
|
524
|
+
</li>
|
525
|
+
|
526
|
+
</ul>
|
527
|
+
|
528
|
+
<h4>Site Structure</h4>
|
529
|
+
<ul>
|
530
|
+
|
531
|
+
|
532
|
+
<li>
|
533
|
+
<a href="/docs/structure/">
|
534
|
+
Directory Structure
|
535
|
+
</a>
|
536
|
+
</li>
|
537
|
+
|
538
|
+
|
539
|
+
<li>
|
540
|
+
<a href="/docs/liquid/">
|
541
|
+
Liquid
|
542
|
+
</a>
|
543
|
+
</li>
|
544
|
+
|
545
|
+
|
546
|
+
<li>
|
547
|
+
<a href="/docs/variables/">
|
548
|
+
Variables
|
549
|
+
</a>
|
550
|
+
</li>
|
551
|
+
|
552
|
+
|
553
|
+
<li>
|
554
|
+
<a href="/docs/includes/">
|
555
|
+
Includes
|
556
|
+
</a>
|
557
|
+
</li>
|
558
|
+
|
559
|
+
|
560
|
+
<li>
|
561
|
+
<a href="/docs/layouts/">
|
562
|
+
Layouts
|
563
|
+
</a>
|
564
|
+
</li>
|
565
|
+
|
566
|
+
|
567
|
+
<li>
|
568
|
+
<a href="/docs/permalinks/">
|
569
|
+
Permalinks
|
570
|
+
</a>
|
571
|
+
</li>
|
572
|
+
|
573
|
+
|
574
|
+
<li>
|
575
|
+
<a href="/docs/themes/">
|
576
|
+
Themes
|
577
|
+
</a>
|
578
|
+
</li>
|
579
|
+
|
580
|
+
|
581
|
+
<li>
|
582
|
+
<a href="/docs/pagination/">
|
583
|
+
Pagination
|
584
|
+
</a>
|
585
|
+
</li>
|
586
|
+
|
587
|
+
</ul>
|
588
|
+
|
589
|
+
<h4>Guides</h4>
|
590
|
+
<ul>
|
591
|
+
|
592
|
+
|
593
|
+
<li>
|
594
|
+
<a href="/docs/plugins/">
|
595
|
+
Plugins
|
596
|
+
</a>
|
597
|
+
</li>
|
598
|
+
|
599
|
+
|
600
|
+
<li>
|
601
|
+
<a href="/docs/migrations/">
|
602
|
+
Blog Migrations
|
603
|
+
</a>
|
604
|
+
</li>
|
605
|
+
|
606
|
+
|
607
|
+
<li>
|
608
|
+
<a href="/docs/upgrading/">
|
609
|
+
Upgrading
|
610
|
+
</a>
|
611
|
+
</li>
|
612
|
+
|
613
|
+
|
614
|
+
<li>
|
615
|
+
<a href="/docs/deployment/">
|
616
|
+
Deployment
|
617
|
+
</a>
|
618
|
+
</li>
|
619
|
+
|
620
|
+
</ul>
|
621
|
+
|
622
|
+
</aside>
|
623
|
+
</div>
|
624
|
+
|
625
|
+
|
626
|
+
<div class="clear"></div>
|
627
|
+
|
628
|
+
</div>
|
629
|
+
</section>
|
630
|
+
|
631
|
+
|
632
|
+
<footer>
|
633
|
+
<div class="grid">
|
634
|
+
<div class="unit one-third center-on-mobiles">
|
635
|
+
<p>Jekyll is lovingly maintained by the <a href="/team/">core team</a> of volunteers. </p>
|
636
|
+
<p>The contents of this website are <br />© 2019 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
|
637
|
+
</div>
|
638
|
+
<div class="unit two-thirds align-right center-on-mobiles">
|
639
|
+
<p>
|
640
|
+
Proudly hosted by
|
641
|
+
<a href="https://github.com">
|
642
|
+
<img src="/img/footer-logo.png" width="100" height="30" alt="GitHub • Social coding">
|
643
|
+
</a>
|
644
|
+
</p>
|
645
|
+
</div>
|
646
|
+
<div class="unit two-thirds align-right center-on-mobiles">
|
647
|
+
<p>
|
648
|
+
Jekyll is funded thanks to its
|
649
|
+
<a href="https://github.com/jekyll/jekyll#sponsors">
|
650
|
+
sponsors!
|
651
|
+
</a>
|
652
|
+
</p>
|
653
|
+
</div>
|
654
|
+
</div>
|
655
|
+
</footer>
|
656
|
+
|
657
|
+
<script>
|
658
|
+
var anchorForId = function (id) {
|
659
|
+
var anchor = document.createElement("a");
|
660
|
+
anchor.className = "header-link";
|
661
|
+
anchor.href = "#" + id;
|
662
|
+
anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
|
663
|
+
anchor.title = "Permalink";
|
664
|
+
return anchor;
|
665
|
+
};
|
666
|
+
|
667
|
+
var linkifyAnchors = function (level, containingElement) {
|
668
|
+
var headers = containingElement.getElementsByTagName("h" + level);
|
669
|
+
for (var h = 0; h < headers.length; h++) {
|
670
|
+
var header = headers[h];
|
671
|
+
|
672
|
+
if (typeof header.id !== "undefined" && header.id !== "") {
|
673
|
+
header.appendChild(anchorForId(header.id));
|
674
|
+
}
|
675
|
+
}
|
676
|
+
};
|
677
|
+
|
678
|
+
document.onreadystatechange = function () {
|
679
|
+
if (this.readyState === "complete") {
|
680
|
+
var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
|
681
|
+
if (!contentBlock) {
|
682
|
+
return;
|
683
|
+
}
|
684
|
+
for (var level = 1; level <= 6; level++) {
|
685
|
+
linkifyAnchors(level, contentBlock);
|
686
|
+
}
|
687
|
+
}
|
688
|
+
};
|
689
|
+
</script>
|
690
|
+
|
691
|
+
|
692
|
+
<!-- Google Analytics (https://www.google.com/analytics) -->
|
693
|
+
<script>
|
694
|
+
!function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
|
695
|
+
(j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
|
696
|
+
L=e.getElementsByTagName(k)[0],l.src='https://www.google-analytics.com/analytics.js',
|
697
|
+
L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
|
698
|
+
|
699
|
+
ga('create', 'UA-50755011-1', 'jekyllrb.com');
|
700
|
+
ga('send', 'pageview');
|
701
|
+
|
702
|
+
</script>
|
703
|
+
|
704
|
+
|
705
|
+
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
|
706
|
+
<script type="text/javascript"> docsearch({
|
707
|
+
apiKey: '50fe39c839958dfad797000f33e2ec17',
|
708
|
+
indexName: 'jekyllrb',
|
709
|
+
inputSelector: '#docsearch-input',
|
710
|
+
enhancedSearchInput: true,
|
711
|
+
debug: false // Set debug to true if you want to inspect the dropdown
|
712
|
+
});
|
713
|
+
</script>
|
714
|
+
|
715
|
+
</body>
|
716
|
+
</html>
|