jekyll-docs 3.6.2.0 → 3.7.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/lib/jekyll-docs.rb +7 -5
- data/site/404.html +5 -6
- data/site/community/index.html +9 -297
- data/site/conduct/index.html +3 -2
- data/site/css/screen.css +1 -1
- data/site/docs/assets/index.html +46 -30
- data/site/docs/code_of_conduct/index.html +44 -28
- data/site/docs/collections/index.html +85 -48
- data/site/docs/conduct/index.html +44 -28
- data/site/docs/configuration/index.html +66 -35
- data/site/docs/continuous-integration/buddyworks/index.html +55 -39
- data/site/docs/continuous-integration/circleci/index.html +65 -49
- data/site/docs/continuous-integration/index.html +44 -28
- data/site/docs/continuous-integration/travis-ci/index.html +45 -29
- data/site/docs/contributing/index.html +53 -33
- data/site/docs/datafiles/index.html +71 -62
- data/site/docs/deployment-methods/index.html +49 -33
- data/site/docs/drafts/index.html +44 -28
- data/site/docs/extras/index.html +44 -28
- data/site/docs/frontmatter/index.html +55 -39
- data/site/docs/github-pages/index.html +107 -111
- data/site/docs/history/index.html +299 -115
- data/site/docs/home/index.html +45 -29
- data/site/docs/includes/index.html +51 -34
- data/site/docs/index.html +3 -2
- data/site/docs/installation/index.html +65 -49
- data/site/docs/maintaining/affinity-team-captain/index.html +46 -30
- data/site/docs/maintaining/avoiding-burnout/index.html +44 -28
- data/site/docs/maintaining/becoming-a-maintainer/index.html +45 -29
- data/site/docs/maintaining/index.html +44 -28
- data/site/docs/maintaining/merging-a-pull-request/index.html +45 -29
- data/site/docs/maintaining/reviewing-a-pull-request/index.html +45 -29
- data/site/docs/maintaining/special-labels/index.html +44 -28
- data/site/docs/maintaining/triaging-an-issue/index.html +45 -29
- data/site/docs/migrations/index.html +44 -28
- data/site/docs/pages/index.html +48 -32
- data/site/docs/pagination/index.html +105 -84
- data/site/docs/permalinks/index.html +48 -32
- data/site/docs/plugins/index.html +97 -58
- data/site/docs/posts/index.html +126 -71
- data/site/docs/quickstart/index.html +48 -32
- data/site/docs/resources/index.html +46 -29
- data/site/docs/sites/index.html +44 -28
- data/site/docs/static-files/index.html +44 -28
- data/site/docs/structure/index.html +44 -28
- data/site/docs/support/index.html +725 -0
- data/site/docs/templates/index.html +77 -54
- data/site/docs/themes/index.html +63 -37
- data/site/docs/troubleshooting/index.html +56 -40
- data/site/docs/upgrading/0-to-2/index.html +45 -29
- data/site/docs/upgrading/2-to-3/index.html +50 -34
- data/site/docs/upgrading/index.html +63 -31
- data/site/docs/usage/index.html +68 -44
- data/site/docs/variables/index.html +44 -28
- data/site/docs/windows/index.html +66 -54
- data/site/feed.xml +81 -108
- data/site/github.html +3 -2
- data/site/help/index.html +66 -46
- data/site/img/jekyll-sticker.jpg +0 -0
- data/site/img/jekylllayoutconcept.png +0 -0
- data/site/img/twitter-card.png +0 -0
- data/site/index.html +43 -27
- data/site/issues.html +3 -2
- data/site/jekyllconf/index.html +315 -0
- data/site/latest_version.txt +1 -1
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +69 -33
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +69 -33
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +69 -33
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +69 -33
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +69 -33
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +81 -45
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +69 -33
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +69 -33
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +69 -33
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +69 -33
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +69 -33
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +69 -33
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +69 -33
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +69 -33
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +69 -33
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +69 -33
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +69 -33
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +69 -33
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +69 -33
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +69 -33
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +69 -33
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +69 -33
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +69 -33
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +69 -33
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +69 -33
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +69 -33
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +69 -33
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +70 -34
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +69 -33
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +69 -33
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +69 -33
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +70 -34
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +69 -33
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +70 -34
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +69 -33
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +69 -33
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +69 -33
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +69 -33
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +69 -33
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +71 -35
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +69 -33
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +69 -33
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +69 -33
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +69 -33
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +69 -33
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +69 -33
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +69 -33
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +69 -33
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +69 -33
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +69 -33
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +69 -33
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +70 -34
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +69 -33
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +69 -33
- data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +69 -33
- data/site/news/2017/01/02/jekyll-3-7-0-released/index.html +626 -0
- data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +69 -33
- data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +69 -33
- data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +69 -33
- data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +69 -33
- data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +71 -35
- data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +69 -33
- data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +69 -33
- data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +69 -33
- data/site/news/2017/10/19/diversity-open-source/index.html +631 -0
- data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +627 -0
- data/site/news/index.html +270 -49
- data/site/news/releases/index.html +204 -49
- data/site/redirects.json +1 -0
- data/site/sitemap.xml +77 -57
- data/site/tutorials/convert-site-to-jekyll/index.html +58 -31
- data/site/tutorials/custom-404-page/index.html +70 -42
- data/site/tutorials/home/index.html +53 -29
- data/site/tutorials/index.html +3 -2
- data/site/tutorials/navigation/index.html +70 -38
- data/site/tutorials/orderofinterpretation/index.html +61 -34
- data/site/tutorials/video-walkthroughs/index.html +352 -0
- metadata +17 -12
- data/site/CNAME +0 -1
- data/site/icomoon-selection.json +0 -96
- data/site/readme.md +0 -23
data/site/tutorials/index.html
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
<!DOCTYPE html>
|
|
2
2
|
<html lang="en-US">
|
|
3
3
|
<meta charset="utf-8">
|
|
4
|
-
<title>Redirecting
|
|
4
|
+
<title>Redirecting…</title>
|
|
5
5
|
<link rel="canonical" href="https://jekyllrb.com/tutorials/home/">
|
|
6
6
|
<meta http-equiv="refresh" content="0; url=https://jekyllrb.com/tutorials/home/">
|
|
7
|
-
<
|
|
7
|
+
<meta name="robots" content="noindex">
|
|
8
|
+
<h1>Redirecting…</h1>
|
|
8
9
|
<a href="https://jekyllrb.com/tutorials/home/">Click here if you are not redirected.</a>
|
|
9
10
|
<script>location="https://jekyllrb.com/tutorials/home/"</script>
|
|
10
11
|
</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.
|
|
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.
|
|
14
|
+
<!-- Begin Jekyll SEO tag v2.4.0 -->
|
|
14
15
|
<title>Navigation | Jekyll • Simple, blog-aware, static sites</title>
|
|
16
|
+
<meta name="generator" content="Jekyll v3.7.0">
|
|
15
17
|
<meta property="og:title" content="Navigation">
|
|
16
18
|
<meta property="og:locale" content="en_US">
|
|
17
19
|
<meta name="description" content="If your Jekyll site has a lot of pages, you might want to create navigation for the pages. Instead of hard-coding navigation links, you can programmatically retrieve a list of pages to build the navigation for your site.">
|
|
@@ -20,12 +22,12 @@
|
|
|
20
22
|
<meta property="og:url" content="https://jekyllrb.com/tutorials/navigation/">
|
|
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="
|
|
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
|
-
{"
|
|
30
|
+
{"headline":"Navigation","dateModified":"2018-01-03T02:41:17-08:00","datePublished":"2018-01-03T02:41:17-08:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/tutorials/navigation/"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"url":"https://jekyllrb.com/tutorials/navigation/","description":"If your Jekyll site has a lot of pages, you might want to create navigation for the pages. Instead of hard-coding navigation links, you can programmatically retrieve a list of pages to build the navigation for your site.","@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
|
-
<
|
|
41
|
-
<
|
|
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
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
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
|
-
<
|
|
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
|
-
|
|
95
|
-
</div>
|
|
102
|
+
</nav>
|
|
96
103
|
</header>
|
|
97
104
|
|
|
98
105
|
|
|
@@ -111,6 +118,10 @@
|
|
|
111
118
|
|
|
112
119
|
|
|
113
120
|
|
|
121
|
+
<option value="/tutorials/video-walkthroughs/">Video Walkthroughs</option>
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
|
|
114
125
|
<option value="/tutorials/navigation/">Navigation</option>
|
|
115
126
|
|
|
116
127
|
|
|
@@ -170,8 +181,8 @@
|
|
|
170
181
|
<li><a href="#scenario-4-three-level-navigation-list" id="markdown-toc-scenario-4-three-level-navigation-list">Scenario 4: Three-level navigation list</a></li>
|
|
171
182
|
<li><a href="#scenario-5-using-a-page-variable-to-select-the-yaml-list" id="markdown-toc-scenario-5-using-a-page-variable-to-select-the-yaml-list">Scenario 5: Using a page variable to select the YAML list</a></li>
|
|
172
183
|
<li><a href="#scenario-6-applying-the-active-class-for-the-current-page" id="markdown-toc-scenario-6-applying-the-active-class-for-the-current-page">Scenario 6: Applying the active class for the current page</a></li>
|
|
173
|
-
<li><a href="#scenario-
|
|
174
|
-
<li><a href="#scenario-
|
|
184
|
+
<li><a href="#scenario-7-including-items-conditionally" id="markdown-toc-scenario-7-including-items-conditionally">Scenario 7: Including items conditionally</a></li>
|
|
185
|
+
<li><a href="#scenario-8-retrieving-items-based-on-front-matter-properties" id="markdown-toc-scenario-8-retrieving-items-based-on-front-matter-properties">Scenario 8: Retrieving items based on front matter properties</a></li>
|
|
175
186
|
</ul>
|
|
176
187
|
|
|
177
188
|
<h2 id="scenario-1-basic-list">Scenario 1: Basic List</h2>
|
|
@@ -239,17 +250,21 @@
|
|
|
239
250
|
<p><strong>Liquid</strong></p>
|
|
240
251
|
|
|
241
252
|
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">assign</span><span class="w"> </span><span class="nv">doclist</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">site</span><span class="p">.</span><span class="nv">data</span><span class="p">.</span><span class="nv">samplelist</span><span class="p">.</span><span class="nv">docs</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">sort</span><span class="p">:</span><span class="w"> </span><span class="s1">'title'</span><span class="w"> </span><span class="p">%}</span>
|
|
253
|
+
<ol>
|
|
242
254
|
<span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span>item<span class="w"> </span>in<span class="w"> </span>doclist<span class="w"> </span><span class="p">%}</span>
|
|
243
255
|
<li><a href="<span class="p">{{</span><span class="w"> </span><span class="nv">item</span><span class="p">.</span><span class="nv">url</span><span class="w"> </span><span class="p">}}</span>" alt="<span class="p">{{</span><span class="w"> </span><span class="nv">item</span><span class="p">.</span><span class="nv">title</span><span class="w"> </span><span class="p">}}</span>"><span class="p">{{</span><span class="w"> </span><span class="nv">item</span><span class="p">.</span><span class="nv">title</span><span class="w"> </span><span class="p">}}</span></a></li>
|
|
244
256
|
<span class="p">{%</span><span class="w"> </span><span class="nt">endfor</span><span class="w"> </span><span class="p">%}</span>
|
|
257
|
+
</ol>
|
|
245
258
|
</code></pre></div></div>
|
|
246
259
|
|
|
247
260
|
<p><strong>Result</strong></p>
|
|
248
261
|
|
|
249
262
|
<div class="highlight result">
|
|
250
|
-
<
|
|
251
|
-
|
|
252
|
-
|
|
263
|
+
<ol>
|
|
264
|
+
<li><a href="#" alt="Configuration">Configuration</a></li>
|
|
265
|
+
<li><a href="#" alt="Deployment">Deployment</a></li>
|
|
266
|
+
<li><a href="#" alt="Introduction">Introduction</a></li>
|
|
267
|
+
</ol>
|
|
253
268
|
</div>
|
|
254
269
|
|
|
255
270
|
<p>The items now appear in alphabetical order. The <code class="highlighter-rouge">sort</code> property in the Liquid filter applies to the <code class="highlighter-rouge">title</code>, which is an actual property in the list. If <code class="highlighter-rouge">title</code> weren’t a property, we would need to sort by another property.</p>
|
|
@@ -473,6 +488,7 @@
|
|
|
473
488
|
<span class="p">{%</span><span class="w"> </span><span class="nt">endfor</span><span class="w"> </span><span class="p">%}</span>
|
|
474
489
|
</ul>
|
|
475
490
|
</code></pre></div></div>
|
|
491
|
+
|
|
476
492
|
<p><strong>Result</strong></p>
|
|
477
493
|
|
|
478
494
|
<div class="highlight result">
|
|
@@ -525,7 +541,7 @@
|
|
|
525
541
|
|
|
526
542
|
<p>To make sure the <code class="highlighter-rouge">item.url</code> (stored in the YAML file) matches the <code class="highlighter-rouge">page.url</code>, it can be helpful to print the <code class="highlighter-rouge">{{ page.url }}</code> to the page.</p>
|
|
527
543
|
|
|
528
|
-
<h2 id="scenario-
|
|
544
|
+
<h2 id="scenario-7-including-items-conditionally">Scenario 7: Including items conditionally</h2>
|
|
529
545
|
|
|
530
546
|
<p>You might want to include items conditionally in your list. For example, maybe you have multiple site outputs and only want to include the sidebar item for certain outputs. You can add properties in each list item and then use those properties to conditionally include the content.</p>
|
|
531
547
|
|
|
@@ -548,7 +564,7 @@
|
|
|
548
564
|
|
|
549
565
|
<p><strong>Liquid</strong></p>
|
|
550
566
|
|
|
551
|
-
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code
|
|
567
|
+
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <ul>
|
|
552
568
|
<span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span>item<span class="w"> </span>in<span class="w"> </span>site.data.samplelist.docs<span class="mi">2</span><span class="w"> </span><span class="p">%}</span>
|
|
553
569
|
<span class="p">{%</span><span class="w"> </span><span class="kr">if</span><span class="w"> </span><span class="nv">item</span><span class="p">.</span><span class="nv">version</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="p">%}</span>
|
|
554
570
|
<li><a href="<span class="p">{{</span><span class="w"> </span><span class="nv">item</span><span class="p">.</span><span class="nv">url</span><span class="w"> </span><span class="p">}}</span>"><span class="p">{{</span><span class="w"> </span><span class="nv">item</span><span class="p">.</span><span class="nv">title</span><span class="w"> </span><span class="p">}}</span></a></li>
|
|
@@ -568,7 +584,7 @@
|
|
|
568
584
|
|
|
569
585
|
<p>The <code class="highlighter-rouge">Deployment</code> page is excluded because its <code class="highlighter-rouge">version</code> is <code class="highlighter-rouge">2</code>.</p>
|
|
570
586
|
|
|
571
|
-
<h2 id="scenario-
|
|
587
|
+
<h2 id="scenario-8-retrieving-items-based-on-front-matter-properties">Scenario 8: Retrieving items based on front matter properties</h2>
|
|
572
588
|
|
|
573
589
|
<p>If you don’t want to store your navigation items in a YAML file in your <code class="highlighter-rouge">_data</code> folder, you can use <code class="highlighter-rouge">for</code> loops to look through the YAML front matter of each page or collection and get the content based on properties in the front matter.</p>
|
|
574
590
|
|
|
@@ -709,7 +725,7 @@
|
|
|
709
725
|
|
|
710
726
|
<p>The <code class="highlighter-rouge">for item in items</code> loop looks through each <code class="highlighter-rouge">item</code> and gets the <code class="highlighter-rouge">title</code> and <code class="highlighter-rouge">url</code> to form the list item link.</p>
|
|
711
727
|
|
|
712
|
-
<p>For more details on the <code class="highlighter-rouge">group_by</code> filter, see <a href="https://jekyllrb.com/docs/templates/">Jekyll’s Templates documentation</a> as well as <a href="https://www.siteleaf.com/blog/advanced-liquid-group-by/">this Siteleaf tutorial</a>. For more details on the <code class="highlighter-rouge">sort</code> filter, see <a href="https://
|
|
728
|
+
<p>For more details on the <code class="highlighter-rouge">group_by</code> filter, see <a href="https://jekyllrb.com/docs/templates/">Jekyll’s Templates documentation</a> as well as <a href="https://www.siteleaf.com/blog/advanced-liquid-group-by/">this Siteleaf tutorial</a>. For more details on the <code class="highlighter-rouge">sort</code> filter, see <a href="https://shopify.github.io/liquid/filters/sort/">sort</a> in Liquid’s documentation.</p>
|
|
713
729
|
|
|
714
730
|
<p>Whether you use properties in your doc’s front matter to retrieve your pages or a YAML data file, in both cases you can programmatically build a more robust navigation for your site.</p>
|
|
715
731
|
|
|
@@ -724,12 +740,15 @@
|
|
|
724
740
|
|
|
725
741
|
|
|
726
742
|
|
|
743
|
+
|
|
744
|
+
|
|
745
|
+
|
|
727
746
|
<div class="section-nav">
|
|
728
747
|
<div class="left align-right">
|
|
729
748
|
|
|
730
749
|
|
|
731
750
|
|
|
732
|
-
<a href="/tutorials/
|
|
751
|
+
<a href="/tutorials/video-walkthroughs/" class="prev">Back</a>
|
|
733
752
|
|
|
734
753
|
</div>
|
|
735
754
|
<div class="right align-left">
|
|
@@ -758,6 +777,10 @@
|
|
|
758
777
|
|
|
759
778
|
|
|
760
779
|
|
|
780
|
+
<li class=""><a href="/tutorials/video-walkthroughs/">Video Walkthroughs</a></li>
|
|
781
|
+
|
|
782
|
+
|
|
783
|
+
|
|
761
784
|
<li class="current"><a href="/tutorials/navigation/">Navigation</a></li>
|
|
762
785
|
|
|
763
786
|
|
|
@@ -789,7 +812,7 @@
|
|
|
789
812
|
<footer>
|
|
790
813
|
<div class="grid">
|
|
791
814
|
<div class="unit one-third center-on-mobiles">
|
|
792
|
-
<p>The contents of this website are <br>©
|
|
815
|
+
<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>
|
|
793
816
|
</div>
|
|
794
817
|
<div class="unit two-thirds align-right center-on-mobiles">
|
|
795
818
|
<p>
|
|
@@ -867,6 +890,15 @@
|
|
|
867
890
|
</script>
|
|
868
891
|
|
|
869
892
|
|
|
893
|
+
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
|
|
894
|
+
<script type="text/javascript"> docsearch({
|
|
895
|
+
apiKey: '50fe39c839958dfad797000f33e2ec17',
|
|
896
|
+
indexName: 'jekyllrb',
|
|
897
|
+
inputSelector: '#docsearch-input',
|
|
898
|
+
enhancedSearchInput: true,
|
|
899
|
+
debug: false // Set debug to true if you want to inspect the dropdown
|
|
900
|
+
});
|
|
901
|
+
</script>
|
|
870
902
|
|
|
871
903
|
</body>
|
|
872
904
|
</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.
|
|
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.
|
|
14
|
+
<!-- Begin Jekyll SEO tag v2.4.0 -->
|
|
14
15
|
<title>Order of interpretation | Jekyll • Simple, blog-aware, static sites</title>
|
|
16
|
+
<meta name="generator" content="Jekyll v3.7.0">
|
|
15
17
|
<meta property="og:title" content="Order of interpretation">
|
|
16
18
|
<meta property="og:locale" content="en_US">
|
|
17
19
|
<meta name="description" content="Jekyll’s main job is to convert your raw text files into a static website. It does this by rendering Liquid, Markdown, and other transforms as it generates the static HTML output.">
|
|
@@ -20,12 +22,12 @@
|
|
|
20
22
|
<meta property="og:url" content="https://jekyllrb.com/tutorials/orderofinterpretation/">
|
|
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="
|
|
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
|
-
{"
|
|
30
|
+
{"headline":"Order of interpretation","dateModified":"2018-01-03T02:41:17-08:00","datePublished":"2018-01-03T02:41:17-08:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/tutorials/orderofinterpretation/"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"url":"https://jekyllrb.com/tutorials/orderofinterpretation/","description":"Jekyll’s main job is to convert your raw text files into a static website. It does this by rendering Liquid, Markdown, and other transforms as it generates the static HTML output.","@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
|
-
<
|
|
41
|
-
<
|
|
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
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
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
|
-
<
|
|
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
|
-
|
|
95
|
-
</div>
|
|
102
|
+
</nav>
|
|
96
103
|
</header>
|
|
97
104
|
|
|
98
105
|
|
|
@@ -111,6 +118,10 @@
|
|
|
111
118
|
|
|
112
119
|
|
|
113
120
|
|
|
121
|
+
<option value="/tutorials/video-walkthroughs/">Video Walkthroughs</option>
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
|
|
114
125
|
<option value="/tutorials/navigation/">Navigation</option>
|
|
115
126
|
|
|
116
127
|
|
|
@@ -183,12 +194,12 @@
|
|
|
183
194
|
|
|
184
195
|
<p>In your layout file (<code class="highlighter-rouge">_layouts/default.html</code>), suppose you have a variable assigned:</p>
|
|
185
196
|
|
|
186
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>{
|
|
197
|
+
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="nt">assign</span><span class="w"> </span><span class="nv">myvar</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"joe"</span><span class="w"> </span><span class="p">%}</span>
|
|
187
198
|
</code></pre></div></div>
|
|
188
199
|
|
|
189
200
|
<p>On a page that uses the layout, you reference that variable:</p>
|
|
190
201
|
|
|
191
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>{{ myvar }}
|
|
202
|
+
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{{</span><span class="w"> </span><span class="nv">myvar</span><span class="w"> </span><span class="p">}}</span>
|
|
192
203
|
</code></pre></div></div>
|
|
193
204
|
|
|
194
205
|
<p>The variable won’t render because the page’s order of interpretation is to render Liquid first and later process the Layout. When the Liquid rendering happens, the variable assignment isn’t available.</p>
|
|
@@ -266,15 +277,15 @@ console.log('alert');
|
|
|
266
277
|
|
|
267
278
|
<p>For example, suppose you have a <code class="highlighter-rouge">highlight</code> tag in your <code class="highlighter-rouge">_data/mydata.yml</code> file:</p>
|
|
268
279
|
|
|
269
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>myvalue: >
|
|
270
|
-
{
|
|
280
|
+
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code>myvalue: >
|
|
281
|
+
<span class="p">{%</span><span class="w"> </span><span class="nt">highlight</span><span class="w"> </span>javascript<span class="w"> </span><span class="p">%}</span>
|
|
271
282
|
console.log('alert');
|
|
272
|
-
{
|
|
283
|
+
<span class="p">{%</span><span class="w"> </span><span class="nt">endhighlight</span><span class="w"> </span><span class="p">%}</span>
|
|
273
284
|
</code></pre></div></div>
|
|
274
285
|
|
|
275
286
|
<p>On a page, you try to insert the value:</p>
|
|
276
287
|
|
|
277
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>{{ site
|
|
288
|
+
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{{</span><span class="w"> </span><span class="nv">site</span><span class="p">.</span><span class="nv">data</span><span class="p">.</span><span class="nv">mydata</span><span class="p">.</span><span class="nv">myvalue</span><span class="w"> </span><span class="p">}}</span>
|
|
278
289
|
</code></pre></div></div>
|
|
279
290
|
|
|
280
291
|
<p>This would render only as a string rather than a code sample with syntax highlighting. To make the code render, consider using an include instead.</p>
|
|
@@ -293,6 +304,9 @@ console.log('alert');
|
|
|
293
304
|
|
|
294
305
|
|
|
295
306
|
|
|
307
|
+
|
|
308
|
+
|
|
309
|
+
|
|
296
310
|
<div class="section-nav">
|
|
297
311
|
<div class="left align-right">
|
|
298
312
|
|
|
@@ -327,6 +341,10 @@ console.log('alert');
|
|
|
327
341
|
|
|
328
342
|
|
|
329
343
|
|
|
344
|
+
<li class=""><a href="/tutorials/video-walkthroughs/">Video Walkthroughs</a></li>
|
|
345
|
+
|
|
346
|
+
|
|
347
|
+
|
|
330
348
|
<li class=""><a href="/tutorials/navigation/">Navigation</a></li>
|
|
331
349
|
|
|
332
350
|
|
|
@@ -358,7 +376,7 @@ console.log('alert');
|
|
|
358
376
|
<footer>
|
|
359
377
|
<div class="grid">
|
|
360
378
|
<div class="unit one-third center-on-mobiles">
|
|
361
|
-
<p>The contents of this website are <br>©
|
|
379
|
+
<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>
|
|
362
380
|
</div>
|
|
363
381
|
<div class="unit two-thirds align-right center-on-mobiles">
|
|
364
382
|
<p>
|
|
@@ -436,6 +454,15 @@ console.log('alert');
|
|
|
436
454
|
</script>
|
|
437
455
|
|
|
438
456
|
|
|
457
|
+
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
|
|
458
|
+
<script type="text/javascript"> docsearch({
|
|
459
|
+
apiKey: '50fe39c839958dfad797000f33e2ec17',
|
|
460
|
+
indexName: 'jekyllrb',
|
|
461
|
+
inputSelector: '#docsearch-input',
|
|
462
|
+
enhancedSearchInput: true,
|
|
463
|
+
debug: false // Set debug to true if you want to inspect the dropdown
|
|
464
|
+
});
|
|
465
|
+
</script>
|
|
439
466
|
|
|
440
467
|
</body>
|
|
441
468
|
</html>
|