jekyll-docs 3.6.2.0 → 3.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (147) hide show
  1. checksums.yaml +5 -5
  2. data/lib/jekyll-docs.rb +7 -5
  3. data/site/404.html +5 -6
  4. data/site/community/index.html +9 -297
  5. data/site/conduct/index.html +3 -2
  6. data/site/css/screen.css +1 -1
  7. data/site/docs/assets/index.html +46 -30
  8. data/site/docs/code_of_conduct/index.html +44 -28
  9. data/site/docs/collections/index.html +85 -48
  10. data/site/docs/conduct/index.html +44 -28
  11. data/site/docs/configuration/index.html +66 -35
  12. data/site/docs/continuous-integration/buddyworks/index.html +55 -39
  13. data/site/docs/continuous-integration/circleci/index.html +65 -49
  14. data/site/docs/continuous-integration/index.html +44 -28
  15. data/site/docs/continuous-integration/travis-ci/index.html +45 -29
  16. data/site/docs/contributing/index.html +53 -33
  17. data/site/docs/datafiles/index.html +71 -62
  18. data/site/docs/deployment-methods/index.html +49 -33
  19. data/site/docs/drafts/index.html +44 -28
  20. data/site/docs/extras/index.html +44 -28
  21. data/site/docs/frontmatter/index.html +55 -39
  22. data/site/docs/github-pages/index.html +107 -111
  23. data/site/docs/history/index.html +299 -115
  24. data/site/docs/home/index.html +45 -29
  25. data/site/docs/includes/index.html +51 -34
  26. data/site/docs/index.html +3 -2
  27. data/site/docs/installation/index.html +65 -49
  28. data/site/docs/maintaining/affinity-team-captain/index.html +46 -30
  29. data/site/docs/maintaining/avoiding-burnout/index.html +44 -28
  30. data/site/docs/maintaining/becoming-a-maintainer/index.html +45 -29
  31. data/site/docs/maintaining/index.html +44 -28
  32. data/site/docs/maintaining/merging-a-pull-request/index.html +45 -29
  33. data/site/docs/maintaining/reviewing-a-pull-request/index.html +45 -29
  34. data/site/docs/maintaining/special-labels/index.html +44 -28
  35. data/site/docs/maintaining/triaging-an-issue/index.html +45 -29
  36. data/site/docs/migrations/index.html +44 -28
  37. data/site/docs/pages/index.html +48 -32
  38. data/site/docs/pagination/index.html +105 -84
  39. data/site/docs/permalinks/index.html +48 -32
  40. data/site/docs/plugins/index.html +97 -58
  41. data/site/docs/posts/index.html +126 -71
  42. data/site/docs/quickstart/index.html +48 -32
  43. data/site/docs/resources/index.html +46 -29
  44. data/site/docs/sites/index.html +44 -28
  45. data/site/docs/static-files/index.html +44 -28
  46. data/site/docs/structure/index.html +44 -28
  47. data/site/docs/support/index.html +725 -0
  48. data/site/docs/templates/index.html +77 -54
  49. data/site/docs/themes/index.html +63 -37
  50. data/site/docs/troubleshooting/index.html +56 -40
  51. data/site/docs/upgrading/0-to-2/index.html +45 -29
  52. data/site/docs/upgrading/2-to-3/index.html +50 -34
  53. data/site/docs/upgrading/index.html +63 -31
  54. data/site/docs/usage/index.html +68 -44
  55. data/site/docs/variables/index.html +44 -28
  56. data/site/docs/windows/index.html +66 -54
  57. data/site/feed.xml +81 -108
  58. data/site/github.html +3 -2
  59. data/site/help/index.html +66 -46
  60. data/site/img/jekyll-sticker.jpg +0 -0
  61. data/site/img/jekylllayoutconcept.png +0 -0
  62. data/site/img/twitter-card.png +0 -0
  63. data/site/index.html +43 -27
  64. data/site/issues.html +3 -2
  65. data/site/jekyllconf/index.html +315 -0
  66. data/site/latest_version.txt +1 -1
  67. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +69 -33
  68. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +69 -33
  69. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +69 -33
  70. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +69 -33
  71. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +69 -33
  72. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +81 -45
  73. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +69 -33
  74. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +69 -33
  75. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +69 -33
  76. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +69 -33
  77. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +69 -33
  78. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +69 -33
  79. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +69 -33
  80. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +69 -33
  81. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +69 -33
  82. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +69 -33
  83. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +69 -33
  84. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +69 -33
  85. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +69 -33
  86. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +69 -33
  87. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +69 -33
  88. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +69 -33
  89. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +69 -33
  90. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +69 -33
  91. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +69 -33
  92. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +69 -33
  93. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +69 -33
  94. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +70 -34
  95. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +69 -33
  96. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +69 -33
  97. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +69 -33
  98. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +70 -34
  99. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +69 -33
  100. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +70 -34
  101. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +69 -33
  102. data/site/news/2015/10/26/jekyll-3-0-released/index.html +69 -33
  103. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +69 -33
  104. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +69 -33
  105. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +69 -33
  106. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +71 -35
  107. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +69 -33
  108. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +69 -33
  109. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +69 -33
  110. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +69 -33
  111. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +69 -33
  112. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +69 -33
  113. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +69 -33
  114. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +69 -33
  115. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +69 -33
  116. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +69 -33
  117. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +69 -33
  118. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +70 -34
  119. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +69 -33
  120. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +69 -33
  121. data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +69 -33
  122. data/site/news/2017/01/02/jekyll-3-7-0-released/index.html +626 -0
  123. data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +69 -33
  124. data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +69 -33
  125. data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +69 -33
  126. data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +69 -33
  127. data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +71 -35
  128. data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +69 -33
  129. data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +69 -33
  130. data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +69 -33
  131. data/site/news/2017/10/19/diversity-open-source/index.html +631 -0
  132. data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +627 -0
  133. data/site/news/index.html +270 -49
  134. data/site/news/releases/index.html +204 -49
  135. data/site/redirects.json +1 -0
  136. data/site/sitemap.xml +77 -57
  137. data/site/tutorials/convert-site-to-jekyll/index.html +58 -31
  138. data/site/tutorials/custom-404-page/index.html +70 -42
  139. data/site/tutorials/home/index.html +53 -29
  140. data/site/tutorials/index.html +3 -2
  141. data/site/tutorials/navigation/index.html +70 -38
  142. data/site/tutorials/orderofinterpretation/index.html +61 -34
  143. data/site/tutorials/video-walkthroughs/index.html +352 -0
  144. metadata +17 -12
  145. data/site/CNAME +0 -1
  146. data/site/icomoon-selection.json +0 -96
  147. data/site/readme.md +0 -23
