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.
Files changed (147) hide show
  1. checksums.yaml +5 -5
  2. data/lib/jekyll-docs.rb +7 -5
  3. data/site/404.html +5 -6
  4. data/site/community/index.html +9 -297
  5. data/site/conduct/index.html +3 -2
  6. data/site/css/screen.css +1 -1
  7. data/site/docs/assets/index.html +46 -30
  8. data/site/docs/code_of_conduct/index.html +44 -28
  9. data/site/docs/collections/index.html +85 -48
  10. data/site/docs/conduct/index.html +44 -28
  11. data/site/docs/configuration/index.html +66 -35
  12. data/site/docs/continuous-integration/buddyworks/index.html +55 -39
  13. data/site/docs/continuous-integration/circleci/index.html +65 -49
  14. data/site/docs/continuous-integration/index.html +44 -28
  15. data/site/docs/continuous-integration/travis-ci/index.html +45 -29
  16. data/site/docs/contributing/index.html +53 -33
  17. data/site/docs/datafiles/index.html +71 -62
  18. data/site/docs/deployment-methods/index.html +49 -33
  19. data/site/docs/drafts/index.html +44 -28
  20. data/site/docs/extras/index.html +44 -28
  21. data/site/docs/frontmatter/index.html +55 -39
  22. data/site/docs/github-pages/index.html +107 -111
  23. data/site/docs/history/index.html +299 -115
  24. data/site/docs/home/index.html +45 -29
  25. data/site/docs/includes/index.html +51 -34
  26. data/site/docs/index.html +3 -2
  27. data/site/docs/installation/index.html +65 -49
  28. data/site/docs/maintaining/affinity-team-captain/index.html +46 -30
  29. data/site/docs/maintaining/avoiding-burnout/index.html +44 -28
  30. data/site/docs/maintaining/becoming-a-maintainer/index.html +45 -29
  31. data/site/docs/maintaining/index.html +44 -28
  32. data/site/docs/maintaining/merging-a-pull-request/index.html +45 -29
  33. data/site/docs/maintaining/reviewing-a-pull-request/index.html +45 -29
  34. data/site/docs/maintaining/special-labels/index.html +44 -28
  35. data/site/docs/maintaining/triaging-an-issue/index.html +45 -29
  36. data/site/docs/migrations/index.html +44 -28
  37. data/site/docs/pages/index.html +48 -32
  38. data/site/docs/pagination/index.html +105 -84
  39. data/site/docs/permalinks/index.html +48 -32
  40. data/site/docs/plugins/index.html +97 -58
  41. data/site/docs/posts/index.html +126 -71
  42. data/site/docs/quickstart/index.html +48 -32
  43. data/site/docs/resources/index.html +46 -29
  44. data/site/docs/sites/index.html +44 -28
  45. data/site/docs/static-files/index.html +44 -28
  46. data/site/docs/structure/index.html +44 -28
  47. data/site/docs/support/index.html +725 -0
  48. data/site/docs/templates/index.html +77 -54
  49. data/site/docs/themes/index.html +63 -37
  50. data/site/docs/troubleshooting/index.html +56 -40
  51. data/site/docs/upgrading/0-to-2/index.html +45 -29
  52. data/site/docs/upgrading/2-to-3/index.html +50 -34
  53. data/site/docs/upgrading/index.html +63 -31
  54. data/site/docs/usage/index.html +68 -44
  55. data/site/docs/variables/index.html +44 -28
  56. data/site/docs/windows/index.html +66 -54
  57. data/site/feed.xml +81 -108
  58. data/site/github.html +3 -2
  59. data/site/help/index.html +66 -46
  60. data/site/img/jekyll-sticker.jpg +0 -0
  61. data/site/img/jekylllayoutconcept.png +0 -0
  62. data/site/img/twitter-card.png +0 -0
  63. data/site/index.html +43 -27
  64. data/site/issues.html +3 -2
  65. data/site/jekyllconf/index.html +315 -0
  66. data/site/latest_version.txt +1 -1
  67. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +69 -33
  68. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +69 -33
  69. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +69 -33
  70. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +69 -33
  71. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +69 -33
  72. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +81 -45
  73. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +69 -33
  74. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +69 -33
  75. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +69 -33
  76. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +69 -33
  77. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +69 -33
  78. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +69 -33
  79. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +69 -33
  80. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +69 -33
  81. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +69 -33
  82. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +69 -33
  83. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +69 -33
  84. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +69 -33
  85. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +69 -33
  86. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +69 -33
  87. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +69 -33
  88. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +69 -33
  89. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +69 -33
  90. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +69 -33
  91. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +69 -33
  92. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +69 -33
  93. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +69 -33
  94. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +70 -34
  95. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +69 -33
  96. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +69 -33
  97. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +69 -33
  98. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +70 -34
  99. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +69 -33
  100. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +70 -34
  101. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +69 -33
  102. data/site/news/2015/10/26/jekyll-3-0-released/index.html +69 -33
  103. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +69 -33
  104. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +69 -33
  105. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +69 -33
  106. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +71 -35
  107. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +69 -33
  108. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +69 -33
  109. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +69 -33
  110. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +69 -33
  111. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +69 -33
  112. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +69 -33
  113. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +69 -33
  114. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +69 -33
  115. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +69 -33
  116. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +69 -33
  117. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +69 -33
  118. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +70 -34
  119. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +69 -33
  120. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +69 -33
  121. data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +69 -33
  122. data/site/news/2017/01/02/jekyll-3-7-0-released/index.html +626 -0
  123. data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +69 -33
  124. data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +69 -33
  125. data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +69 -33
  126. data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +69 -33
  127. data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +71 -35
  128. data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +69 -33
  129. data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +69 -33
  130. data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +69 -33
  131. data/site/news/2017/10/19/diversity-open-source/index.html +631 -0
  132. data/site/news/2017/10/21/jekyll-3-6-2-released/index.html +627 -0
  133. data/site/news/index.html +270 -49
  134. data/site/news/releases/index.html +204 -49
  135. data/site/redirects.json +1 -0
  136. data/site/sitemap.xml +77 -57
  137. data/site/tutorials/convert-site-to-jekyll/index.html +58 -31
  138. data/site/tutorials/custom-404-page/index.html +70 -42
  139. data/site/tutorials/home/index.html +53 -29
  140. data/site/tutorials/index.html +3 -2
  141. data/site/tutorials/navigation/index.html +70 -38
  142. data/site/tutorials/orderofinterpretation/index.html +61 -34
  143. data/site/tutorials/video-walkthroughs/index.html +352 -0
  144. metadata +17 -12
  145. data/site/CNAME +0 -1
  146. data/site/icomoon-selection.json +0 -96
  147. data/site/readme.md +0 -23
