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
|
@@ -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>Convert an HTML site to Jekyll | Jekyll • Simple, blog-aware, static sites</title>
|
|
16
|
+
<meta name="generator" content="Jekyll v3.7.0">
|
|
15
17
|
<meta property="og:title" content="Convert an HTML site to Jekyll">
|
|
16
18
|
<meta property="og:locale" content="en_US">
|
|
17
19
|
<meta name="description" content="If you’re looking for themes for your Jekyll site, you don’t have to restrict yourself to existing Jekyll themes. It’s pretty easy to convert almost any static HTML files into a Jekyll website.">
|
|
@@ -20,12 +22,12 @@
|
|
|
20
22
|
<meta property="og:url" content="https://jekyllrb.com/tutorials/convert-site-to-jekyll/">
|
|
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":"Convert an HTML site to Jekyll","dateModified":"2018-01-03T02:41:17-08:00","datePublished":"2018-01-03T02:41:17-08:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/tutorials/convert-site-to-jekyll/"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"url":"https://jekyllrb.com/tutorials/convert-site-to-jekyll/","description":"If you’re looking for themes for your Jekyll site, you don’t have to restrict yourself to existing Jekyll themes. It’s pretty easy to convert almost any static HTML files into a Jekyll website.","@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
|
|
|
@@ -160,8 +171,8 @@
|
|
|
160
171
|
|
|
161
172
|
<p>Manually create these three files in a folder called <code class="highlighter-rouge">my_jekyll_site</code> or whatever suits you the most, and place <code class="highlighter-rouge">default.html</code> inside a folder named <code class="highlighter-rouge">_layouts</code>.</p>
|
|
162
173
|
|
|
163
|
-
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>touch _config.yml index.md default.html
|
|
164
|
-
<span class="nv">$ </span>mkdir _layouts <span class="o">&&</span> mv default.html _layouts
|
|
174
|
+
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span><span class="nb">touch </span>_config.yml index.md default.html
|
|
175
|
+
<span class="nv">$ </span><span class="nb">mkdir </span>_layouts <span class="o">&&</span> <span class="nb">mv </span>default.html _layouts
|
|
165
176
|
</code></pre></div></div>
|
|
166
177
|
|
|
167
178
|
<p>Fire up your favorite editor, and populate the contents of the <code class="highlighter-rouge">default.html</code> and <code class="highlighter-rouge">index.md</code> files as follows:</p>
|
|
@@ -418,7 +429,7 @@ Note that you don’t have to use the method described here. You could have simp
|
|
|
418
429
|
|
|
419
430
|
<h3 id="for-loops">For loops</h3>
|
|
420
431
|
|
|
421
|
-
<p>By the way, let’s pause here to look at the <code class="highlighter-rouge">for</code> loop logic a little more closely. <a href="https://
|
|
432
|
+
<p>By the way, let’s pause here to look at the <code class="highlighter-rouge">for</code> loop logic a little more closely. <a href="https://shopify.github.io/liquid/tags/iteration/">For loops in Liquid</a> are one of the most commonly used Liquid tags. <em>For loops</em> let you iterate through content in your Jekyll site and build out a result. The <code class="highlighter-rouge">for</code> loop also has <a href="https://help.shopify.com/themes/liquid/objects/for-loops">certain properties available</a> (like first or last iteration) based on the loop’s position in the loop as well.</p>
|
|
422
433
|
|
|
423
434
|
<p>We’ve only scratched the surface of what you can do with <code class="highlighter-rouge">for</code> loops in retrieving posts. For example, if you wanted to display posts from a specific category, you could do so by adding a <code class="highlighter-rouge">categories</code> property to your post’s front matter and then look in those categories. Further, you could limit the number of results by adding a <code class="highlighter-rouge">limit</code> property. Here’s an example:</p>
|
|
424
435
|
|
|
@@ -643,6 +654,9 @@ layout: null
|
|
|
643
654
|
|
|
644
655
|
|
|
645
656
|
|
|
657
|
+
|
|
658
|
+
|
|
659
|
+
|
|
646
660
|
|
|
647
661
|
|
|
648
662
|
|
|
@@ -679,6 +693,10 @@ layout: null
|
|
|
679
693
|
|
|
680
694
|
|
|
681
695
|
|
|
696
|
+
<li class=""><a href="/tutorials/video-walkthroughs/">Video Walkthroughs</a></li>
|
|
697
|
+
|
|
698
|
+
|
|
699
|
+
|
|
682
700
|
<li class=""><a href="/tutorials/navigation/">Navigation</a></li>
|
|
683
701
|
|
|
684
702
|
|
|
@@ -710,7 +728,7 @@ layout: null
|
|
|
710
728
|
<footer>
|
|
711
729
|
<div class="grid">
|
|
712
730
|
<div class="unit one-third center-on-mobiles">
|
|
713
|
-
<p>The contents of this website are <br>©
|
|
731
|
+
<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>
|
|
714
732
|
</div>
|
|
715
733
|
<div class="unit two-thirds align-right center-on-mobiles">
|
|
716
734
|
<p>
|
|
@@ -788,6 +806,15 @@ layout: null
|
|
|
788
806
|
</script>
|
|
789
807
|
|
|
790
808
|
|
|
809
|
+
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
|
|
810
|
+
<script type="text/javascript"> docsearch({
|
|
811
|
+
apiKey: '50fe39c839958dfad797000f33e2ec17',
|
|
812
|
+
indexName: 'jekyllrb',
|
|
813
|
+
inputSelector: '#docsearch-input',
|
|
814
|
+
enhancedSearchInput: true,
|
|
815
|
+
debug: false // Set debug to true if you want to inspect the dropdown
|
|
816
|
+
});
|
|
817
|
+
</script>
|
|
791
818
|
|
|
792
819
|
</body>
|
|
793
820
|
</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>Custom 404 Page | Jekyll • Simple, blog-aware, static sites</title>
|
|
16
|
+
<meta name="generator" content="Jekyll v3.7.0">
|
|
15
17
|
<meta property="og:title" content="Custom 404 Page">
|
|
16
18
|
<meta property="og:locale" content="en_US">
|
|
17
19
|
<meta name="description" content="You can easily serve custom 404 error pages with Jekyll to replace the default Error 404 – File Not Found page displayed when one tries to access a broken link on your site.">
|
|
@@ -20,12 +22,12 @@
|
|
|
20
22
|
<meta property="og:url" content="https://jekyllrb.com/tutorials/custom-404-page/">
|
|
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":"Custom 404 Page","dateModified":"2018-01-03T02:41:17-08:00","datePublished":"2018-01-03T02:41:17-08:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/tutorials/custom-404-page/"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"url":"https://jekyllrb.com/tutorials/custom-404-page/","description":"You can easily serve custom 404 error pages with Jekyll to replace the default Error 404 – File Not Found page displayed when one tries to access a broken link on 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
|
|
|
@@ -148,14 +159,14 @@
|
|
|
148
159
|
|
|
149
160
|
<p>If you plan to organize your files under subdirectories, the error page should have the following Front Matter Data, set: <code class="highlighter-rouge">permalink: /404.html</code>. This is to ensure that the compiled <code class="highlighter-rouge">404.html</code> resides at the root of your processed site, where it’ll be picked by the server.</p>
|
|
150
161
|
|
|
151
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code
|
|
152
|
-
|
|
162
|
+
<div class="language-markdown highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">---</span>
|
|
163
|
+
<span class="c1"># example 404.md</span>
|
|
153
164
|
|
|
154
|
-
layout
|
|
155
|
-
permalink
|
|
156
|
-
|
|
165
|
+
<span class="na">layout</span><span class="pi">:</span> <span class="s">default</span>
|
|
166
|
+
<span class="na">permalink</span><span class="pi">:</span> <span class="s">/404.html</span>
|
|
167
|
+
<span class="nn">---</span>
|
|
157
168
|
|
|
158
|
-
|
|
169
|
+
<span class="gh"># 404</span>
|
|
159
170
|
|
|
160
171
|
Page not found! :(
|
|
161
172
|
</code></pre></div></div>
|
|
@@ -166,12 +177,12 @@ Page not found! :(
|
|
|
166
177
|
|
|
167
178
|
<p>Simply add the following to your <code class="highlighter-rouge">.htaccess</code> file.</p>
|
|
168
179
|
|
|
169
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ErrorDocument 404 /404.html
|
|
180
|
+
<div class="language-apache highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nc">ErrorDocument</span> 404 /404.html
|
|
170
181
|
</code></pre></div></div>
|
|
171
182
|
|
|
172
183
|
<p>With an <code class="highlighter-rouge">.htaccess</code> file, you have the freedom to place your error page within a subdirectory.</p>
|
|
173
184
|
|
|
174
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ErrorDocument 404 /error_pages/404.html
|
|
185
|
+
<div class="language-apache highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nc">ErrorDocument</span> 404 /error_pages/404.html
|
|
175
186
|
</code></pre></div></div>
|
|
176
187
|
|
|
177
188
|
<p>Where the path is relative to your site’s domain.</p>
|
|
@@ -184,13 +195,14 @@ Page not found! :(
|
|
|
184
195
|
|
|
185
196
|
<p>Add the following to the nginx configuration file, <code class="highlighter-rouge">nginx.conf</code>, which is usually located inside <code class="highlighter-rouge">/etc/nginx/</code> or <code class="highlighter-rouge">/etc/nginx/conf/</code>:</p>
|
|
186
197
|
|
|
187
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>server {
|
|
188
|
-
error_page 404
|
|
189
|
-
location
|
|
190
|
-
internal
|
|
191
|
-
}
|
|
192
|
-
}
|
|
198
|
+
<div class="language-nginx highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">server</span> <span class="p">{</span>
|
|
199
|
+
<span class="kn">error_page</span> <span class="mi">404</span> <span class="n">/404.html</span><span class="p">;</span>
|
|
200
|
+
<span class="kn">location</span> <span class="p">=</span> <span class="n">/404.html</span> <span class="p">{</span>
|
|
201
|
+
<span class="kn">internal</span><span class="p">;</span>
|
|
202
|
+
<span class="p">}</span>
|
|
203
|
+
<span class="p">}</span>
|
|
193
204
|
</code></pre></div></div>
|
|
205
|
+
|
|
194
206
|
<p>The <code class="highlighter-rouge">location</code> directive prevents users from directly browsing the 404.html page.</p>
|
|
195
207
|
|
|
196
208
|
|
|
@@ -209,6 +221,9 @@ Page not found! :(
|
|
|
209
221
|
|
|
210
222
|
|
|
211
223
|
|
|
224
|
+
|
|
225
|
+
|
|
226
|
+
|
|
212
227
|
|
|
213
228
|
<div class="section-nav">
|
|
214
229
|
<div class="left align-right">
|
|
@@ -244,6 +259,10 @@ Page not found! :(
|
|
|
244
259
|
|
|
245
260
|
|
|
246
261
|
|
|
262
|
+
<li class=""><a href="/tutorials/video-walkthroughs/">Video Walkthroughs</a></li>
|
|
263
|
+
|
|
264
|
+
|
|
265
|
+
|
|
247
266
|
<li class=""><a href="/tutorials/navigation/">Navigation</a></li>
|
|
248
267
|
|
|
249
268
|
|
|
@@ -275,7 +294,7 @@ Page not found! :(
|
|
|
275
294
|
<footer>
|
|
276
295
|
<div class="grid">
|
|
277
296
|
<div class="unit one-third center-on-mobiles">
|
|
278
|
-
<p>The contents of this website are <br>©
|
|
297
|
+
<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>
|
|
279
298
|
</div>
|
|
280
299
|
<div class="unit two-thirds align-right center-on-mobiles">
|
|
281
300
|
<p>
|
|
@@ -353,6 +372,15 @@ Page not found! :(
|
|
|
353
372
|
</script>
|
|
354
373
|
|
|
355
374
|
|
|
375
|
+
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
|
|
376
|
+
<script type="text/javascript"> docsearch({
|
|
377
|
+
apiKey: '50fe39c839958dfad797000f33e2ec17',
|
|
378
|
+
indexName: 'jekyllrb',
|
|
379
|
+
inputSelector: '#docsearch-input',
|
|
380
|
+
enhancedSearchInput: true,
|
|
381
|
+
debug: false // Set debug to true if you want to inspect the dropdown
|
|
382
|
+
});
|
|
383
|
+
</script>
|
|
356
384
|
|
|
357
385
|
</body>
|
|
358
386
|
</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>Tutorials | Jekyll • Simple, blog-aware, static sites</title>
|
|
16
|
+
<meta name="generator" content="Jekyll v3.7.0">
|
|
15
17
|
<meta property="og:title" content="Tutorials">
|
|
16
18
|
<meta property="og:locale" content="en_US">
|
|
17
19
|
<meta name="description" content="In contrast to Docs, Tutorials provide more detailed, narrative instruction that cover a variety of Jekyll topics and scenarios. Tutorials might contain the following:">
|
|
@@ -20,12 +22,12 @@
|
|
|
20
22
|
<meta property="og:url" content="https://jekyllrb.com/tutorials/home/">
|
|
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":"Tutorials","dateModified":"2018-01-03T02:41:17-08:00","datePublished":"2018-01-03T02:41:17-08:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/tutorials/home/"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"url":"https://jekyllrb.com/tutorials/home/","description":"In contrast to Docs, Tutorials provide more detailed, narrative instruction that cover a variety of Jekyll topics and scenarios. Tutorials might contain the following:","@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
|
|
|
@@ -187,7 +198,7 @@
|
|
|
187
198
|
|
|
188
199
|
|
|
189
200
|
|
|
190
|
-
<a href="/tutorials/
|
|
201
|
+
<a href="/tutorials/video-walkthroughs/" class="next">Next</a>
|
|
191
202
|
|
|
192
203
|
</div>
|
|
193
204
|
</div>
|
|
@@ -209,6 +220,10 @@
|
|
|
209
220
|
|
|
210
221
|
|
|
211
222
|
|
|
223
|
+
<li class=""><a href="/tutorials/video-walkthroughs/">Video Walkthroughs</a></li>
|
|
224
|
+
|
|
225
|
+
|
|
226
|
+
|
|
212
227
|
<li class=""><a href="/tutorials/navigation/">Navigation</a></li>
|
|
213
228
|
|
|
214
229
|
|
|
@@ -240,7 +255,7 @@
|
|
|
240
255
|
<footer>
|
|
241
256
|
<div class="grid">
|
|
242
257
|
<div class="unit one-third center-on-mobiles">
|
|
243
|
-
<p>The contents of this website are <br>©
|
|
258
|
+
<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>
|
|
244
259
|
</div>
|
|
245
260
|
<div class="unit two-thirds align-right center-on-mobiles">
|
|
246
261
|
<p>
|
|
@@ -318,6 +333,15 @@
|
|
|
318
333
|
</script>
|
|
319
334
|
|
|
320
335
|
|
|
336
|
+
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
|
|
337
|
+
<script type="text/javascript"> docsearch({
|
|
338
|
+
apiKey: '50fe39c839958dfad797000f33e2ec17',
|
|
339
|
+
indexName: 'jekyllrb',
|
|
340
|
+
inputSelector: '#docsearch-input',
|
|
341
|
+
enhancedSearchInput: true,
|
|
342
|
+
debug: false // Set debug to true if you want to inspect the dropdown
|
|
343
|
+
});
|
|
344
|
+
</script>
|
|
321
345
|
|
|
322
346
|
</body>
|
|
323
347
|
</html>
|