@@ -4,14 +4,16 @@
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.6.2">
7
+ <meta name="generator" content="Jekyll v3.7.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
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css">
11
12
  <link rel="stylesheet" href="/css/screen.css">
12
13
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.3.0 -->
14
+ <!-- Begin Jekyll SEO tag v2.4.0 -->
14
15
  <title>Upgrading | Jekyll • Simple, blog-aware, static sites</title>
16
+ <meta name="generator" content="Jekyll v3.7.0">
15
17
  <meta property="og:title" content="Upgrading">
16
18
  <meta property="og:locale" content="en_US">
17
19
  <meta name="description" content="Upgrading from an older version of Jekyll? Upgrading to a new major version of Jekyll (e.g. from v2.x to v3.x) may cause some headaches. Take the following guides to aid your upgrade:">
@@ -20,12 +22,12 @@
20
22
  <meta property="og:url" content="https://jekyllrb.com/docs/upgrading/">
21
23
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
24
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-10-24T09:12:04-07:00">
25
+ <meta property="article:published_time" content="2018-01-03T02:41:17-08:00">
24
26
  <meta name="twitter:card" content="summary">
25
27
  <meta name="twitter:site" content="@jekyllrb">
26
28
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
29
  <script type="application/ld+json">
28
- {"name":null,"description":"Upgrading from an older version of Jekyll? Upgrading to a new major version of Jekyll (e.g. from v2.x to v3.x) may cause some headaches. Take the following guides to aid your upgrade:","url":"https://jekyllrb.com/docs/upgrading/","headline":"Upgrading","dateModified":"2017-10-24T09:12:04-07:00","datePublished":"2017-10-24T09:12:04-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/"},"@context":"http://schema.org"}</script>
30
+ {"headline":"Upgrading","dateModified":"2018-01-03T02:41:17-08:00","datePublished":"2018-01-03T02:41:17-08:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/upgrading/"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"url":"https://jekyllrb.com/docs/upgrading/","description":"Upgrading from an older version of Jekyll? Upgrading to a new major version of Jekyll (e.g. from v2.x to v3.x) may cause some headaches. Take the following guides to aid your upgrade:","@type":"BlogPosting","@context":"http://schema.org"}</script>
29
31
  <!-- End Jekyll SEO tag -->
