jekyll-docs 3.6.2.0 → 3.7.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/lib/jekyll-docs.rb +7 -5
- data/site/404.html +5 -6
- data/site/community/index.html +9 -297
- data/site/conduct/index.html +3 -2
- data/site/css/screen.css +1 -1
- data/site/docs/assets/index.html +46 -30
- data/site/docs/code_of_conduct/index.html +44 -28
- data/site/docs/collections/index.html +85 -48
- data/site/docs/conduct/index.html +44 -28
- data/site/docs/configuration/index.html +66 -35
- data/site/docs/continuous-integration/buddyworks/index.html +55 -39
- data/site/docs/continuous-integration/circleci/index.html +65 -49
- data/site/docs/continuous-integration/index.html +44 -28
- data/site/docs/continuous-integration/travis-ci/index.html +45 -29
- data/site/docs/contributing/index.html +53 -33
- data/site/docs/datafiles/index.html +71 -62
- data/site/docs/deployment-methods/index.html +49 -33
- data/site/docs/drafts/index.html +44 -28
- data/site/docs/extras/index.html +44 -28
- data/site/docs/frontmatter/index.html +55 -39
- data/site/docs/github-pages/index.html +107 -111
- data/site/docs/history/index.html +299 -115
- data/site/docs/home/index.html +45 -29
- data/site/docs/includes/index.html +51 -34
- data/site/docs/index.html +3 -2
- data/site/docs/installation/index.html +65 -49
- data/site/docs/maintaining/affinity-team-captain/index.html +46 -30
- data/site/docs/maintaining/avoiding-burnout/index.html +44 -28
- data/site/docs/maintaining/becoming-a-maintainer/index.html +45 -29
- data/site/docs/maintaining/index.html +44 -28
- data/site/docs/maintaining/merging-a-pull-request/index.html +45 -29
- data/site/docs/maintaining/reviewing-a-pull-request/index.html +45 -29
- data/site/docs/maintaining/special-labels/index.html +44 -28
- data/site/docs/maintaining/triaging-an-issue/index.html +45 -29
- data/site/docs/migrations/index.html +44 -28
- data/site/docs/pages/index.html +48 -32
- data/site/docs/pagination/index.html +105 -84
- data/site/docs/permalinks/index.html +48 -32
- data/site/docs/plugins/index.html +97 -58
- data/site/docs/posts/index.html +126 -71
- data/site/docs/quickstart/index.html +48 -32
- data/site/docs/resources/index.html +46 -29
- data/site/docs/sites/index.html +44 -28
- data/site/docs/static-files/index.html +44 -28
- data/site/docs/structure/index.html +44 -28
- data/site/docs/support/index.html +725 -0
- data/site/docs/templates/index.html +77 -54
- data/site/docs/themes/index.html +63 -37
- data/site/docs/troubleshooting/index.html +56 -40
- data/site/docs/upgrading/0-to-2/index.html +45 -29
- data/site/docs/upgrading/2-to-3/index.html +50 -34
- data/site/docs/upgrading/index.html +63 -31
- data/site/docs/usage/index.html +68 -44
- data/site/docs/variables/index.html +44 -28
- data/site/docs/windows/index.html +66 -54
- data/site/feed.xml +81 -108
- data/site/github.html +3 -2
- data/site/help/index.html +66 -46
- data/site/img/jekyll-sticker.jpg +0 -0
- data/site/img/jekylllayoutconcept.png +0 -0
- data/site/img/twitter-card.png +0 -0
- data/site/index.html +43 -27
- data/site/issues.html +3 -2
- data/site/jekyllconf/index.html +315 -0
- data/site/latest_version.txt +1 -1
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +69 -33
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +69 -33
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +69 -33
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +69 -33
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +69 -33
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +81 -45
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +69 -33
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +69 -33
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +69 -33
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +69 -33
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +69 -33
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +69 -33
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +69 -33
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +69 -33
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +69 -33
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +69 -33
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +69 -33
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +69 -33
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +69 -33
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +69 -33
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +69 -33
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +69 -33
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +69 -33
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +69 -33
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +69 -33
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +69 -33
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +69 -33
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +70 -34
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +69 -33
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +69 -33
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +69 -33
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +70 -34
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +69 -33
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +70 -34
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +69 -33
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +69 -33
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +69 -33
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +69 -33
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +69 -33
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +71 -35
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +69 -33
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +69 -33
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +69 -33
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +69 -33
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +69 -33
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +69 -33
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +69 -33
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +69 -33
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +69 -33
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +69 -33
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +69 -33
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +70 -34
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +69 -33
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +69 -33
- data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +69 -33
- data/site/news/2017/01/02/jekyll-3-7-0-released/index.html +626 -0
- data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +69 -33
- data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +69 -33
- data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +69 -33
- data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +69 -33
- data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +71 -35
- data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +69 -33
- data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +69 -33
- data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +69 -33
- data/site/news/2017/10/19/diversity-open-source/index.html +631 -0
- data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +627 -0
- data/site/news/index.html +270 -49
- data/site/news/releases/index.html +204 -49
- data/site/redirects.json +1 -0
- data/site/sitemap.xml +77 -57
- data/site/tutorials/convert-site-to-jekyll/index.html +58 -31
- data/site/tutorials/custom-404-page/index.html +70 -42
- data/site/tutorials/home/index.html +53 -29
- data/site/tutorials/index.html +3 -2
- data/site/tutorials/navigation/index.html +70 -38
- data/site/tutorials/orderofinterpretation/index.html +61 -34
- data/site/tutorials/video-walkthroughs/index.html +352 -0
- metadata +17 -12
- data/site/CNAME +0 -1
- data/site/icomoon-selection.json +0 -96
- data/site/readme.md +0 -23
data/site/news/index.html
CHANGED
@@ -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>News | Jekyll • Simple, blog-aware, static sites</title>
|
16
|
+
<meta name="generator" content="Jekyll v3.7.0">
|
15
17
|
<meta property="og:title" content="News">
|
16
18
|
<meta name="author" content="all">
|
17
19
|
<meta property="og:locale" content="en_US">
|
@@ -25,7 +27,7 @@
|
|
25
27
|
<meta name="twitter:creator" content="@all">
|
26
28
|
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
|
27
29
|
<script type="application/ld+json">
|
28
|
-
{"
|
30
|
+
{"headline":"News","author":{"@type":"Person","name":"all"},"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"url":"https://jekyllrb.com/news/","description":"Transform your plain text into static websites and blogs","@type":"WebPage","@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="current">
|
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="current">
|
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
|
|
@@ -105,6 +112,10 @@
|
|
105
112
|
<option value="/news/">Home</option>
|
106
113
|
<optgroup label="v1.x">
|
107
114
|
|
115
|
+
<option value="/news/2017/10/21/jekyll-3-6-2-released/">Jekyll 3.6.2 Released</option>
|
116
|
+
|
117
|
+
<option value="/news/2017/10/19/diversity-open-source/">Diversity in Open Source, and Jekyll's role in it</option>
|
118
|
+
|
108
119
|
<option value="/news/2017/09/21/jekyll-3-6-0-released/">Jekyll turns 3.6!</option>
|
109
120
|
|
110
121
|
<option value="/news/2017/08/12/jekyll-3-5-2-released/">Jekyll 3.5.2 Released</option>
|
@@ -121,6 +132,8 @@
|
|
121
132
|
|
122
133
|
<option value="/news/2017/01/18/jekyll-3-4-0-released/">Jekyll turns 3.4.0</option>
|
123
134
|
|
135
|
+
<option value="/news/2017/01/02/jekyll-3-7-0-released/">Jekyll 3.7.0 Released</option>
|
136
|
+
|
124
137
|
<option value="/news/2016/11/14/jekyll-3-3-1-released/">Jekyll 3.3.1 Released</option>
|
125
138
|
|
126
139
|
<option value="/news/2016/10/06/jekyll-3-3-is-here/">Jekyll 3.3 is here with better theme support, new URL filters, and tons more</option>
|
@@ -238,6 +251,134 @@
|
|
238
251
|
|
239
252
|
<div class="unit four-fifths">
|
240
253
|
|
254
|
+
<article>
|
255
|
+
<h2>
|
256
|
+
<a href="/news/2017/10/21/jekyll-3-6-2-released/">
|
257
|
+
Jekyll 3.6.2 Released
|
258
|
+
</a>
|
259
|
+
</h2>
|
260
|
+
<span class="post-category">
|
261
|
+
<span class="label">
|
262
|
+
release
|
263
|
+
</span>
|
264
|
+
</span>
|
265
|
+
<div class="post-meta">
|
266
|
+
<span class="post-date">
|
267
|
+
21 Oct 2017
|
268
|
+
</span>
|
269
|
+
<a href="https://github.com/dirtyf" class="post-author">
|
270
|
+
|
271
|
+
<img class="avatar avatar-small" src="https://avatars3.githubusercontent.com/dirtyf?v=3&s=24" alt="dirtyf" srcset="https://avatars3.githubusercontent.com/dirtyf?v=3&s=24 1x, https://avatars3.githubusercontent.com/dirtyf?v=3&s=48 2x, https://avatars3.githubusercontent.com/dirtyf?v=3&s=72 3x, https://avatars3.githubusercontent.com/dirtyf?v=3&s=96 4x" width="24" height="24" data-proofer-ignore="true">
|
272
|
+
dirtyf
|
273
|
+
</a>
|
274
|
+
</div>
|
275
|
+
<div class="post-content">
|
276
|
+
<p>3.6.2 is out, it’s a tiny patch release and we invite you to run <code class="highlighter-rouge">bundle update</code>
|
277
|
+
if you want to avoid possible build problems with:</p>
|
278
|
+
|
279
|
+
<ul>
|
280
|
+
<li>some UTF-8 and UTF-16 encoded files,</li>
|
281
|
+
<li>fully numeric layout names (we convert those to string for you now).</li>
|
282
|
+
</ul>
|
283
|
+
|
284
|
+
<p>Other changes include updates to our documentation, like this <a href="../tutorials/video-walkthroughs/">complete
|
285
|
+
video series by Giraffe Academy</a> aimed at
|
286
|
+
complete beginners. A big thanks to Mike for this.</p>
|
287
|
+
|
288
|
+
<p>And if you’re wondering what happened to version 3.6.1, it was just our new
|
289
|
+
release maintainer getting familiar with the release process. 😄</p>
|
290
|
+
|
291
|
+
<p>We try to release patch releases as quickly as possible and we’re already
|
292
|
+
working on the next minor version 3.7.0 that will allow you to store all your
|
293
|
+
collections in a single directory. Stay tuned.</p>
|
294
|
+
|
295
|
+
<p>Theme developers are invited to test the brand new
|
296
|
+
<a href="https://github.com/benbalter/jekyll-remote-theme"><code class="highlighter-rouge">jekyll-remote-theme</code></a> plugin
|
297
|
+
and give their feedback to <a href="https://github.com/benbalter" class="user-mention">@benbalter</a>. This plugin allows you to use any
|
298
|
+
GitHub hosted theme as a remote theme!</p>
|
299
|
+
|
300
|
+
<p>Once again, many thanks to our contributors who helped make this release possible:
|
301
|
+
ashmaroli, bellvat, Frank Taillandier, i-give-up, Jan Piotrowski, Maximiliano
|
302
|
+
Kotvinsky, Oliver Steele and Pat Hawks. For some it was their <a href="/news/2017/10/19/diversity-open-source/">first
|
303
|
+
contribution to open-source</a> 👏</p>
|
304
|
+
|
305
|
+
<p>As it’s been nine years this week that Tom Preston-Werner started this project,
|
306
|
+
I also wanna seize this opportunity to thank <a href="https://github.com/jekyll/jekyll/graphs/contributors">all of the 732 contributors</a> who
|
307
|
+
helped make it possible for Jekyll to power millions of websites around the world
|
308
|
+
today.</p>
|
309
|
+
|
310
|
+
<p>Happy Birthday Jekyll! 🎂</p>
|
311
|
+
|
312
|
+
</div>
|
313
|
+
</article>
|
314
|
+
|
315
|
+
|
316
|
+
<article>
|
317
|
+
<h2>
|
318
|
+
<a href="/news/2017/10/19/diversity-open-source/">
|
319
|
+
Diversity in Open Source, and Jekyll's role in it
|
320
|
+
</a>
|
321
|
+
</h2>
|
322
|
+
<span class="post-category">
|
323
|
+
<span class="label">
|
324
|
+
community
|
325
|
+
</span>
|
326
|
+
</span>
|
327
|
+
<div class="post-meta">
|
328
|
+
<span class="post-date">
|
329
|
+
19 Oct 2017
|
330
|
+
</span>
|
331
|
+
<a href="https://github.com/pup" class="post-author">
|
332
|
+
|
333
|
+
<img class="avatar avatar-small" src="https://avatars2.githubusercontent.com/pup?v=3&s=24" alt="pup" srcset="https://avatars2.githubusercontent.com/pup?v=3&s=24 1x, https://avatars2.githubusercontent.com/pup?v=3&s=48 2x, https://avatars2.githubusercontent.com/pup?v=3&s=72 3x, https://avatars2.githubusercontent.com/pup?v=3&s=96 4x" width="24" height="24" data-proofer-ignore="true">
|
334
|
+
pup
|
335
|
+
</a>
|
336
|
+
</div>
|
337
|
+
<div class="post-content">
|
338
|
+
<p>Open Source has a problem with diversity. GitHub recently conducted a <a href="http://opensourcesurvey.org/2017">survey</a> which revealed that 95% of the respondents were identifying as male. This is even worse than in the tech industry overall, where the percentage is only about 76%. Every other week, there seems to be another case of a maintainer engaging in targeted harassment against minorities. People somehow deem it completely okay to let these things slide, though.</p>
|
339
|
+
|
340
|
+
<p>Fortunately, there’s a couple of things we can do to make it easier and more comfortable for people that have never contributed to any open source project before, to contribute to our projects.</p>
|
341
|
+
|
342
|
+
<h2 id="add-a-code-of-conduct-and-enforce-it">Add a Code of Conduct, and enforce it</h2>
|
343
|
+
|
344
|
+
<p>This might seem like one of the easiest steps to do, but it actually requires a lot of dedication to pull through with. Basically, a Code of Conduct is a document detailing what is and what isn’t acceptable behavior in your project. A good Code of Conduct also details enforcement procedures, that means how the person violating the Code of Conduct gets dealt with. This is the point at which I’ve seen a looooot of projects fail. It’s easy enough to copy-paste a Code of Conduct into your project, but it’s more important to be clear on how to enforce it. Inconsistent —or worse, nonexistent— enforcement is just going to scare off newcomers even more!</p>
|
345
|
+
|
346
|
+
<p>The most widely adopted Code of Conduct is the <a href="https://www.contributor-covenant.org/">Contributor Covenant</a>. It’s a very good catch-all document, but it is a bit light in the enforcement section, so I’d recommend to flesh it out by yourself, be it by means of adding contact information or expanding the enforcement rules.</p>
|
347
|
+
|
348
|
+
<p>No matter which Code of Conduct you pick, the most important thing is to actually <em>read it for yourself</em>. The worst thing in open source is a maintainer that doesn’t know when they’ve violated their own Code of Conduct.</p>
|
349
|
+
|
350
|
+
<h2 id="document-your-contributing-workflow">Document your contributing workflow</h2>
|
351
|
+
|
352
|
+
<p>The problem that puts people off the most is incomplete or missing documentation, as revealed through GitHub’s <a href="http://opensourcesurvey.org/2017">open source survey</a>. A very popular myth in programming is that good code explains itself, which might be true, but only for the person writing it. It’s important, especially once you put your project out there for the world to see, to document not only your code, but also the process by which you maintain it. Otherwise, it’s going to be extremely hard for newcomers to even figure out where to begin contributing to your project.</p>
|
353
|
+
|
354
|
+
<p>Jekyll has <a href="/docs/contributing">an entire section of its docs</a> dedicated to information on how to contribute for this very reason. Every documentation page has a link to directly edit and improve it on GitHub. It’s also important to realize that not all contributions are code. It can be documentation, it can be reviewing pull requests, but it can also just be weighing into issues, and all of this should be recognized in the same way. At Jekyll, out of 397 total merged pull requests in the last year, <strong>204</strong> were documentation pull requests!</p>
|
355
|
+
|
356
|
+
<h2 id="create-newcomer-friendly-issues">Create newcomer-friendly issues</h2>
|
357
|
+
|
358
|
+
<p>For most people new to open source, the biggest hurdle is creating their first pull request. That’s why initiatives such as <a href="https://twitter.com/yourfirstpr">YourFirstPR</a> and <a href="http://www.firsttimersonly.com/">First Timers Only</a> were started. Recently, <a href="https://github.com/hoodiehq/first-timers-bot">a GitHub bot that automatically creates first-timer friendly issues</a> was launched, which makes it very easy for maintainers to convert otherwise small or trivial changes into viable pull requests that can be taken on by newcomers! So we decided to give it a shot, and we’ve created a couple of very easy <code class="highlighter-rouge">first timers only</code> issues:</p>
|
359
|
+
|
360
|
+
<ul>
|
361
|
+
<li><a href="https://github.com/jekyll/jekyll/issues/6437">Issue #6437</a></li>
|
362
|
+
<li><a href="https://github.com/jekyll/jekyll/issues/6438">Issue #6438</a></li>
|
363
|
+
<li><a href="https://github.com/jekyll/jekyll/issues/6439">Issue #6439</a></li>
|
364
|
+
</ul>
|
365
|
+
|
366
|
+
<p>(There’s also an up-to-date listing of all of our <code class="highlighter-rouge">first timers only</code> issues <a href="https://github.com/jekyll/jekyll/issues?q=is%3Aissue+is%3Aopen+label%3Afirst-time-only">here</a>)</p>
|
367
|
+
|
368
|
+
<p>These issues are designed to be taken on only by someone who has had little to no exposure to contributing to open source before, and additionally, project maintainers offer support in case a question arises.</p>
|
369
|
+
|
370
|
+
<p>Jekyll is a very big and popular open source project, and we hope that with these special issues, we can help people who haven’t contributed to open source before to catch a footing in these unsteady waters.</p>
|
371
|
+
|
372
|
+
<h2 id="be-nice">Be nice</h2>
|
373
|
+
|
374
|
+
<p>I know this is a cliche and a overused phrase, but really, it works if you pull through with it. Come to terms with the fact that some people aren’t as fast or reliable as you might want to think. Don’t get angry when a contributor takes a day longer than you might like them to. Treat new contributors to your project with respect, but also with hospitality. Think twice before you send that comment with slurs in it.</p>
|
375
|
+
|
376
|
+
<p>I’ve been contributing to open source for about 4 years now, and I’ve had my fair share of horrible, horrible experiences. But Jekyll has historically been a project that has always valued the people contributing to it over the code itself, and I hope we can keep it that way. I also hope that other project maintainers read this and take inspiration from this post. Every project should be more diverse.</p>
|
377
|
+
|
378
|
+
</div>
|
379
|
+
</article>
|
380
|
+
|
381
|
+
|
241
382
|
<article>
|
242
383
|
<h2>
|
243
384
|
<a href="/news/2017/09/21/jekyll-3-6-0-released/">
|
@@ -410,9 +551,9 @@ Thank you, all!</p>
|
|
410
551
|
|
411
552
|
<p>Please file any bugs with detailed replication instructions if you find any
|
412
553
|
bugs. Better yet, submit a patch if you find the bug in the code and know
|
413
|
-
how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/2764.png" height="20" width="20"
|
554
|
+
how to fix it! <img class="emoji" title=":heart:" alt=":heart:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/2764.png" height="20" width="20"></p>
|
414
555
|
|
415
|
-
<p>Happy Jekylling! <img class="emoji" title=":tada:" alt=":tada:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f389.png" height="20" width="20"
|
556
|
+
<p>Happy Jekylling! <img class="emoji" title=":tada:" alt=":tada:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f389.png" height="20" width="20"></p>
|
416
557
|
|
417
558
|
</div>
|
418
559
|
</article>
|
@@ -735,6 +876,67 @@ those already.</p>
|
|
735
876
|
</article>
|
736
877
|
|
737
878
|
|
879
|
+
<article>
|
880
|
+
<h2>
|
881
|
+
<a href="/news/2017/01/02/jekyll-3-7-0-released/">
|
882
|
+
Jekyll 3.7.0 Released
|
883
|
+
</a>
|
884
|
+
</h2>
|
885
|
+
<span class="post-category">
|
886
|
+
<span class="label">
|
887
|
+
release
|
888
|
+
</span>
|
889
|
+
</span>
|
890
|
+
<div class="post-meta">
|
891
|
+
<span class="post-date">
|
892
|
+
02 Jan 2017
|
893
|
+
</span>
|
894
|
+
<a href="https://github.com/DirtyF" class="post-author">
|
895
|
+
|
896
|
+
<img class="avatar avatar-small" src="https://avatars1.githubusercontent.com/DirtyF?v=3&s=24" alt="DirtyF" srcset="https://avatars1.githubusercontent.com/DirtyF?v=3&s=24 1x, https://avatars1.githubusercontent.com/DirtyF?v=3&s=48 2x, https://avatars1.githubusercontent.com/DirtyF?v=3&s=72 3x, https://avatars1.githubusercontent.com/DirtyF?v=3&s=96 4x" width="24" height="24" data-proofer-ignore="true">
|
897
|
+
DirtyF
|
898
|
+
</a>
|
899
|
+
</div>
|
900
|
+
<div class="post-content">
|
901
|
+
<p>We’re happy to release a new minor for the new year.
|
902
|
+
Here are a few of the latest additions from our contributors:</p>
|
903
|
+
|
904
|
+
<ul>
|
905
|
+
<li>LiveReload is available as an option during development: with <code class="highlighter-rouge">jekyll serve --livereload</code> no more manual page refresh. A big thanks to <a href="https://github.com/awood" class="user-mention">@awood</a> for this feature and to <a href="https://github.com/andreyvit" class="user-mention">@andreyvit</a>, LiveReload author.</li>
|
906
|
+
<li>New <code class="highlighter-rouge">collections_dir</code> configuration option allows you to store all your <a href="/docs/collections">collections</a> in a single folder. Your source root folder should now look cleaner <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/2728.png" height="20" width="20"> .</li>
|
907
|
+
<li>If you’re using a <a href="/docs/themes/">gem-based theme</a> in coordination with the <code class="highlighter-rouge">--incremental</code> option, you should notice some significant speed during the regeneration process, we did see build time went down <strong>from 12s to 2s</strong> with <a href="https://github.com/mmistakes" class="user-mention">@mmistakes</a> <a href="https://github.com/mmistakes/minimal-mistakes">minimal-mistakes theme</a> during our tests.</li>
|
908
|
+
<li>Jekyll will now check to determine whether host machine has internet connection.</li>
|
909
|
+
<li>A new <code class="highlighter-rouge">latin</code> option is available to better <a href="/docs/templates/#options-for-the-slugify-filter">handle URLs slugs</a>.</li>
|
910
|
+
<li>And of course many bug fixes and updates to our documentation — which you can now search thanks to our friends <a href="https://github.com/Algolia" class="user-mention">@Algolia</a>.</li>
|
911
|
+
<li>
|
912
|
+
<a href="(/docs/history/#v3-7-0)">Full history is here</a>.</li>
|
913
|
+
</ul>
|
914
|
+
|
915
|
+
<p>This release wouldn’t have been possible without all the following people:</p>
|
916
|
+
|
917
|
+
<p>Aaron Borden, Alex Tsui, Alex Wood, Alexey Pelykh, Andrew Dassonville, Angelika Tyborska, Ankit Singhaniya, Ashwin Maroli, bellvat, Brandon Dusseau, Chris Finazzo, Doug Beney, Dr. Wolfram Schroers, Edward Shen, Florian Thomas, Frank Taillandier, Gert-jan Theunissen, Goulven Champenois, János Rusiczki, Jed Fox, Johannes Müller, Jon Anning, Jonathan Hooper, Jordon Bedwell, Junko Suzuki, Kacper Duras, Kenton Hansen, Kewin Dousse, Matt Rogers, Maximiliano Kotvinsky, mrHoliday, Olivia, Parker Moore, Pat Hawks, Sebastian Kulig, Vishesh Ruparelia, Xiaoiver and Yashu Mittal.</p>
|
918
|
+
|
919
|
+
<p>A big thanks to everyone!</p>
|
920
|
+
|
921
|
+
<p>Oh, one last thing…</p>
|
922
|
+
|
923
|
+
<h3 id="pray-upgrade-your-ruby">
|
924
|
+
<img class="emoji" title=":pray:" alt=":pray:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f64f.png" height="20" width="20"> upgrade your Ruby</h3>
|
925
|
+
|
926
|
+
<p>Prepare for the next major update, as next major version Jekyll 4.0 will drop support for Ruby 2.1 and 2.2.</p>
|
927
|
+
|
928
|
+
<blockquote>
|
929
|
+
<p>Ruby 2.2 is now under the state of the security maintenance phase, until the end of the March of 2018. After the date, maintenance of Ruby 2.2 will be ended. We recommend you start planning migration to newer versions of Ruby, such as 2.4 or 2.3. — <a href="https://www.ruby-lang.org/en/news/2017/12/14/ruby-2-2-9-released/">Ruby Core Team</a></p>
|
930
|
+
</blockquote>
|
931
|
+
|
932
|
+
<p>We strongly encourage you to upgrade to at least Ruby 2.4.x <a href="https://pages.github.com/versions/">like our friends at GitHub Pages</a> or even go with <a href="https://www.ruby-lang.org/en/news/2017/12/25/ruby-2-5-0-released/">Ruby 2.5</a>.</p>
|
933
|
+
|
934
|
+
<p>Happy new year to all from the Jekyll team!</p>
|
935
|
+
|
936
|
+
</div>
|
937
|
+
</article>
|
938
|
+
|
939
|
+
|
738
940
|
<article>
|
739
941
|
<h2>
|
740
942
|
<a href="/news/2016/11/14/jekyll-3-3-1-released/">
|
@@ -952,7 +1154,7 @@ prior to its release. I’m sure that they will support Jekyll Admin as much as
|
|
952
1154
|
<div class="post-content">
|
953
1155
|
<p>Well, 3.2.0 has been a success, but with one fatal flaw: it doesn’t work on
|
954
1156
|
Windows! Sorry, Windows users. Hot on the trail of 3.2.0, this release
|
955
|
-
should squash that <img class="emoji" title=":bug:" alt=":bug:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20"
|
1157
|
+
should squash that <img class="emoji" title=":bug:" alt=":bug:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20">. Sorry about that!</p>
|
956
1158
|
|
957
1159
|
<p>This release also fixes an issue when using <a href="/docs/themes/">gem-based themes</a>
|
958
1160
|
where the theme was rejected if it existed behind a symlink. This is a
|
@@ -1543,7 +1745,7 @@ you’re having.</p>
|
|
1543
1745
|
</a>
|
1544
1746
|
</div>
|
1545
1747
|
<div class="post-content">
|
1546
|
-
<p>This release squashes a few bugs <img class="emoji" title=":bug:" alt=":bug:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20"
|
1748
|
+
<p>This release squashes a few bugs <img class="emoji" title=":bug:" alt=":bug:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20"> <img class="emoji" title=":bug:" alt=":bug:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20"> <img class="emoji" title=":bug:" alt=":bug:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20"> noticed by a few
|
1547
1749
|
wonderful Jekyll users:</p>
|
1548
1750
|
|
1549
1751
|
<ul>
|
@@ -1567,7 +1769,7 @@ that</a>.</p>
|
|
1567
1769
|
<p>See links to the PR’s on <a href="/docs/history/#v3-1-1">the history page</a>.</p>
|
1568
1770
|
|
1569
1771
|
<p>Thanks to Jordon Bedwell, chrisfinazzo, Kroum Tzanev, David Celis, and
|
1570
|
-
Alfred Xing for their commits on this latest release! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/2728.png" height="20" width="20"
|
1772
|
+
Alfred Xing for their commits on this latest release! <img class="emoji" title=":sparkles:" alt=":sparkles:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/2728.png" height="20" width="20"></p>
|
1571
1773
|
|
1572
1774
|
<p>Happy Jekylling!</p>
|
1573
1775
|
|
@@ -1864,7 +2066,7 @@ improved problematic code that caused slow-downs.</li>
|
|
1864
2066
|
|
1865
2067
|
<p>To install just run:</p>
|
1866
2068
|
|
1867
|
-
<figure class="highlight"><pre><code class="language-shell" data-lang="shell"><span class="nv">$ </span>gem install jekyll <span class="nt">--pre</span></code></pre></figure>
|
2069
|
+
<figure class="highlight"><pre><code class="language-shell" data-lang="shell"><span class="nv">$ </span>gem <span class="nb">install </span>jekyll <span class="nt">--pre</span></code></pre></figure>
|
1868
2070
|
|
1869
2071
|
<p>Future versions will include <a href="https://github.com/jekyll/jekyll/issues/3324">some awesome new
|
1870
2072
|
features</a> that we haven’t
|
@@ -1950,7 +2152,7 @@ all possible! You rock.</p>
|
|
1950
2152
|
|
1951
2153
|
<p>Jekyll v2.5.3 is a quick patch release, containing some minor fixes. See the
|
1952
2154
|
<a href="/docs/history/">full history</a> for more info. If you notice any problems,
|
1953
|
-
please <a href="https://github.com/jekyll/jekyll
|
2155
|
+
please <a href="https://github.com/jekyll/jekyll">let us know</a>.</p>
|
1954
2156
|
|
1955
2157
|
<p>This release also marks the start of Jekyll 3 development. I wrote about it
|
1956
2158
|
over on my personal blog: <a href="https://byparker.com/blog/2014/jekyll-3-the-road-ahead/">Jekyll 3 — The Road Ahead</a>.
|
@@ -2134,7 +2336,7 @@ about in <a href="/docs/history/">the changelog!</a></p>
|
|
2134
2336
|
|
2135
2337
|
<p>As always, if you run into issues, please <a href="https://github.com/jekyll/jekyll/issues">check the issues</a>
|
2136
2338
|
and <a href="https://github.com/jekyll/jekyll/issues/new">create an issue if one doesn’t exist for the bug you encountered</a>.
|
2137
|
-
If you just need some help, the extraordinary <a href="
|
2339
|
+
If you just need some help, the extraordinary <a href="">jekyll help team is here for
|
2138
2340
|
you!</a></p>
|
2139
2341
|
|
2140
2342
|
<p><em>When was the <a href="https://github.com/jekyll/jekyll/commit/d189e05d236769c1e5594af9db4d6eacb86fc16e">first commit to Jekyll</a>?
|
@@ -3093,19 +3295,19 @@ and <a href="https://github.com/jekyll/jekyll/issues/1349">submitting a patch</a
|
|
3093
3295
|
</a>
|
3094
3296
|
</div>
|
3095
3297
|
<div class="post-content">
|
3096
|
-
<p>Coming just 10 days after the release of v1.1.0, v1.1.1 is out with a patch for
|
3097
|
-
excerpt inception bug (<a href="https://github.com/jekyll/jekyll/issues/1339">#1339</a>) and
|
3098
|
-
(<a href="https://github.com/jekyll/jekyll/issues/1338">#1338</a>).</p>
|
3099
|
-
|
3100
|
-
<p>To all those affected by the <a href="https://github.com/jekyll/jekyll/issues/1321">strange excerpt bug in v1.1.0</a>, I’m sorry. I think we
|
3101
|
-
have it all patched up and it should be deployed to <a href="https://pages.github.com/">GitHub Pages</a> in the next
|
3102
|
-
couple weeks. Thank you for your patience!</p>
|
3298
|
+
<p>Coming just 10 days after the release of v1.1.0, v1.1.1 is out with a patch for
|
3299
|
+
the nasty excerpt inception bug (<a href="https://github.com/jekyll/jekyll/issues/1339">#1339</a>) and
|
3300
|
+
non-zero exit codes for invalid commands (<a href="https://github.com/jekyll/jekyll/issues/1338">#1338</a>).</p>
|
3103
3301
|
|
3104
|
-
<p>
|
3105
|
-
|
3302
|
+
<p>To all those affected by the <a href="https://github.com/jekyll/jekyll/issues/1321">strange excerpt bug in v1.1.0</a>, I’m sorry. I think we have it all patched up and it should be
|
3303
|
+
deployed to <a href="https://pages.github.com/">GitHub Pages</a> in the next couple weeks.
|
3304
|
+
Thank you for your patience!</p>
|
3106
3305
|
|
3107
|
-
<p>
|
3306
|
+
<p>If you’re checking out v1.1.x for the first time, definitely check out <a href="https://github.com/jekyll/jekyll/releases/tag/v1.1.0">what
|
3307
|
+
shipped with v1.1.0!</a></p>
|
3108
3308
|
|
3309
|
+
<p>See the <a href="https://github.com/jekyll/jekyll/releases/tag/v1.1.1">GitHub Release</a> page for
|
3310
|
+
more a more detailed changelog for this release.</p>
|
3109
3311
|
|
3110
3312
|
</div>
|
3111
3313
|
</article>
|
@@ -3331,6 +3533,10 @@ examples and for compiling this list):</p>
|
|
3331
3533
|
<h4>Recent Releases</h4>
|
3332
3534
|
<ul>
|
3333
3535
|
|
3536
|
+
<li class="">
|
3537
|
+
<a href="/news/2017/10/21/jekyll-3-6-2-released/">Version 3.6.2</a>
|
3538
|
+
</li>
|
3539
|
+
|
3334
3540
|
<li class="">
|
3335
3541
|
<a href="/news/2017/09/21/jekyll-3-6-0-released/">Version 3.6.0</a>
|
3336
3542
|
</li>
|
@@ -3347,10 +3553,6 @@ examples and for compiling this list):</p>
|
|
3347
3553
|
<a href="/news/2017/06/15/jekyll-3-5-0-released/">Version 3.5.0</a>
|
3348
3554
|
</li>
|
3349
3555
|
|
3350
|
-
<li class="">
|
3351
|
-
<a href="/news/2017/03/21/jekyll-3-4-3-released/">Version 3.4.3</a>
|
3352
|
-
</li>
|
3353
|
-
|
3354
3556
|
<li>
|
3355
3557
|
<a href="/docs/history/">History »</a>
|
3356
3558
|
</li>
|
@@ -3358,6 +3560,16 @@ examples and for compiling this list):</p>
|
|
3358
3560
|
<h4>Other News</h4>
|
3359
3561
|
<ul>
|
3360
3562
|
|
3563
|
+
|
3564
|
+
|
3565
|
+
|
3566
|
+
<li class="">
|
3567
|
+
<a href="/news/2017/10/19/diversity-open-source/">Diversity in Open Source, and Jekyll's role in it</a>
|
3568
|
+
</li>
|
3569
|
+
|
3570
|
+
|
3571
|
+
|
3572
|
+
|
3361
3573
|
|
3362
3574
|
|
3363
3575
|
|
@@ -3526,7 +3738,7 @@ examples and for compiling this list):</p>
|
|
3526
3738
|
<footer>
|
3527
3739
|
<div class="grid">
|
3528
3740
|
<div class="unit one-third center-on-mobiles">
|
3529
|
-
<p>The contents of this website are <br>©
|
3741
|
+
<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>
|
3530
3742
|
</div>
|
3531
3743
|
<div class="unit two-thirds align-right center-on-mobiles">
|
3532
3744
|
<p>
|
@@ -3604,6 +3816,15 @@ examples and for compiling this list):</p>
|
|
3604
3816
|
</script>
|
3605
3817
|
|
3606
3818
|
|
3819
|
+
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.js"></script>
|
3820
|
+
<script type="text/javascript"> docsearch({
|
3821
|
+
apiKey: '50fe39c839958dfad797000f33e2ec17',
|
3822
|
+
indexName: 'jekyllrb',
|
3823
|
+
inputSelector: '#docsearch-input',
|
3824
|
+
enhancedSearchInput: true,
|
3825
|
+
debug: false // Set debug to true if you want to inspect the dropdown
|
3826
|
+
});
|
3827
|
+
</script>
|
3607
3828
|
|
3608
3829
|
</body>
|
3609
3830
|
</html>
|