jekyll-docs 3.8.5 → 3.9.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/site/404.html +5 -4
- data/site/docs/assets/index.html +22 -21
- data/site/docs/code_of_conduct/index.html +8 -7
- data/site/docs/collections/index.html +44 -43
- data/site/docs/conduct/index.html +8 -7
- data/site/docs/configuration/index.html +68 -67
- data/site/docs/continuous-integration/buddyworks/index.html +10 -9
- data/site/docs/continuous-integration/circleci/index.html +13 -12
- data/site/docs/continuous-integration/index.html +8 -7
- data/site/docs/continuous-integration/travis-ci/index.html +32 -31
- data/site/docs/contributing/index.html +34 -33
- data/site/docs/datafiles/index.html +24 -23
- data/site/docs/deployment-methods/index.html +30 -29
- data/site/docs/drafts/index.html +11 -10
- data/site/docs/extras/index.html +9 -8
- data/site/docs/frontmatter/index.html +8 -7
- data/site/docs/github-pages/index.html +19 -18
- data/site/docs/history/index.html +674 -645
- data/site/docs/home/index.html +8 -7
- data/site/docs/includes/index.html +44 -43
- data/site/docs/installation/index.html +16 -15
- data/site/docs/maintaining/affinity-team-captain/index.html +11 -10
- data/site/docs/maintaining/avoiding-burnout/index.html +8 -7
- data/site/docs/maintaining/becoming-a-maintainer/index.html +9 -8
- data/site/docs/maintaining/index.html +8 -7
- data/site/docs/maintaining/merging-a-pull-request/index.html +23 -22
- data/site/docs/maintaining/releasing-a-new-version/index.html +19 -18
- data/site/docs/maintaining/reviewing-a-pull-request/index.html +10 -9
- data/site/docs/maintaining/special-labels/index.html +14 -13
- data/site/docs/maintaining/triaging-an-issue/index.html +12 -11
- data/site/docs/migrations/index.html +9 -8
- data/site/docs/pages/index.html +12 -11
- data/site/docs/pagination/index.html +25 -24
- data/site/docs/permalinks/index.html +33 -32
- data/site/docs/plugins/index.html +57 -56
- data/site/docs/posts/index.html +37 -36
- data/site/docs/quickstart/index.html +18 -17
- data/site/docs/resources/index.html +9 -8
- data/site/docs/sites/index.html +8 -7
- data/site/docs/static-files/index.html +14 -13
- data/site/docs/structure/index.html +8 -7
- data/site/docs/support/index.html +9 -8
- data/site/docs/templates/index.html +44 -43
- data/site/docs/themes/index.html +63 -62
- data/site/docs/troubleshooting/index.html +48 -47
- data/site/docs/upgrading/0-to-2/index.html +51 -50
- data/site/docs/upgrading/2-to-3/index.html +35 -34
- data/site/docs/upgrading/index.html +11 -10
- data/site/docs/usage/index.html +15 -14
- data/site/docs/variables/index.html +8 -7
- data/site/docs/windows/index.html +29 -28
- data/site/feed.xml +45 -41
- data/site/help/index.html +7 -6
- data/site/index.html +7 -6
- data/site/jekyllconf/index.html +9 -8
- data/site/latest_version.txt +1 -1
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +16 -10
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +18 -12
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +19 -13
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +20 -14
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +19 -13
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +16 -10
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +18 -12
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +18 -12
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +21 -15
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +19 -13
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +16 -10
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +25 -19
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +17 -11
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +17 -11
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +16 -10
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +18 -12
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +17 -11
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +17 -11
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +17 -11
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +20 -14
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +16 -10
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +16 -10
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +21 -15
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +18 -12
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +17 -11
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +24 -18
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +23 -17
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +22 -16
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +16 -10
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +18 -12
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +16 -10
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +16 -10
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +16 -10
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +16 -10
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +16 -10
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +21 -15
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +20 -14
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +18 -12
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +21 -15
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +21 -15
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +17 -11
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +18 -12
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +16 -10
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +17 -11
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +17 -11
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +16 -10
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +22 -16
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +17 -11
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +17 -11
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +16 -10
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +20 -14
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +17 -11
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +16 -10
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +42 -36
- data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +17 -11
- data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +18 -12
- data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +17 -11
- data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +21 -15
- data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +26 -20
- data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +25 -19
- data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +18 -12
- data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +21 -15
- data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +17 -11
- data/site/news/2017/10/19/diversity-open-source/index.html +18 -12
- data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +18 -12
- data/site/news/2018/01/02/jekyll-3-7-0-released/index.html +21 -15
- data/site/news/2018/01/25/jekyll-3-7-2-released/index.html +26 -20
- data/site/news/2018/02/19/meet-jekyll-s-new-lead-developer/index.html +16 -10
- data/site/news/2018/02/24/jekyll-3-7-3-released/index.html +22 -16
- data/site/news/2018/05/01/jekyll-3-8-1-released/index.html +19 -13
- data/site/news/2018/05/19/jekyll-3-8-2-released/index.html +17 -11
- data/site/news/2018/06/05/jekyll-3-8-3-released/index.html +19 -13
- data/site/news/2019/07/02/jekyll-3-8-6-released/index.html +623 -0
- data/site/news/index.html +263 -218
- data/site/news/releases/index.html +261 -216
- data/site/philosophy.html +1 -1
- data/site/sitemap.xml +61 -57
- data/site/team/index.html +7 -6
- data/site/tutorials/convert-site-to-jekyll/index.html +97 -96
- data/site/tutorials/custom-404-page/index.html +16 -15
- data/site/tutorials/home/index.html +10 -9
- data/site/tutorials/navigation/index.html +102 -101
- data/site/tutorials/orderofinterpretation/index.html +32 -31
- data/site/tutorials/using-jekyll-with-bundler/index.html +19 -18
- data/site/tutorials/video-walkthroughs/index.html +8 -7
- metadata +10 -24
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
<head>
|
|
4
4
|
<meta charset="UTF-8">
|
|
5
5
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
6
|
-
<meta name="generator" content="Jekyll v3.
|
|
6
|
+
<meta name="generator" content="Jekyll v3.9.0">
|
|
7
7
|
<link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
|
|
8
8
|
<link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
|
|
9
9
|
<link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
|
|
@@ -11,9 +11,9 @@
|
|
|
11
11
|
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
|
|
12
12
|
<link rel="stylesheet" href="/css/screen.css">
|
|
13
13
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
|
14
|
-
<!-- Begin Jekyll SEO tag v2.
|
|
14
|
+
<!-- Begin Jekyll SEO tag v2.6.1 -->
|
|
15
15
|
<title>Special Labels | Jekyll • Simple, blog-aware, static sites</title>
|
|
16
|
-
<meta name="generator" content="Jekyll v3.
|
|
16
|
+
<meta name="generator" content="Jekyll v3.9.0" />
|
|
17
17
|
<meta property="og:title" content="Special Labels" />
|
|
18
18
|
<meta property="og:locale" content="en_US" />
|
|
19
19
|
<meta name="description" content="This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone." />
|
|
@@ -22,12 +22,13 @@
|
|
|
22
22
|
<meta property="og:url" content="https://jekyllrb.com/docs/maintaining/special-labels/" />
|
|
23
23
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
|
|
24
24
|
<meta property="og:type" content="article" />
|
|
25
|
-
<meta property="article:published_time" content="
|
|
25
|
+
<meta property="article:published_time" content="2020-08-05T11:55:36-07:00" />
|
|
26
26
|
<meta name="twitter:card" content="summary" />
|
|
27
|
+
<meta property="twitter:title" content="Special Labels" />
|
|
27
28
|
<meta name="twitter:site" content="@jekyllrb" />
|
|
28
29
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
|
|
29
30
|
<script type="application/ld+json">
|
|
30
|
-
{"headline":"Special Labels","dateModified":"
|
|
31
|
+
{"url":"https://jekyllrb.com/docs/maintaining/special-labels/","headline":"Special Labels","dateModified":"2020-08-05T11:55:36-07:00","datePublished":"2020-08-05T11:55:36-07:00","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/special-labels/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
|
|
31
32
|
<!-- End Jekyll SEO tag -->
|
|
32
33
|
|
|
33
34
|
<!--[if lt IE 9]>
|
|
@@ -72,7 +73,7 @@
|
|
|
72
73
|
<div class="meta hide-on-mobiles">
|
|
73
74
|
<ul>
|
|
74
75
|
<li>
|
|
75
|
-
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.
|
|
76
|
+
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
|
|
76
77
|
</li>
|
|
77
78
|
<li>
|
|
78
79
|
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
|
@@ -298,23 +299,23 @@
|
|
|
298
299
|
|
|
299
300
|
<p>We use a series of “special labels” on GitHub.com to automate handling of some parts of the pull request and issue process. <a href="https://github.com/jekyllbot" class="user-mention">@jekyllbot</a> may automatically apply or remove certain labels based on actions taken by users or maintainers. Below are the labels and how they work:</p>
|
|
300
301
|
|
|
301
|
-
<h2 id="pending-feedback"><code class="highlighter-rouge">pending-feedback</code></h2>
|
|
302
|
+
<h2 id="pending-feedback"><code class="language-plaintext highlighter-rouge">pending-feedback</code></h2>
|
|
302
303
|
|
|
303
304
|
<p>This label is used to indicate that we need more information from the issue/PR author in order to continue. It may be that you need more info before you can properly triage a bug report, or that you have some unanswered questions about a PR that need to be resolved before moving forward. You can safely ignore any issue with this label, as it is waiting for feedback.</p>
|
|
304
305
|
|
|
305
306
|
<h2 id="needs-work--pending-rebase">
|
|
306
|
-
<code class="highlighter-rouge">needs-work</code> & <code class="highlighter-rouge">pending-rebase</code>
|
|
307
|
+
<code class="language-plaintext highlighter-rouge">needs-work</code> & <code class="language-plaintext highlighter-rouge">pending-rebase</code>
|
|
307
308
|
</h2>
|
|
308
309
|
|
|
309
|
-
<p>These labels are used to indicate that the Git state of a pull request must change. Both are removed once a push is registered (a “synchronize” event for the pull request) and the pull request becomes mergable. Add <code class="highlighter-rouge">needs-work</code> to a PR if, after your review, it requires code changes. Add <code class="highlighter-rouge">pending-rebase</code> to a PR if the code is fine but the branch is not automatically mergable with the target branch (e.g. <code class="highlighter-rouge">master</code>).</p>
|
|
310
|
+
<p>These labels are used to indicate that the Git state of a pull request must change. Both are removed once a push is registered (a “synchronize” event for the pull request) and the pull request becomes mergable. Add <code class="language-plaintext highlighter-rouge">needs-work</code> to a PR if, after your review, it requires code changes. Add <code class="language-plaintext highlighter-rouge">pending-rebase</code> to a PR if the code is fine but the branch is not automatically mergable with the target branch (e.g. <code class="language-plaintext highlighter-rouge">master</code>).</p>
|
|
310
311
|
|
|
311
|
-
<h2 id="stale"><code class="highlighter-rouge">stale</code></h2>
|
|
312
|
+
<h2 id="stale"><code class="language-plaintext highlighter-rouge">stale</code></h2>
|
|
312
313
|
|
|
313
314
|
<p>This label is automatically added and removed by <a href="https://github.com/jekyllbot" class="user-mention">@jekyllbot</a> based on activity on an issue or pull request. The rules for this label are laid out in <a href="../triaging-an-issue/#staleness-and-automatic-closure">Triaging an Issue: Staleness and automatic closure</a>.</p>
|
|
314
315
|
|
|
315
|
-
<h2 id="pinned"><code class="highlighter-rouge">pinned</code></h2>
|
|
316
|
+
<h2 id="pinned"><code class="language-plaintext highlighter-rouge">pinned</code></h2>
|
|
316
317
|
|
|
317
|
-
<p>This label is for <a href="https://github.com/jekyllbot" class="user-mention">@jekyllbot</a> to ignore the age of the issue, which means that the <code class="highlighter-rouge">stale</code> label won’t be automatically added, and the issue won’t be closed after a while. This needs to be set manually, and should be set with care. (The <code class="highlighter-rouge">has-pull-request</code> label does the same thing, but shouldn’t be used to <em>only</em> keep an issue open)</p>
|
|
318
|
+
<p>This label is for <a href="https://github.com/jekyllbot" class="user-mention">@jekyllbot</a> to ignore the age of the issue, which means that the <code class="language-plaintext highlighter-rouge">stale</code> label won’t be automatically added, and the issue won’t be closed after a while. This needs to be set manually, and should be set with care. (The <code class="language-plaintext highlighter-rouge">has-pull-request</code> label does the same thing, but shouldn’t be used to <em>only</em> keep an issue open)</p>
|
|
318
319
|
|
|
319
320
|
|
|
320
321
|
|
|
@@ -629,7 +630,7 @@
|
|
|
629
630
|
<footer>
|
|
630
631
|
<div class="grid">
|
|
631
632
|
<div class="unit one-third center-on-mobiles">
|
|
632
|
-
<p>The contents of this website are <br>©
|
|
633
|
+
<p>The contents of this website are <br>© 2020 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
|
|
633
634
|
</div>
|
|
634
635
|
<div class="unit two-thirds align-right center-on-mobiles">
|
|
635
636
|
<p>
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
<head>
|
|
4
4
|
<meta charset="UTF-8">
|
|
5
5
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
6
|
-
<meta name="generator" content="Jekyll v3.
|
|
6
|
+
<meta name="generator" content="Jekyll v3.9.0">
|
|
7
7
|
<link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
|
|
8
8
|
<link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
|
|
9
9
|
<link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
|
|
@@ -11,9 +11,9 @@
|
|
|
11
11
|
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
|
|
12
12
|
<link rel="stylesheet" href="/css/screen.css">
|
|
13
13
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
|
14
|
-
<!-- Begin Jekyll SEO tag v2.
|
|
14
|
+
<!-- Begin Jekyll SEO tag v2.6.1 -->
|
|
15
15
|
<title>Triaging an Issue | Jekyll • Simple, blog-aware, static sites</title>
|
|
16
|
-
<meta name="generator" content="Jekyll v3.
|
|
16
|
+
<meta name="generator" content="Jekyll v3.9.0" />
|
|
17
17
|
<meta property="og:title" content="Triaging an Issue" />
|
|
18
18
|
<meta property="og:locale" content="en_US" />
|
|
19
19
|
<meta name="description" content="This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone." />
|
|
@@ -22,12 +22,13 @@
|
|
|
22
22
|
<meta property="og:url" content="https://jekyllrb.com/docs/maintaining/triaging-an-issue/" />
|
|
23
23
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
|
|
24
24
|
<meta property="og:type" content="article" />
|
|
25
|
-
<meta property="article:published_time" content="
|
|
25
|
+
<meta property="article:published_time" content="2020-08-05T11:55:36-07:00" />
|
|
26
26
|
<meta name="twitter:card" content="summary" />
|
|
27
|
+
<meta property="twitter:title" content="Triaging an Issue" />
|
|
27
28
|
<meta name="twitter:site" content="@jekyllrb" />
|
|
28
29
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
|
|
29
30
|
<script type="application/ld+json">
|
|
30
|
-
{"headline":"Triaging an Issue","dateModified":"
|
|
31
|
+
{"url":"https://jekyllrb.com/docs/maintaining/triaging-an-issue/","headline":"Triaging an Issue","dateModified":"2020-08-05T11:55:36-07:00","datePublished":"2020-08-05T11:55:36-07:00","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"description":"This guide is for maintainers. These special people have write access to one or more of Jekyll’s repositories and help merge the contributions of others. You may find what is written here interesting, but it’s definitely not for everyone.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/maintaining/triaging-an-issue/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
|
|
31
32
|
<!-- End Jekyll SEO tag -->
|
|
32
33
|
|
|
33
34
|
<!--[if lt IE 9]>
|
|
@@ -72,7 +73,7 @@
|
|
|
72
73
|
<div class="meta hide-on-mobiles">
|
|
73
74
|
<ul>
|
|
74
75
|
<li>
|
|
75
|
-
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.
|
|
76
|
+
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
|
|
76
77
|
</li>
|
|
77
78
|
<li>
|
|
78
79
|
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
|
@@ -310,7 +311,7 @@ Jekyll outside of its current capabilities.
|
|
|
310
311
|
<p>If the issue describes a feature request, ask:</p>
|
|
311
312
|
|
|
312
313
|
<ol>
|
|
313
|
-
<li>Is this a setting? <a href="http://ben.balter.com/2016/03/08/optimizing-for-power-users-and-edge-cases/#settings-are-a-crutch">Settings are a crutch</a> for doing “the right thing”. Settings usually point to a bad default or an edge case that could be solved easily with a plugin. Keep the <img class="emoji" title=":christmas_tree:" alt=":christmas_tree:" src="https://
|
|
314
|
+
<li>Is this a setting? <a href="http://ben.balter.com/2016/03/08/optimizing-for-power-users-and-edge-cases/#settings-are-a-crutch">Settings are a crutch</a> for doing “the right thing”. Settings usually point to a bad default or an edge case that could be solved easily with a plugin. Keep the <img class="emoji" title=":christmas_tree:" alt=":christmas_tree:" src="https://github.githubassets.com/images/icons/emoji/unicode/1f384.png" height="20" width="20"> of settings as small as possible so as not to reduce the usability of the product. We like the philosophy “decisions not options.”</li>
|
|
314
315
|
<li>Would at least 80% of users find it useful? If even a quarter of our users won’t use it, it’s very likely that the request doesn’t fit our product’s core goal.</li>
|
|
315
316
|
<li>Is there another way to accomplish the end goal of the request? Most feature requests are due to bad documentation for or understanding of a pre-existing feature. See if you can clarify the end goal of the request. What is the user trying to do? Could they accomplish that goal through another feature we already support?</li>
|
|
316
317
|
<li>Even if 80% of our users will use it, does it fit the core goal of our project? We are writing a tool for making static websites, not a swiss army knife for publishing more generally.</li>
|
|
@@ -332,19 +333,19 @@ Jekyll outside of its current capabilities.
|
|
|
332
333
|
|
|
333
334
|
<p>Is the author using a supported platform? We support the latest versions of macOS, Ubuntu, Debian, CentOS, Fedora, and Arch Linux.</p>
|
|
334
335
|
|
|
335
|
-
<p>You may close the issue immediately if the author cannot reproduce the issue on a supported platform. For Windows-related problems, leave a comment letting the user know that Windows is not officially supported, but that they may absolutely continue using the issue to communicate with folks from <code class="highlighter-rouge">@jekyll/windows</code> to further investigate. Additionally, you can point them to Jekyll Talk (https://talk.jekyllrb.com) as a means of getting support from the community.</p>
|
|
336
|
+
<p>You may close the issue immediately if the author cannot reproduce the issue on a supported platform. For Windows-related problems, leave a comment letting the user know that Windows is not officially supported, but that they may absolutely continue using the issue to communicate with folks from <code class="language-plaintext highlighter-rouge">@jekyll/windows</code> to further investigate. Additionally, you can point them to Jekyll Talk (https://talk.jekyllrb.com) as a means of getting support from the community.</p>
|
|
336
337
|
|
|
337
338
|
<p>If the user is experiencing issues with GitHub Pages or another hosted platform that we cannot reproduce, please direct them to the platform’s support channel and close the issue.</p>
|
|
338
339
|
|
|
339
340
|
<h3 id="what-they-wanted-vs-what-they-got">What they wanted vs. what they got</h3>
|
|
340
341
|
|
|
341
|
-
<p>An issue without a clear explanation of what the user got and what they were expecting to get is not an issue we can accurately respond to. If the user doesn’t provide this information, please ask for clarification and apply the <code class="highlighter-rouge">pending-feedback</code> label. This information helps us build test cases such that we do not break the behaviour again in the future. The <code class="highlighter-rouge">pending-feedback</code> label will be removed automatically once the issue author posts a reply.</p>
|
|
342
|
+
<p>An issue without a clear explanation of what the user got and what they were expecting to get is not an issue we can accurately respond to. If the user doesn’t provide this information, please ask for clarification and apply the <code class="language-plaintext highlighter-rouge">pending-feedback</code> label. This information helps us build test cases such that we do not break the behaviour again in the future. The <code class="language-plaintext highlighter-rouge">pending-feedback</code> label will be removed automatically once the issue author posts a reply.</p>
|
|
342
343
|
|
|
343
344
|
<p>Is what they wanted to get something we want to happen? Sometimes a bug report is actually masquerading as a feature request. See the guidance above for handling feature requests.</p>
|
|
344
345
|
|
|
345
346
|
<h3 id="staleness-and-automatic-closure">Staleness and automatic closure</h3>
|
|
346
347
|
|
|
347
|
-
<p><a href="https://github.com/jekyllbot" class="user-mention">@jekyllbot</a> will automatically mark issues as <code class="highlighter-rouge">stale</code> if no activity occurs for at least one month. <a href="https://github.com/jekyllbot" class="user-mention">@jekyllbot</a> leaves a comment asking for information about reproducibility in current versions. If no one responds after another month, the issue is automatically closed. This behaviour can be suppressed by setting the <a href="../maintaining/special-labels.md/#pinned"><code class="highlighter-rouge">pinned</code> label</a>.</p>
|
|
348
|
+
<p><a href="https://github.com/jekyllbot" class="user-mention">@jekyllbot</a> will automatically mark issues as <code class="language-plaintext highlighter-rouge">stale</code> if no activity occurs for at least one month. <a href="https://github.com/jekyllbot" class="user-mention">@jekyllbot</a> leaves a comment asking for information about reproducibility in current versions. If no one responds after another month, the issue is automatically closed. This behaviour can be suppressed by setting the <a href="../maintaining/special-labels.md/#pinned"><code class="language-plaintext highlighter-rouge">pinned</code> label</a>.</p>
|
|
348
349
|
|
|
349
350
|
|
|
350
351
|
|
|
@@ -659,7 +660,7 @@ Jekyll outside of its current capabilities.
|
|
|
659
660
|
<footer>
|
|
660
661
|
<div class="grid">
|
|
661
662
|
<div class="unit one-third center-on-mobiles">
|
|
662
|
-
<p>The contents of this website are <br>©
|
|
663
|
+
<p>The contents of this website are <br>© 2020 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
|
|
663
664
|
</div>
|
|
664
665
|
<div class="unit two-thirds align-right center-on-mobiles">
|
|
665
666
|
<p>
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
<head>
|
|
4
4
|
<meta charset="UTF-8">
|
|
5
5
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
6
|
-
<meta name="generator" content="Jekyll v3.
|
|
6
|
+
<meta name="generator" content="Jekyll v3.9.0">
|
|
7
7
|
<link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
|
|
8
8
|
<link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
|
|
9
9
|
<link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
|
|
@@ -11,9 +11,9 @@
|
|
|
11
11
|
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
|
|
12
12
|
<link rel="stylesheet" href="/css/screen.css">
|
|
13
13
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
|
14
|
-
<!-- Begin Jekyll SEO tag v2.
|
|
14
|
+
<!-- Begin Jekyll SEO tag v2.6.1 -->
|
|
15
15
|
<title>Blog migrations | Jekyll • Simple, blog-aware, static sites</title>
|
|
16
|
-
<meta name="generator" content="Jekyll v3.
|
|
16
|
+
<meta name="generator" content="Jekyll v3.9.0" />
|
|
17
17
|
<meta property="og:title" content="Blog migrations" />
|
|
18
18
|
<meta property="og:locale" content="en_US" />
|
|
19
19
|
<meta name="description" content="If you’re switching to Jekyll from another blogging system, Jekyll’s importers can help you with the move. To learn more about importing your site to Jekyll, visit our jekyll-import docs site." />
|
|
@@ -22,12 +22,13 @@
|
|
|
22
22
|
<meta property="og:url" content="https://jekyllrb.com/docs/migrations/" />
|
|
23
23
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
|
|
24
24
|
<meta property="og:type" content="article" />
|
|
25
|
-
<meta property="article:published_time" content="
|
|
25
|
+
<meta property="article:published_time" content="2020-08-05T11:55:36-07:00" />
|
|
26
26
|
<meta name="twitter:card" content="summary" />
|
|
27
|
+
<meta property="twitter:title" content="Blog migrations" />
|
|
27
28
|
<meta name="twitter:site" content="@jekyllrb" />
|
|
28
29
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
|
|
29
30
|
<script type="application/ld+json">
|
|
30
|
-
{"headline":"Blog migrations","dateModified":"
|
|
31
|
+
{"url":"https://jekyllrb.com/docs/migrations/","headline":"Blog migrations","dateModified":"2020-08-05T11:55:36-07:00","datePublished":"2020-08-05T11:55:36-07:00","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"description":"If you’re switching to Jekyll from another blogging system, Jekyll’s importers can help you with the move. To learn more about importing your site to Jekyll, visit our jekyll-import docs site.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/migrations/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
|
|
31
32
|
<!-- End Jekyll SEO tag -->
|
|
32
33
|
|
|
33
34
|
<!--[if lt IE 9]>
|
|
@@ -72,7 +73,7 @@
|
|
|
72
73
|
<div class="meta hide-on-mobiles">
|
|
73
74
|
<ul>
|
|
74
75
|
<li>
|
|
75
|
-
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.
|
|
76
|
+
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
|
|
76
77
|
</li>
|
|
77
78
|
<li>
|
|
78
79
|
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
|
@@ -296,7 +297,7 @@
|
|
|
296
297
|
<h1>Blog migrations</h1>
|
|
297
298
|
<p>If you’re switching to Jekyll from another blogging system, Jekyll’s importers
|
|
298
299
|
can help you with the move. To learn more about importing your site to Jekyll,
|
|
299
|
-
visit our <a href="https://import.jekyllrb.com/docs/home/"><code class="highlighter-rouge">jekyll-import</code> docs site</a>.</p>
|
|
300
|
+
visit our <a href="https://import.jekyllrb.com/docs/home/"><code class="language-plaintext highlighter-rouge">jekyll-import</code> docs site</a>.</p>
|
|
300
301
|
|
|
301
302
|
|
|
302
303
|
|
|
@@ -571,7 +572,7 @@ visit our <a href="https://import.jekyllrb.com/docs/home/"><code class="highligh
|
|
|
571
572
|
<footer>
|
|
572
573
|
<div class="grid">
|
|
573
574
|
<div class="unit one-third center-on-mobiles">
|
|
574
|
-
<p>The contents of this website are <br />©
|
|
575
|
+
<p>The contents of this website are <br />© 2020 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
|
|
575
576
|
</div>
|
|
576
577
|
<div class="unit two-thirds align-right center-on-mobiles">
|
|
577
578
|
<p>
|
data/site/docs/pages/index.html
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
<head>
|
|
4
4
|
<meta charset="UTF-8">
|
|
5
5
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
6
|
-
<meta name="generator" content="Jekyll v3.
|
|
6
|
+
<meta name="generator" content="Jekyll v3.9.0">
|
|
7
7
|
<link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
|
|
8
8
|
<link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
|
|
9
9
|
<link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
|
|
@@ -11,9 +11,9 @@
|
|
|
11
11
|
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
|
|
12
12
|
<link rel="stylesheet" href="/css/screen.css">
|
|
13
13
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
|
14
|
-
<!-- Begin Jekyll SEO tag v2.
|
|
14
|
+
<!-- Begin Jekyll SEO tag v2.6.1 -->
|
|
15
15
|
<title>Creating pages | Jekyll • Simple, blog-aware, static sites</title>
|
|
16
|
-
<meta name="generator" content="Jekyll v3.
|
|
16
|
+
<meta name="generator" content="Jekyll v3.9.0" />
|
|
17
17
|
<meta property="og:title" content="Creating pages" />
|
|
18
18
|
<meta property="og:locale" content="en_US" />
|
|
19
19
|
<meta name="description" content="In addition to writing posts, you might also want to add static pages (content that isn’t date-based) to your Jekyll site. By taking advantage of the way Jekyll copies files and directories, this is easy to do." />
|
|
@@ -22,12 +22,13 @@
|
|
|
22
22
|
<meta property="og:url" content="https://jekyllrb.com/docs/pages/" />
|
|
23
23
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
|
|
24
24
|
<meta property="og:type" content="article" />
|
|
25
|
-
<meta property="article:published_time" content="
|
|
25
|
+
<meta property="article:published_time" content="2020-08-05T11:55:36-07:00" />
|
|
26
26
|
<meta name="twitter:card" content="summary" />
|
|
27
|
+
<meta property="twitter:title" content="Creating pages" />
|
|
27
28
|
<meta name="twitter:site" content="@jekyllrb" />
|
|
28
29
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
|
|
29
30
|
<script type="application/ld+json">
|
|
30
|
-
{"headline":"Creating pages","dateModified":"
|
|
31
|
+
{"url":"https://jekyllrb.com/docs/pages/","headline":"Creating pages","dateModified":"2020-08-05T11:55:36-07:00","datePublished":"2020-08-05T11:55:36-07:00","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"description":"In addition to writing posts, you might also want to add static pages (content that isn’t date-based) to your Jekyll site. By taking advantage of the way Jekyll copies files and directories, this is easy to do.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/pages/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
|
|
31
32
|
<!-- End Jekyll SEO tag -->
|
|
32
33
|
|
|
33
34
|
<!--[if lt IE 9]>
|
|
@@ -72,7 +73,7 @@
|
|
|
72
73
|
<div class="meta hide-on-mobiles">
|
|
73
74
|
<ul>
|
|
74
75
|
<li>
|
|
75
|
-
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.
|
|
76
|
+
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
|
|
76
77
|
</li>
|
|
77
78
|
<li>
|
|
78
79
|
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
|
@@ -299,7 +300,7 @@
|
|
|
299
300
|
<h2 id="homepage">Homepage</h2>
|
|
300
301
|
|
|
301
302
|
<p>Just about every web server configuration you come across will look for an HTML
|
|
302
|
-
file called <code class="highlighter-rouge">index.html</code> (by convention) in the site’s root folder and display
|
|
303
|
+
file called <code class="language-plaintext highlighter-rouge">index.html</code> (by convention) in the site’s root folder and display
|
|
303
304
|
that as the homepage. Unless the web server you’re using is configured to look
|
|
304
305
|
for some different filename as the default, this file will turn into the
|
|
305
306
|
homepage of your Jekyll-generated site.</p>
|
|
@@ -325,7 +326,7 @@ files for each page in your site’s root folder.</li>
|
|
|
325
326
|
</ul>
|
|
326
327
|
|
|
327
328
|
<p>Both methods work fine (and can be used in conjunction with each other),
|
|
328
|
-
with the only real difference being the resulting URLs. By default, pages retain the same folder structure in <code class="highlighter-rouge">_site</code> as they do in the source directory.</p>
|
|
329
|
+
with the only real difference being the resulting URLs. By default, pages retain the same folder structure in <code class="language-plaintext highlighter-rouge">_site</code> as they do in the source directory.</p>
|
|
329
330
|
|
|
330
331
|
<h3 id="named-html-files">Named HTML files</h3>
|
|
331
332
|
|
|
@@ -346,7 +347,7 @@ and associated URLs might look like:</p>
|
|
|
346
347
|
└── contact.html <span class="c"># => http://example.com/contact.html</span>
|
|
347
348
|
</code></pre></div></div>
|
|
348
349
|
|
|
349
|
-
<p>If you have a lot of pages, you can organize those pages into subfolders. The same subfolders that are used to group your pages in our project’s source will exist in the <code class="highlighter-rouge">_site</code> folder when your site builds.</p>
|
|
350
|
+
<p>If you have a lot of pages, you can organize those pages into subfolders. The same subfolders that are used to group your pages in our project’s source will exist in the <code class="language-plaintext highlighter-rouge">_site</code> folder when your site builds.</p>
|
|
350
351
|
|
|
351
352
|
<h2 id="flattening-pages-from-subfolders-into-the-root-directory">Flattening pages from subfolders into the root directory</h2>
|
|
352
353
|
|
|
@@ -360,7 +361,7 @@ and associated URLs might look like:</p>
|
|
|
360
361
|
|
|
361
362
|
<h3 id="named-folders-containing-index-html-files">Named folders containing index HTML files</h3>
|
|
362
363
|
|
|
363
|
-
<p>If you don’t want file extensions (<code class="highlighter-rouge">.html</code>) to appear in your page URLs (file extensions are the default), you can choose a <a href="../permalinks/#builtinpermalinkstyles">permalink style</a> that has a trailing slash instead of a file extension.</p>
|
|
364
|
+
<p>If you don’t want file extensions (<code class="language-plaintext highlighter-rouge">.html</code>) to appear in your page URLs (file extensions are the default), you can choose a <a href="../permalinks/#builtinpermalinkstyles">permalink style</a> that has a trailing slash instead of a file extension.</p>
|
|
364
365
|
|
|
365
366
|
<p>Note if you want to view your site offline <em>without the Jekyll preview server</em>, your browser will need the file extension to display the page, and all assets will need to be relative links that function without the server baseurl.</p>
|
|
366
367
|
|
|
@@ -619,7 +620,7 @@ and associated URLs might look like:</p>
|
|
|
619
620
|
<footer>
|
|
620
621
|
<div class="grid">
|
|
621
622
|
<div class="unit one-third center-on-mobiles">
|
|
622
|
-
<p>The contents of this website are <br />©
|
|
623
|
+
<p>The contents of this website are <br />© 2020 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
|
|
623
624
|
</div>
|
|
624
625
|
<div class="unit two-thirds align-right center-on-mobiles">
|
|
625
626
|
<p>
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
<head>
|
|
4
4
|
<meta charset="UTF-8">
|
|
5
5
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
6
|
-
<meta name="generator" content="Jekyll v3.
|
|
6
|
+
<meta name="generator" content="Jekyll v3.9.0">
|
|
7
7
|
<link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites" />
|
|
8
8
|
<link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
|
|
9
9
|
<link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin>
|
|
@@ -11,9 +11,9 @@
|
|
|
11
11
|
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css" />
|
|
12
12
|
<link rel="stylesheet" href="/css/screen.css">
|
|
13
13
|
<link rel="icon" type="image/x-icon" href="/favicon.ico">
|
|
14
|
-
<!-- Begin Jekyll SEO tag v2.
|
|
14
|
+
<!-- Begin Jekyll SEO tag v2.6.1 -->
|
|
15
15
|
<title>Pagination | Jekyll • Simple, blog-aware, static sites</title>
|
|
16
|
-
<meta name="generator" content="Jekyll v3.
|
|
16
|
+
<meta name="generator" content="Jekyll v3.9.0" />
|
|
17
17
|
<meta property="og:title" content="Pagination" />
|
|
18
18
|
<meta property="og:locale" content="en_US" />
|
|
19
19
|
<meta name="description" content="With many websites — especially blogs — it’s very common to break the main listing of posts up into smaller lists and display them over multiple pages. Jekyll offers a pagination plugin, so you can automatically generate the appropriate files and folders you need for paginated listings." />
|
|
@@ -22,12 +22,13 @@
|
|
|
22
22
|
<meta property="og:url" content="https://jekyllrb.com/docs/pagination/" />
|
|
23
23
|
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites" />
|
|
24
24
|
<meta property="og:type" content="article" />
|
|
25
|
-
<meta property="article:published_time" content="
|
|
25
|
+
<meta property="article:published_time" content="2020-08-05T11:55:36-07:00" />
|
|
26
26
|
<meta name="twitter:card" content="summary" />
|
|
27
|
+
<meta property="twitter:title" content="Pagination" />
|
|
27
28
|
<meta name="twitter:site" content="@jekyllrb" />
|
|
28
29
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY" />
|
|
29
30
|
<script type="application/ld+json">
|
|
30
|
-
{"headline":"Pagination","dateModified":"
|
|
31
|
+
{"url":"https://jekyllrb.com/docs/pagination/","headline":"Pagination","dateModified":"2020-08-05T11:55:36-07:00","datePublished":"2020-08-05T11:55:36-07:00","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"description":"With many websites — especially blogs — it’s very common to break the main listing of posts up into smaller lists and display them over multiple pages. Jekyll offers a pagination plugin, so you can automatically generate the appropriate files and folders you need for paginated listings.","mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/pagination/"},"@type":"BlogPosting","@context":"https://schema.org"}</script>
|
|
31
32
|
<!-- End Jekyll SEO tag -->
|
|
32
33
|
|
|
33
34
|
<!--[if lt IE 9]>
|
|
@@ -72,7 +73,7 @@
|
|
|
72
73
|
<div class="meta hide-on-mobiles">
|
|
73
74
|
<ul>
|
|
74
75
|
<li>
|
|
75
|
-
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.
|
|
76
|
+
<a href="https://github.com/jekyll/jekyll/releases/tag/v3.9.0">v3.9.0</a>
|
|
76
77
|
</li>
|
|
77
78
|
<li>
|
|
78
79
|
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
|
@@ -299,8 +300,8 @@ break the main listing of posts up into smaller lists and display them over
|
|
|
299
300
|
multiple pages. Jekyll offers a pagination plugin, so you can automatically
|
|
300
301
|
generate the appropriate files and folders you need for paginated listings.</p>
|
|
301
302
|
|
|
302
|
-
<p>For Jekyll 3, include the <code class="highlighter-rouge">jekyll-paginate</code> plugin in your Gemfile and in
|
|
303
|
-
your <code class="highlighter-rouge">_config.yml</code> under <code class="highlighter-rouge">plugins</code>. For Jekyll 2, this is standard.</p>
|
|
303
|
+
<p>For Jekyll 3, include the <code class="language-plaintext highlighter-rouge">jekyll-paginate</code> plugin in your Gemfile and in
|
|
304
|
+
your <code class="language-plaintext highlighter-rouge">_config.yml</code> under <code class="language-plaintext highlighter-rouge">plugins</code>. For Jekyll 2, this is standard.</p>
|
|
304
305
|
|
|
305
306
|
<div class="note info">
|
|
306
307
|
<h5>Pagination only works within HTML files</h5>
|
|
@@ -315,10 +316,10 @@ your <code class="highlighter-rouge">_config.yml</code> under <code class="highl
|
|
|
315
316
|
|
|
316
317
|
<h2 id="enable-pagination">Enable pagination</h2>
|
|
317
318
|
|
|
318
|
-
<p>To enable pagination for posts on your blog, add a line to the <code class="highlighter-rouge">_config.yml</code> file that
|
|
319
|
+
<p>To enable pagination for posts on your blog, add a line to the <code class="language-plaintext highlighter-rouge">_config.yml</code> file that
|
|
319
320
|
specifies how many items should be displayed per page:</p>
|
|
320
321
|
|
|
321
|
-
<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">paginate</span><span class="pi">:</span> <span class="
|
|
322
|
+
<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">paginate</span><span class="pi">:</span> <span class="m">5</span>
|
|
322
323
|
</code></pre></div></div>
|
|
323
324
|
|
|
324
325
|
<p>The number should be the maximum number of Posts you’d like to be displayed
|
|
@@ -329,11 +330,11 @@ per-page in the generated site.</p>
|
|
|
329
330
|
<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">paginate_path</span><span class="pi">:</span> <span class="s2">"</span><span class="s">/blog/page:num/"</span>
|
|
330
331
|
</code></pre></div></div>
|
|
331
332
|
|
|
332
|
-
<p>This will read in <code class="highlighter-rouge">blog/index.html</code>, send it each pagination page in Liquid as
|
|
333
|
-
<code class="highlighter-rouge">paginator</code> and write the output to <code class="highlighter-rouge">blog/page:num/</code>, where <code class="highlighter-rouge">:num</code> is the
|
|
334
|
-
pagination page number, starting with <code class="highlighter-rouge">2</code>. If a site has 12 posts and specifies
|
|
335
|
-
<code class="highlighter-rouge">paginate: 5</code>, Jekyll will write <code class="highlighter-rouge">blog/index.html</code> with the first 5 posts, <code class="highlighter-rouge">blog/page2/index.html</code> with the next 5 posts
|
|
336
|
-
and <code class="highlighter-rouge">blog/page3/index.html</code> with the last 2 posts into the destination
|
|
333
|
+
<p>This will read in <code class="language-plaintext highlighter-rouge">blog/index.html</code>, send it each pagination page in Liquid as
|
|
334
|
+
<code class="language-plaintext highlighter-rouge">paginator</code> and write the output to <code class="language-plaintext highlighter-rouge">blog/page:num/</code>, where <code class="language-plaintext highlighter-rouge">:num</code> is the
|
|
335
|
+
pagination page number, starting with <code class="language-plaintext highlighter-rouge">2</code>. If a site has 12 posts and specifies
|
|
336
|
+
<code class="language-plaintext highlighter-rouge">paginate: 5</code>, Jekyll will write <code class="language-plaintext highlighter-rouge">blog/index.html</code> with the first 5 posts, <code class="language-plaintext highlighter-rouge">blog/page2/index.html</code> with the next 5 posts
|
|
337
|
+
and <code class="language-plaintext highlighter-rouge">blog/page3/index.html</code> with the last 2 posts into the destination
|
|
337
338
|
directory.</p>
|
|
338
339
|
|
|
339
340
|
<div class="note warning">
|
|
@@ -354,7 +355,7 @@ directory.</p>
|
|
|
354
355
|
|
|
355
356
|
<h2 id="liquid-attributes-available">Liquid Attributes Available</h2>
|
|
356
357
|
|
|
357
|
-
<p>The pagination plugin exposes the <code class="highlighter-rouge">paginator</code> liquid object with the following
|
|
358
|
+
<p>The pagination plugin exposes the <code class="language-plaintext highlighter-rouge">paginator</code> liquid object with the following
|
|
358
359
|
attributes:</p>
|
|
359
360
|
|
|
360
361
|
<div class="mobile-side-scroller">
|
|
@@ -438,7 +439,7 @@ attributes:</p>
|
|
|
438
439
|
<h2 id="render-the-paginated-posts">Render the paginated Posts</h2>
|
|
439
440
|
|
|
440
441
|
<p>The next thing you need to do is to actually display your posts in a list using
|
|
441
|
-
the <code class="highlighter-rouge">paginator</code> variable that will now be available to you. You’ll probably
|
|
442
|
+
the <code class="language-plaintext highlighter-rouge">paginator</code> variable that will now be available to you. You’ll probably
|
|
442
443
|
want to do this in one of the main pages of your site. Here’s one example of a
|
|
443
444
|
simple way of rendering paginated Posts in a HTML file:</p>
|
|
444
445
|
|
|
@@ -448,7 +449,7 @@ title: My Blog
|
|
|
448
449
|
---
|
|
449
450
|
|
|
450
451
|
<!-- This loops through the paginated posts -->
|
|
451
|
-
<span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span>post
|
|
452
|
+
<span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span><span class="nv">post</span><span class="w"> </span><span class="nt">in</span><span class="w"> </span><span class="nv">paginator.posts</span><span class="w"> </span><span class="p">%}</span>
|
|
452
453
|
<h1><a href="<span class="p">{{</span><span class="w"> </span><span class="nv">post</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">post</span><span class="p">.</span><span class="nv">title</span><span class="w"> </span><span class="p">}}</span></a></h1>
|
|
453
454
|
<p class="author">
|
|
454
455
|
<span class="date"><span class="p">{{</span><span class="w"> </span><span class="nv">post</span><span class="p">.</span><span class="nv">date</span><span class="w"> </span><span class="p">}}</span></span>
|
|
@@ -489,23 +490,23 @@ page with links to all but the current page.</p>
|
|
|
489
490
|
<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{%</span><span class="w"> </span><span class="kr">if</span><span class="w"> </span><span class="nv">paginator</span><span class="p">.</span><span class="nv">total_pages</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>
|
|
490
491
|
<div class="pagination">
|
|
491
492
|
<span class="p">{%</span><span class="w"> </span><span class="kr">if</span><span class="w"> </span><span class="nv">paginator</span><span class="p">.</span><span class="nv">previous_page</span><span class="w"> </span><span class="p">%}</span>
|
|
492
|
-
<a href="<span class="p">{{</span><span class="w"> </span><span class="nv">paginator</span><span class="p">.</span><span class="nv">previous_page_path</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">prepend</span><span class="p">:</span><span class="w"> </span>site
|
|
493
|
+
<a href="<span class="p">{{</span><span class="w"> </span><span class="nv">paginator</span><span class="p">.</span><span class="nv">previous_page_path</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">prepend</span><span class="p">:</span><span class="w"> </span><span class="nv">site</span><span class="p">.</span><span class="nv">baseurl</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">replace</span><span class="p">:</span><span class="w"> </span><span class="s1">'//'</span><span class="p">,</span><span class="w"> </span><span class="s1">'/'</span><span class="w"> </span><span class="p">}}</span>">&laquo; Prev</a>
|
|
493
494
|
<span class="p">{%</span><span class="w"> </span><span class="kr">else</span><span class="w"> </span><span class="p">%}</span>
|
|
494
495
|
<span>&laquo; Prev</span>
|
|
495
496
|
<span class="p">{%</span><span class="w"> </span><span class="kr">endif</span><span class="w"> </span><span class="p">%}</span>
|
|
496
497
|
|
|
497
|
-
<span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span>page
|
|
498
|
+
<span class="p">{%</span><span class="w"> </span><span class="nt">for</span><span class="w"> </span><span class="nv">page</span><span class="w"> </span><span class="nt">in</span><span class="w"> </span><span class="nv">(1..paginator.total_pages)</span><span class="w"> </span><span class="p">%}</span>
|
|
498
499
|
<span class="p">{%</span><span class="w"> </span><span class="kr">if</span><span class="w"> </span><span class="nv">page</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="nv">paginator</span><span class="p">.</span><span class="nv">page</span><span class="w"> </span><span class="p">%}</span>
|
|
499
500
|
<em><span class="p">{{</span><span class="w"> </span><span class="nv">page</span><span class="w"> </span><span class="p">}}</span></em>
|
|
500
501
|
<span class="p">{%</span><span class="w"> </span><span class="kr">elsif</span><span class="w"> </span><span class="nv">page</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>
|
|
501
|
-
<a href="<span class="p">{{</span><span class="w"> </span><span class="nv">paginator</span><span class="p">.</span><span class="nv">previous_page_path</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">prepend</span><span class="p">:</span><span class="w"> </span>site
|
|
502
|
+
<a href="<span class="p">{{</span><span class="w"> </span><span class="nv">paginator</span><span class="p">.</span><span class="nv">previous_page_path</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">prepend</span><span class="p">:</span><span class="w"> </span><span class="nv">site</span><span class="p">.</span><span class="nv">baseurl</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">replace</span><span class="p">:</span><span class="w"> </span><span class="s1">'//'</span><span class="p">,</span><span class="w"> </span><span class="s1">'/'</span><span class="w"> </span><span class="p">}}</span>"><span class="p">{{</span><span class="w"> </span><span class="nv">page</span><span class="w"> </span><span class="p">}}</span></a>
|
|
502
503
|
<span class="p">{%</span><span class="w"> </span><span class="kr">else</span><span class="w"> </span><span class="p">%}</span>
|
|
503
|
-
<a href="<span class="p">{{</span><span class="w"> </span><span class="nv">site</span><span class="p">.</span><span class="nv">paginate_path</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">prepend</span><span class="p">:</span><span class="w"> </span>site
|
|
504
|
+
<a href="<span class="p">{{</span><span class="w"> </span><span class="nv">site</span><span class="p">.</span><span class="nv">paginate_path</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">prepend</span><span class="p">:</span><span class="w"> </span><span class="nv">site</span><span class="p">.</span><span class="nv">baseurl</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">replace</span><span class="p">:</span><span class="w"> </span><span class="s1">'//'</span><span class="p">,</span><span class="w"> </span><span class="s1">'/'</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">replace</span><span class="p">:</span><span class="w"> </span><span class="s1">':num'</span><span class="p">,</span><span class="w"> </span><span class="nv">page</span><span class="w"> </span><span class="p">}}</span>"><span class="p">{{</span><span class="w"> </span><span class="nv">page</span><span class="w"> </span><span class="p">}}</span></a>
|
|
504
505
|
<span class="p">{%</span><span class="w"> </span><span class="kr">endif</span><span class="w"> </span><span class="p">%}</span>
|
|
505
506
|
<span class="p">{%</span><span class="w"> </span><span class="nt">endfor</span><span class="w"> </span><span class="p">%}</span>
|
|
506
507
|
|
|
507
508
|
<span class="p">{%</span><span class="w"> </span><span class="kr">if</span><span class="w"> </span><span class="nv">paginator</span><span class="p">.</span><span class="nv">next_page</span><span class="w"> </span><span class="p">%}</span>
|
|
508
|
-
<a href="<span class="p">{{</span><span class="w"> </span><span class="nv">paginator</span><span class="p">.</span><span class="nv">next_page_path</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">prepend</span><span class="p">:</span><span class="w"> </span>site
|
|
509
|
+
<a href="<span class="p">{{</span><span class="w"> </span><span class="nv">paginator</span><span class="p">.</span><span class="nv">next_page_path</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">prepend</span><span class="p">:</span><span class="w"> </span><span class="nv">site</span><span class="p">.</span><span class="nv">baseurl</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">replace</span><span class="p">:</span><span class="w"> </span><span class="s1">'//'</span><span class="p">,</span><span class="w"> </span><span class="s1">'/'</span><span class="w"> </span><span class="p">}}</span>">Next &raquo;</a>
|
|
509
510
|
<span class="p">{%</span><span class="w"> </span><span class="kr">else</span><span class="w"> </span><span class="p">%}</span>
|
|
510
511
|
<span>Next &raquo;</span>
|
|
511
512
|
<span class="p">{%</span><span class="w"> </span><span class="kr">endif</span><span class="w"> </span><span class="p">%}</span>
|
|
@@ -799,7 +800,7 @@ page with links to all but the current page.</p>
|
|
|
799
800
|
<footer>
|
|
800
801
|
<div class="grid">
|
|
801
802
|
<div class="unit one-third center-on-mobiles">
|
|
802
|
-
<p>The contents of this website are <br />©
|
|
803
|
+
<p>The contents of this website are <br />© 2020 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
|
|
803
804
|
</div>
|
|
804
805
|
<div class="unit two-thirds align-right center-on-mobiles">
|
|
805
806
|
<p>
|