30
32
 
31
33
  <!--[if lt IE 9]>
@@ -37,8 +39,17 @@
37
39
 
38
40
  <body class="wrap">
39
41
  <header>
40
- <nav class="mobile-nav show-on-mobiles">
41
- <ul>
42
+ <div class="flexbox">
43
+ <div class="center-on-mobiles">
44
+ <h1>
45
+ <a href="/" class="logo">
46
+ <span class="sr-only">Jekyll</span>
47
+ <img src="/img/logo-2x.png" width="140" height="65" alt="Jekyll Logo">
48
+ </a>
49
+ </h1>
50
+ </div>
51
+ <nav class="main-nav hide-on-mobiles">
52
+ <ul>
42
53
  <li class="">
43
54
  <a href="/">Home</a>
44
55
  </li>
@@ -48,29 +59,29 @@
48
59
  <li class="">
49
60
  <a href="/news/">News</a>
50
61
  </li>
51
- <li class="">
52
- <a href="/community/">Community</a>
53
- </li>
54
62
  <li class="">
55
63
  <a href="/help/">Help</a>
56
64
  </li>
57
- <li>
58
- <a href="https://github.com/jekyll/jekyll">GitHub</a>
59
- </li>
60
65
  </ul>
61
66
 
62
- </nav>
63
- <div class="grid">
64
- <div class="unit one-third center-on-mobiles">
65
- <h1>
66
- <a href="/">
67
- <span class="sr-only">Jekyll</span>
68
- <img src="/img/logo-2x.png" width="249" height="115" alt="Jekyll Logo">
69
- </a>
70
- </h1>
67
+ </nav>
68
+ <div class="search hide-on-mobiles">
69
+ <input type="text" id="docsearch-input" placeholder="Search the docs…">
70
+
71
71
  </div>
72
- <nav class="main-nav unit two-thirds hide-on-mobiles">
72
+ <div class="meta hide-on-mobiles">
73
73
  <ul>
74
+ <li>
75
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.0">v3.7.0</a>
76
+ </li>
77
+ <li>
78
+ <a href="https://github.com/jekyll/jekyll">GitHub</a>
79
+ </li>
80
+ </ul>
81
+ </div>
82
+ </div>
83
+ <nav class="mobile-nav show-on-mobiles">
84
+ <ul>
74
85
  <li class="">
75
86
  <a href="/">Home</a>
76
87
  </li>
@@ -80,9 +91,6 @@
80
91
  <li class="">
81
92
  <a href="/news/">News</a>
82
93
  </li>
83
- <li class="">
84
- <a href="/community/">Community</a>
85
- </li>
86
94
  <li class="">
87
95
  <a href="/help/">Help</a>
88
96
  </li>
@@ -91,8 +99,7 @@
91
99
  </li>
92
100
  </ul>
93
101
 
94
- </nav>
95
- </div>
102
+ </nav>
96
103
  </header>
97
104
 
98
105
 
@@ -287,15 +294,31 @@
287
294
  <a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/upgrading.md"><i class="fa fa-pencil"></i>  Improve this page</a>
288
295
  </div>
289
296
  <h1>Upgrading</h1>