@@ -4,14 +4,16 @@
4
4
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
  <meta charset="UTF-8">
6
6
  <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.6.2">
7
+ <meta name="generator" content="Jekyll v3.7.0">
8
8
  <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
9
9
  <link rel="alternate" type="application/atom+xml" title="Recent commits to Jekyll’s master branch" href="https://github.com/jekyll/jekyll/commits/master.atom">
10
10
  <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsearch.js@2/dist/cdn/docsearch.min.css">
11
12
  <link rel="stylesheet" href="/css/screen.css">
12
13
  <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.3.0 -->
14
+ <!-- Begin Jekyll SEO tag v2.4.0 -->
14
15
  <title>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
- {"name":null,"description":"Transform your plain text into static websites and blogs","url":"https://jekyllrb.com/news/","headline":"News","dateModified":null,"datePublished":null,"sameAs":null,"@type":"WebPage","author":{"@type":"Person","name":"all"},"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"all"},"mainEntityOfPage":null,"@context":"http://schema.org"}</script>
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
- <nav class="mobile-nav show-on-mobiles">
41
- <ul>
42
+ <div class="flexbox">
43
+ <div class="center-on-mobiles">
44
+ <h1>
45
+ <a href="/" class="logo">
46
+ <span class="sr-only">Jekyll</span>
47
+ <img src="/img/logo-2x.png" width="140" height="65" alt="Jekyll Logo">
48
+ </a>
49
+ </h1>
50
+ </div>
51
+ <nav class="main-nav hide-on-mobiles">
52
+ <ul>
42
53
  <li class="">
43
54
  <a href="/">Home</a>
44
55
  </li>
@@ -48,29 +59,29 @@
48
59
  <li class="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
- </nav>
63
- <div class="grid">
64
- <div class="unit one-third center-on-mobiles">
65
- <h1>
66
- <a href="/">
67
- <span class="sr-only">Jekyll</span>
68
- <img src="/img/logo-2x.png" width="249" height="115" alt="Jekyll Logo">
69
- </a>
70
- </h1>
67
+ </nav>
68
+ <div class="search hide-on-mobiles">
69
+ <input type="text" id="docsearch-input" placeholder="Search the docs…">
70
+
71
71
  </div>
72
- <nav class="main-nav unit two-thirds hide-on-mobiles">
72
+ <div class="meta hide-on-mobiles">
73
73
  <ul>
74
+ <li>
75
+ <a href="https://github.com/jekyll/jekyll/releases/tag/v3.7.0">v3.7.0</a>
76
+ </li>
77
+ <li>
78
+ <a href="https://github.com/jekyll/jekyll">GitHub</a>
79
+ </li>
80
+ </ul>
81
+ </div>
82
+ </div>
83
+ <nav class="mobile-nav show-on-mobiles">
84
+ <ul>
74
85
  <li class="">
75
86
  <a href="/">Home</a>
76
87
  </li>
@@ -80,9 +91,6 @@
80
91
  <li class="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
- </nav>
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&amp;s=24" alt="dirtyf" srcset="https://avatars3.githubusercontent.com/dirtyf?v=3&amp;s=24 1x, https://avatars3.githubusercontent.com/dirtyf?v=3&amp;s=48 2x, https://avatars3.githubusercontent.com/dirtyf?v=3&amp;s=72 3x, https://avatars3.githubusercontent.com/dirtyf?v=3&amp;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&amp;s=24" alt="pup" srcset="https://avatars2.githubusercontent.com/pup?v=3&amp;s=24 1x, https://avatars2.githubusercontent.com/pup?v=3&amp;s=48 2x, https://avatars2.githubusercontent.com/pup?v=3&amp;s=72 3x, https://avatars2.githubusercontent.com/pup?v=3&amp;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" align="absmiddle"></p>
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" align="absmiddle"></p>
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&amp;s=24" alt="DirtyF" srcset="https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=24 1x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=48 2x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;s=72 3x, https://avatars1.githubusercontent.com/DirtyF?v=3&amp;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" align="absmiddle">. Sorry about that!</p>
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" align="absmiddle"> <img class="emoji" title=":bug:" alt=":bug:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20" align="absmiddle"> <img class="emoji" title=":bug:" alt=":bug:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f41b.png" height="20" width="20" align="absmiddle"> noticed by a few
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" align="absmiddle"></p>
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-help">let us know</a>.</p>
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="https://github.com/jekyll/jekyll-help">jekyll help team is here for
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 the nasty
3097
- excerpt inception bug (<a href="https://github.com/jekyll/jekyll/issues/1339">#1339</a>) and non-zero exit codes for invalid commands
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>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 shipped with
3105
- v1.1.0!</a></p>
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>See the <a href="https://github.com/jekyll/jekyll/releases/tag/v1.1.1">GitHub Release</a> page for more a more detailed changelog for this release.</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>© 2017 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
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>