290
- <p>Upgrading from an older version of Jekyll? Upgrading to a new major version of Jekyll (e.g. from v2.x to v3.x) may cause some headaches. Take the following guides to aid your upgrade:</p>
297
+ <p>Upgrading from an older version of Jekyll? Upgrading to a new major version of
298
+ Jekyll (e.g. from v2.x to v3.x) may cause some headaches. Take the following
299
+ guides to aid your upgrade:</p>
291
300
 
292
301
  <ul>
293
302
  <li><a href="/docs/upgrading/0-to-2/">From 0.x to 1.x and 2.x</a></li>
294
303
  <li><a href="/docs/upgrading/2-to-3/">From 2.x to 3.x</a></li>
295
304
  </ul>
296
305
 
297
- <p>If you are making a minor update (for example from 3.3.1 to the latest version at the time 3.3.2) run ‘bundle update jekyll’ when in your site directory.
298
- If you would like to update all your gems, run ‘bundle update’ when in your site directory.</p>
306
+ <h2 id="minor-updates">Minor updates</h2>
307
+
308
+ <div class="note">
309
+ <h5>Stay Up to Date</h5>
310
+ <p>We recommend you update Jekyll as often as possible to benefit from
311
+ the latest bug fixes.
312
+ </p>
313
+ </div>
314
+
315
+ <p>If you followed our setup recommendations and installed <a href="http://bundler.io/">Bundler</a>, run <code class="highlighter-rouge">bundle update jekyll</code> or simply <code class="highlighter-rouge">bundle update</code> and all your gems will
316
+ update to the latest versions.</p>
317
+
318
+ <p>If you don’t have Bundler installed, run <code class="highlighter-rouge">gem update jekyll</code>.</p>
319
+
320
+ <p>The procedure is similar <a href="https://help.github.com/articles/setting-up-your-github-pages-site-locally-with-jekyll/#keeping-your-site-up-to-date-with-the-github-pages-gem">if you use the <code class="highlighter-rouge">github-pages</code>
321
+ gem</a>.</p>
299
322
 
300
323
 
301
324
 
@@ -610,7 +633,7 @@ If you would like to update all your gems, run ‘bundle update’ when in your
610
633
  <footer>
611
634
  <div class="grid">
612
635
  <div class="unit one-third center-on-mobiles">
613
- <p>The contents of this website are <br>© 2017 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
636
+ <p>The contents of this website are <br>© 2018 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
614
637
  </div>
615
638
  <div class="unit two-thirds align-right center-on-mobiles">
616
639
  <p>
@@ -688,6 +711,15 @@ If you would like to update all your gems, run ‘bundle update’ when in your
688
711
  </script>
689
712
 
690
713
 
714
+ <script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
715
+ <script type="text/javascript"> docsearch({
716
+ apiKey: '50fe39c839958dfad797000f33e2ec17',
717
+ indexName: 'jekyllrb',
718
+ inputSelector: '#docsearch-input',
719
+ enhancedSearchInput: true,
720
+ debug: false // Set debug to true if you want to inspect the dropdown
721
+ });
722
+ </script>
691
723
 
692
724
  </body>
693
725
  </html>
@@ -4,14 +4,16 @@
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.6.2">
7
+ <meta name="generator" content="Jekyll v3.7.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
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css">
11
12
  <link rel="stylesheet" href="/css/screen.css">
12
13
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.3.0 -->
14
+ <!-- Begin Jekyll SEO tag v2.4.0 -->
14
15
  <title>Basic Usage | Jekyll • Simple, blog-aware, static sites</title>
16
+ <meta name="generator" content="Jekyll v3.7.0">
15
17
  <meta property="og:title" content="Basic Usage">
16
18
  <meta property="og:locale" content="en_US">
17
19
  <meta name="description" content="The Jekyll gem makes a jekyll executable available to you in your Terminal window. You can use this command in a number of ways:">
@@ -20,12 +22,12 @@
20
22
  <meta property="og:url" content="https://jekyllrb.com/docs/usage/">
21
23
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
24
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-10-24T09:12:04-07:00">
25
+ <meta property="article:published_time" content="2018-01-03T02:41:17-08:00">
24
26
  <meta name="twitter:card" content="summary">
25
27
  <meta name="twitter:site" content="@jekyllrb">
26
28
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
29
  <script type="application/ld+json">
28
- {"name":null,"description":"The Jekyll gem makes a jekyll executable available to you in your Terminal window. You can use this command in a number of ways:","url":"https://jekyllrb.com/docs/usage/","headline":"Basic Usage","dateModified":"2017-10-24T09:12:04-07:00","datePublished":"2017-10-24T09:12:04-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/usage/"},"@context":"http://schema.org"}</script>
30
+ {"headline":"Basic Usage","dateModified":"2018-01-03T02:41:17-08:00","datePublished":"2018-01-03T02:41:17-08:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/usage/"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"url":"https://jekyllrb.com/docs/usage/","description":"The Jekyll gem makes a jekyll executable available to you in your Terminal window. You can use this command in a number of ways:","@type":"BlogPosting","@context":"http://schema.org"}</script>
29
31
  <!-- End Jekyll SEO tag -->
30
32
 
31
33
  <!--[if lt IE 9]>
@@ -37,8 +39,17 @@
37
39
 
38
40
  <body class="wrap">
39
41
  <header>
40
- <nav class="mobile-nav show-on-mobiles">
41
- <ul>
42
+ <div class="flexbox">
43
+ <div class="center-on-mobiles">
44
+ <h1>
45
+ <a href="/" class="logo">
46
+ <span class="sr-only">Jekyll</span>
47
+ <img src="/img/logo-2x.png" width="140" height="65" alt="Jekyll Logo">
48
+ </a>
49
+ </h1>
50
+ </div>
51
+ <nav class="main-nav hide-on-mobiles">
52
+ <ul>
42
53
  <li class="">
43
54
  <a href="/">Home</a>
44
55
  </li>
@@ -48,29 +59,29 @@
48
59
  <li class="">
49
60
  <a href="/news/">News</a>
50
61
  </li>
51
- <li class="">
52
- <a href="/community/">Community</a>
53
- </li>
54
62
  <li class="">
55
63
  <a href="/help/">Help</a>
56
64
  </li>
57
- <li>
58
- <a href="https://github.com/jekyll/jekyll">GitHub</a>
59
- </li>
60
65
  </ul>
61
66
 
62
- </nav>
63
- <div class="grid">
64
- <div class="unit one-third center-on-mobiles">
65
- <h1>
66
- <a href="/">
67
- <span class="sr-only">Jekyll</span>
68
- <img src="/img/logo-2x.png" width="249" height="115" alt="Jekyll Logo">
69
- </a>
70
- </h1>
67
+ </nav>
68
+ <div class="search hide-on-mobiles">
69
+ <input type="text" id="docsearch-input" placeholder="Search the docs…">
70
+
71
71
  </div>
72
- <nav class="main-nav unit two-thirds hide-on-mobiles">
72
+ <div class="meta hide-on-mobiles">
73
73
  <ul>
74
+ <li>
75
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.0">v3.7.0</a>
76
+ </li>
77
+ <li>
78
+ <a href="https://github.com/jekyll/jekyll">GitHub</a>
79
+ </li>
80
+ </ul>
81
+ </div>
82
+ </div>
83
+ <nav class="mobile-nav show-on-mobiles">
84
+ <ul>
74
85
  <li class="">
75
86
  <a href="/">Home</a>
76
87
  </li>
@@ -80,9 +91,6 @@
80
91
  <li class="">
81
92
  <a href="/news/">News</a>
82
93
  </li>
83
- <li class="">
84
- <a href="/community/">Community</a>
85
- </li>
86
94
  <li class="">
87
95
  <a href="/help/">Help</a>
88
96
  </li>
@@ -91,8 +99,7 @@
91
99
  </li>
92
100
  </ul>
93
101
 
94
- </nav>
95
- </div>
102
+ </nav>
96
103
  </header>
97
104
 
98
105
 
@@ -290,22 +297,33 @@
290
297
  <p>The Jekyll gem makes a <code class="highlighter-rouge">jekyll</code> executable available to you in your Terminal
291
298
  window. You can use this command in a number of ways:</p>
292
299
 
293
- <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>jekyll build
300
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jekyll build
294
301
  <span class="c"># =&gt; The current folder will be generated into ./_site</span>
295
302
 
296
- <span class="nv">$ </span>jekyll build <span class="nt">--destination</span> &lt;destination&gt;
303
+ jekyll build <span class="nt">--destination</span> &lt;destination&gt;
297
304
  <span class="c"># =&gt; The current folder will be generated into &lt;destination&gt;</span>
298
305
 
299
- <span class="nv">$ </span>jekyll build <span class="nt">--source</span> &lt;<span class="nb">source</span><span class="o">&gt;</span> <span class="nt">--destination</span> &lt;destination&gt;
306
+ jekyll build <span class="nt">--source</span> &lt;<span class="nb">source</span><span class="o">&gt;</span> <span class="nt">--destination</span> &lt;destination&gt;
300
307
  <span class="c"># =&gt; The &lt;source&gt; folder will be generated into &lt;destination&gt;</span>
301
308
 
302
- <span class="nv">$ </span>jekyll build <span class="nt">--watch</span>
309
+ jekyll build <span class="nt">--watch</span>
303
310
  <span class="c"># =&gt; The current folder will be generated into ./_site,</span>
304
311
  <span class="c"># watched for changes, and regenerated automatically.</span>
305
312
  </code></pre></div></div>
306
313
 
314
+ <h2 id="override-default-development-settings">Override default development settings</h2>
315
+
316
+ <p>Default URL is set to <code class="highlighter-rouge">http://localhost:4000</code> in development environment. <span class="version-badge" title="This feature is available starting version 3.3.0">3.3.0</span></p>
317
+
318
+ <p>If you want to build for your production environment:</p>
319
+
320
+ <ul>
321
+ <li>Set your production URL in <code class="highlighter-rouge">_config.yml</code> e.g. <code class="highlighter-rouge">url: https://example.com</code>.</li>
322
+ <li>Run <code class="highlighter-rouge">JEKYLL_ENV=production bundle exec jekyll build</code>.</li>
323
+ </ul>
324
+
307
325
  <div class="note info">
308
- <h5>Changes to _config.yml are not included during automatic regeneration.</h5>
326
+ <h5>Changes to <code>_config.yml</code> are not included during automatic regeneration.</h5>
309
327
  <p>
310
328
  The <code>_config.yml</code> master configuration file contains global configurations
311
329
  and variable definitions that are read once at execution time. Changes made to <code>_config.yml</code>
@@ -334,24 +352,21 @@ window. You can use this command in a number of ways:</p>
334
352
  <p>Jekyll also comes with a built-in development server that will allow you to
335
353
  preview what the generated site will look like in your browser locally.</p>
336
354
 
337
- <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>jekyll serve
355
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jekyll serve
338
356
  <span class="c"># =&gt; A development server will run at http://localhost:4000/</span>
339
357
  <span class="c"># Auto-regeneration: enabled. Use `--no-watch` to disable.</span>
340
358
 
341
- <span class="nv">$ </span>jekyll serve <span class="nt">--detach</span>
359
+ jekyll serve <span class="nt">--detach</span>
342
360
  <span class="c"># =&gt; Same as `jekyll serve` but will detach from the current terminal.</span>
343
361
  <span class="c"># If you need to kill the server, you can `kill -9 1234` where "1234" is the PID.</span>
344
362
  <span class="c"># If you cannot find the PID, then do, `ps aux | grep jekyll` and kill the instance.</span>
345
363
  </code></pre></div></div>
346
-
347
- <div class="note info">
348
- <h5>Be aware of default behavior</h5>
349
- <p>
350
- As of version 2.4, the <code>serve</code> command will watch for changes automatically. To disable this, you can use <code>jekyll serve --no-watch</code>, which preserves the old behavior.
351
- </p>
364
+ <div class="note tip">
365
+ <h5>Livereload</h5>
366
+ <p>If you want to enable Livereload, you can enable the <a href="https://github.com/RobertDeRose/jekyll-livereload">jekyll-livereload</a> plugin in a <a href="../configuration/#build-command-options">development config file</a>.</p>
352
367
  </div>
353
368
 
354
- <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>jekyll serve <span class="nt">--no-watch</span>
369
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jekyll serve <span class="nt">--no-watch</span>
355
370
  <span class="c"># =&gt; Same as `jekyll serve` but will not watch for changes.</span>
356
371
  </code></pre></div></div>
357
372
 
@@ -368,8 +383,8 @@ in your <code class="highlighter-rouge">_config.yml</code> file:</p>
368
383
 
369
384
  <p>Then the following two commands will be equivalent:</p>
370
385
 
371
- <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>jekyll build
372
- <span class="nv">$ </span>jekyll build <span class="nt">--source</span> _source <span class="nt">--destination</span> _deploy
386
+ <div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jekyll build
387
+ jekyll build <span class="nt">--source</span> _source <span class="nt">--destination</span> _deploy
373
388
  </code></pre></div></div>
374
389
 
375
390
  <p>For more about the possible configuration options, see the
@@ -622,7 +637,7 @@ in your <code class="highlighter-rouge">_config.yml</code> file:</p>
622
637
  <footer>
623
638
  <div class="grid">
624
639
  <div class="unit one-third center-on-mobiles">
625
- <p>The contents of this website are <br>© 2017 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
640
+ <p>The contents of this website are <br>© 2018 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
626
641
  </div>
627
642
  <div class="unit two-thirds align-right center-on-mobiles">
628
643
  <p>
@@ -700,6 +715,15 @@ in your <code class="highlighter-rouge">_config.yml</code> file:</p>
700
715
  </script>
701
716
 
702
717
 
718
+ <script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
719
+ <script type="text/javascript"> docsearch({
720
+ apiKey: '50fe39c839958dfad797000f33e2ec17',
721
+ indexName: 'jekyllrb',
722
+ inputSelector: '#docsearch-input',
723
+ enhancedSearchInput: true,
724
+ debug: false // Set debug to true if you want to inspect the dropdown
725
+ });
726
+ </script>
703
727
 
704
728
  </body>
705
729
  </html>
@@ -4,14 +4,16 @@
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.6.2">
7
+ <meta name="generator" content="Jekyll v3.7.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
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css">
11
12
  <link rel="stylesheet" href="/css/screen.css">
12
13
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.3.0 -->
14
+ <!-- Begin Jekyll SEO tag v2.4.0 -->
14
15
  <title>Variables | Jekyll • Simple, blog-aware, static sites</title>
16
+ <meta name="generator" content="Jekyll v3.7.0">
15
17
  <meta property="og:title" content="Variables">
16
18
  <meta property="og:locale" content="en_US">
17
19
  <meta name="description" content="Jekyll traverses your site looking for files to process. Any files with YAML front matter are subject to processing. For each of these files, Jekyll makes a variety of data available via the Liquid templating system. The following is a reference of the available data.">
@@ -20,12 +22,12 @@
20
22
  <meta property="og:url" content="https://jekyllrb.com/docs/variables/">
21
23
  <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
22
24
  <meta property="og:type" content="article">
23
- <meta property="article:published_time" content="2017-10-24T09:12:04-07:00">
25
+ <meta property="article:published_time" content="2018-01-03T02:41:17-08:00">
24
26
  <meta name="twitter:card" content="summary">
25
27
  <meta name="twitter:site" content="@jekyllrb">
26
28
  <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
27
29
  <script type="application/ld+json">
28
- {"name":null,"description":"Jekyll traverses your site looking for files to process. Any files with YAML front matter are subject to processing. For each of these files, Jekyll makes a variety of data available via the Liquid templating system. The following is a reference of the available data.","url":"https://jekyllrb.com/docs/variables/","headline":"Variables","dateModified":"2017-10-24T09:12:04-07:00","datePublished":"2017-10-24T09:12:04-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/variables/"},"@context":"http://schema.org"}</script>
30
+ {"headline":"Variables","dateModified":"2018-01-03T02:41:17-08:00","datePublished":"2018-01-03T02:41:17-08:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/variables/"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"url":"https://jekyllrb.com/docs/variables/","description":"Jekyll traverses your site looking for files to process. Any files with YAML front matter are subject to processing. For each of these files, Jekyll makes a variety of data available via the Liquid templating system. The following is a reference of the available data.","@type":"BlogPosting","@context":"http://schema.org"}</script>
29
31
  <!-- End Jekyll SEO tag -->
30
32
 
31
33
  <!--[if lt IE 9]>
@@ -37,8 +39,17 @@
37
39
 
38
40
  <body class="wrap">
39
41
  <header>
40
- <nav class="mobile-nav show-on-mobiles">
41
- <ul>
42
+ <div class="flexbox">
43
+ <div class="center-on-mobiles">
44
+ <h1>
45
+ <a href="/" class="logo">
46
+ <span class="sr-only">Jekyll</span>
47
+ <img src="/img/logo-2x.png" width="140" height="65" alt="Jekyll Logo">
48
+ </a>
49
+ </h1>
50
+ </div>
51
+ <nav class="main-nav hide-on-mobiles">
52
+ <ul>
42
53
  <li class="">
43
54
  <a href="/">Home</a>
44
55
  </li>
@@ -48,29 +59,29 @@
48
59
  <li class="">
49
60
  <a href="/news/">News</a>
50
61
  </li>
51
- <li class="">
52
- <a href="/community/">Community</a>
53
- </li>
54
62
  <li class="">
55
63
  <a href="/help/">Help</a>
56
64
  </li>
57
- <li>
58
- <a href="https://github.com/jekyll/jekyll">GitHub</a>
59
- </li>
60
65
  </ul>
61
66
 
62
- </nav>
63
- <div class="grid">
64
- <div class="unit one-third center-on-mobiles">
65
- <h1>
66
- <a href="/">
67
- <span class="sr-only">Jekyll</span>
68
- <img src="/img/logo-2x.png" width="249" height="115" alt="Jekyll Logo">
69
- </a>
70
- </h1>
67
+ </nav>
68
+ <div class="search hide-on-mobiles">
69
+ <input type="text" id="docsearch-input" placeholder="Search the docs…">
70
+
71
71
  </div>
72
- <nav class="main-nav unit two-thirds hide-on-mobiles">
72
+ <div class="meta hide-on-mobiles">
73
73
  <ul>
74
+ <li>
75
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.0">v3.7.0</a>
76
+ </li>
77
+ <li>
78
+ <a href="https://github.com/jekyll/jekyll">GitHub</a>
79
+ </li>
80
+ </ul>
81
+ </div>
82
+ </div>
83
+ <nav class="mobile-nav show-on-mobiles">
84
+ <ul>
74
85
  <li class="">
75
86
  <a href="/">Home</a>
76
87
  </li>
@@ -80,9 +91,6 @@
80
91
  <li class="">
81
92
  <a href="/news/">News</a>
82
93
  </li>
83
- <li class="">
84
- <a href="/community/">Community</a>
85
- </li>
86
94
  <li class="">
87
95
  <a href="/help/">Help</a>
88
96
  </li>
@@ -91,8 +99,7 @@
91
99
  </li>
92
100
  </ul>
93
101
 
94
- </nav>
95
- </div>
102
+ </nav>
96
103
  </header>
97
104
 
98
105
 
@@ -965,7 +972,7 @@ following is a reference of the available data.</p>
965
972
  <footer>
966
973
  <div class="grid">
967
974
  <div class="unit one-third center-on-mobiles">
968
- <p>The contents of this website are <br>© 2017 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
975
+ <p>The contents of this website are <br>© 2018 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
969
976
  </div>
970
977
  <div class="unit two-thirds align-right center-on-mobiles">
971
978
  <p>
@@ -1043,6 +1050,15 @@ following is a reference of the available data.</p>
1043
1050
  </script>
1044
1051
 
1045
1052
 
1053
+ <script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
1054
+ <script type="text/javascript"> docsearch({
1055
+ apiKey: '50fe39c839958dfad797000f33e2ec17',
1056
+ indexName: 'jekyllrb',
1057
+ inputSelector: '#docsearch-input',
1058
+ enhancedSearchInput: true,
1059
+ debug: false // Set debug to true if you want to inspect the dropdown
1060
+ });
1061
+ </script>
1046
1062
 
1047
1063
  </body>
1048
1064
  </html>