jekyll-docs 3.6.0 → 3.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (253) hide show
  1. checksums.yaml +4 -4
  2. data/lib/jekyll.rb +195 -0
  3. data/lib/jekyll/cleaner.rb +110 -0
  4. data/lib/jekyll/collection.rb +230 -0
  5. data/lib/jekyll/command.rb +78 -0
  6. data/lib/jekyll/commands/build.rb +102 -0
  7. data/lib/jekyll/commands/clean.rb +43 -0
  8. data/lib/jekyll/commands/doctor.rb +153 -0
  9. data/lib/jekyll/commands/help.rb +34 -0
  10. data/lib/jekyll/commands/new.rb +156 -0
  11. data/lib/jekyll/commands/new_theme.rb +40 -0
  12. data/lib/jekyll/commands/serve.rb +245 -0
  13. data/lib/jekyll/commands/serve/servlet.rb +62 -0
  14. data/lib/jekyll/configuration.rb +410 -0
  15. data/lib/jekyll/converter.rb +54 -0
  16. data/lib/jekyll/converters/identity.rb +23 -0
  17. data/lib/jekyll/converters/markdown.rb +104 -0
  18. data/lib/jekyll/converters/markdown/kramdown_parser.rb +123 -0
  19. data/lib/jekyll/converters/markdown/rdiscount_parser.rb +35 -0
  20. data/lib/jekyll/converters/markdown/redcarpet_parser.rb +108 -0
  21. data/lib/jekyll/converters/smartypants.rb +36 -0
  22. data/lib/jekyll/convertible.rb +251 -0
  23. data/lib/jekyll/deprecator.rb +52 -0
  24. data/lib/jekyll/document.rb +507 -0
  25. data/lib/jekyll/drops/collection_drop.rb +22 -0
  26. data/lib/jekyll/drops/document_drop.rb +69 -0
  27. data/lib/jekyll/drops/drop.rb +214 -0
  28. data/lib/jekyll/drops/excerpt_drop.rb +15 -0
  29. data/lib/jekyll/drops/jekyll_drop.rb +33 -0
  30. data/lib/jekyll/drops/site_drop.rb +47 -0
  31. data/lib/jekyll/drops/static_file_drop.rb +13 -0
  32. data/lib/jekyll/drops/unified_payload_drop.rb +25 -0
  33. data/lib/jekyll/drops/url_drop.rb +88 -0
  34. data/lib/jekyll/entry_filter.rb +123 -0
  35. data/lib/jekyll/errors.rb +20 -0
  36. data/lib/jekyll/excerpt.rb +126 -0
  37. data/lib/jekyll/external.rb +74 -0
  38. data/lib/jekyll/filters.rb +430 -0
  39. data/lib/jekyll/filters/grouping_filters.rb +65 -0
  40. data/lib/jekyll/filters/url_filters.rb +60 -0
  41. data/lib/jekyll/frontmatter_defaults.rb +197 -0
  42. data/lib/jekyll/generator.rb +5 -0
  43. data/lib/jekyll/hooks.rb +104 -0
  44. data/lib/jekyll/layout.rb +62 -0
  45. data/lib/jekyll/liquid_extensions.rb +24 -0
  46. data/lib/jekyll/liquid_renderer.rb +49 -0
  47. data/lib/jekyll/liquid_renderer/file.rb +56 -0
  48. data/lib/jekyll/liquid_renderer/table.rb +96 -0
  49. data/lib/jekyll/log_adapter.rb +147 -0
  50. data/lib/jekyll/mime.types +825 -0
  51. data/lib/jekyll/page.rb +187 -0
  52. data/lib/jekyll/plugin.rb +98 -0
  53. data/lib/jekyll/plugin_manager.rb +113 -0
  54. data/lib/jekyll/publisher.rb +23 -0
  55. data/lib/jekyll/reader.rb +134 -0
  56. data/lib/jekyll/readers/collection_reader.rb +22 -0
  57. data/lib/jekyll/readers/data_reader.rb +77 -0
  58. data/lib/jekyll/readers/layout_reader.rb +71 -0
  59. data/lib/jekyll/readers/page_reader.rb +25 -0
  60. data/lib/jekyll/readers/post_reader.rb +72 -0
  61. data/lib/jekyll/readers/static_file_reader.rb +25 -0
  62. data/lib/jekyll/readers/theme_assets_reader.rb +49 -0
  63. data/lib/jekyll/regenerator.rb +201 -0
  64. data/lib/jekyll/related_posts.rb +52 -0
  65. data/lib/jekyll/renderer.rb +269 -0
  66. data/lib/jekyll/site.rb +471 -0
  67. data/lib/jekyll/static_file.rb +162 -0
  68. data/lib/jekyll/stevenson.rb +61 -0
  69. data/lib/jekyll/tags/highlight.rb +141 -0
  70. data/lib/jekyll/tags/include.rb +215 -0
  71. data/lib/jekyll/tags/link.rb +37 -0
  72. data/lib/jekyll/tags/post_url.rb +103 -0
  73. data/lib/jekyll/theme.rb +68 -0
  74. data/lib/jekyll/theme_builder.rb +119 -0
  75. data/lib/jekyll/url.rb +161 -0
  76. data/lib/jekyll/utils.rb +337 -0
  77. data/lib/jekyll/utils/ansi.rb +59 -0
  78. data/lib/jekyll/utils/exec.rb +27 -0
  79. data/lib/jekyll/utils/platforms.rb +82 -0
  80. data/lib/jekyll/utils/rouge.rb +21 -0
  81. data/lib/jekyll/utils/win_tz.rb +75 -0
  82. data/lib/jekyll/version.rb +5 -0
  83. data/lib/site_template/404.html +24 -0
  84. data/lib/site_template/_config.yml +43 -0
  85. data/lib/site_template/_posts/0000-00-00-welcome-to-jekyll.markdown.erb +25 -0
  86. data/lib/site_template/about.md +18 -0
  87. data/lib/site_template/index.md +6 -0
  88. data/lib/theme_template/CODE_OF_CONDUCT.md.erb +74 -0
  89. data/lib/theme_template/Gemfile +4 -0
  90. data/lib/theme_template/LICENSE.txt.erb +21 -0
  91. data/lib/theme_template/README.md.erb +52 -0
  92. data/lib/theme_template/_layouts/default.html +1 -0
  93. data/lib/theme_template/_layouts/page.html +5 -0
  94. data/lib/theme_template/_layouts/post.html +5 -0
  95. data/lib/theme_template/example/_config.yml.erb +1 -0
  96. data/lib/theme_template/example/_post.md +12 -0
  97. data/lib/theme_template/example/index.html +14 -0
  98. data/lib/theme_template/example/style.scss +7 -0
  99. data/lib/theme_template/gitignore.erb +5 -0
  100. data/lib/theme_template/theme.gemspec.erb +19 -0
  101. metadata +103 -156
  102. data/lib/jekyll-docs.rb +0 -31
  103. data/site/404.html +0 -153
  104. data/site/CNAME +0 -1
  105. data/site/community/index.html +0 -299
  106. data/site/conduct/index.html +0 -10
  107. data/site/css/screen.css +0 -1
  108. data/site/docs/assets/index.html +0 -724
  109. data/site/docs/code_of_conduct/index.html +0 -730
  110. data/site/docs/collections/index.html +0 -1097
  111. data/site/docs/conduct/index.html +0 -744
  112. data/site/docs/configuration/index.html +0 -1403
  113. data/site/docs/continuous-integration/buddyworks/index.html +0 -726
  114. data/site/docs/continuous-integration/circleci/index.html +0 -757
  115. data/site/docs/continuous-integration/index.html +0 -681
  116. data/site/docs/continuous-integration/travis-ci/index.html +0 -891
  117. data/site/docs/contributing/index.html +0 -863
  118. data/site/docs/datafiles/index.html +0 -780
  119. data/site/docs/deployment-methods/index.html +0 -875
  120. data/site/docs/drafts/index.html +0 -636
  121. data/site/docs/extras/index.html +0 -689
  122. data/site/docs/frontmatter/index.html +0 -807
  123. data/site/docs/github-pages/index.html +0 -819
  124. data/site/docs/history/index.html +0 -3955
  125. data/site/docs/home/index.html +0 -644
  126. data/site/docs/includes/index.html +0 -800
  127. data/site/docs/index.html +0 -10
  128. data/site/docs/installation/index.html +0 -732
  129. data/site/docs/maintaining/affinity-team-captain/index.html +0 -706
  130. data/site/docs/maintaining/avoiding-burnout/index.html +0 -709
  131. data/site/docs/maintaining/becoming-a-maintainer/index.html +0 -717
  132. data/site/docs/maintaining/index.html +0 -713
  133. data/site/docs/maintaining/merging-a-pull-request/index.html +0 -747
  134. data/site/docs/maintaining/reviewing-a-pull-request/index.html +0 -725
  135. data/site/docs/maintaining/special-labels/index.html +0 -705
  136. data/site/docs/maintaining/triaging-an-issue/index.html +0 -735
  137. data/site/docs/migrations/index.html +0 -647
  138. data/site/docs/pages/index.html +0 -695
  139. data/site/docs/pagination/index.html +0 -870
  140. data/site/docs/permalinks/index.html +0 -1027
  141. data/site/docs/plugins/index.html +0 -1800
  142. data/site/docs/posts/index.html +0 -858
  143. data/site/docs/quickstart/index.html +0 -650
  144. data/site/docs/resources/index.html +0 -769
  145. data/site/docs/sites/index.html +0 -702
  146. data/site/docs/static-files/index.html +0 -720
  147. data/site/docs/structure/index.html +0 -822
  148. data/site/docs/templates/index.html +0 -1208
  149. data/site/docs/themes/index.html +0 -935
  150. data/site/docs/troubleshooting/index.html +0 -893
  151. data/site/docs/upgrading/0-to-2/index.html +0 -826
  152. data/site/docs/upgrading/2-to-3/index.html +0 -824
  153. data/site/docs/upgrading/index.html +0 -693
  154. data/site/docs/usage/index.html +0 -705
  155. data/site/docs/variables/index.html +0 -1048
  156. data/site/docs/windows/index.html +0 -799
  157. data/site/favicon.ico +0 -0
  158. data/site/feed.xml +0 -372
  159. data/site/fonts/FontAwesome.eot +0 -0
  160. data/site/fonts/FontAwesome.svg +0 -12
  161. data/site/fonts/FontAwesome.ttf +0 -0
  162. data/site/fonts/FontAwesome.woff +0 -0
  163. data/site/github.html +0 -10
  164. data/site/help/index.html +0 -244
  165. data/site/icomoon-selection.json +0 -96
  166. data/site/img/article-footer.png +0 -0
  167. data/site/img/footer-arrow.png +0 -0
  168. data/site/img/footer-logo.png +0 -0
  169. data/site/img/jekyll-sticker.jpg +0 -0
  170. data/site/img/jekylllayoutconcept.png +0 -0
  171. data/site/img/logo-2x.png +0 -0
  172. data/site/img/logo-rss.png +0 -0
  173. data/site/img/octojekyll.png +0 -0
  174. data/site/index.html +0 -267
  175. data/site/issues.html +0 -10
  176. data/site/js/html5shiv.min.js +0 -4
  177. data/site/js/respond.min.js +0 -5
  178. data/site/latest_version.txt +0 -1
  179. data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +0 -570
  180. data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +0 -570
  181. data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +0 -571
  182. data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +0 -568
  183. data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +0 -570
  184. data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +0 -569
  185. data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +0 -565
  186. data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +0 -565
  187. data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +0 -572
  188. data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +0 -566
  189. data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +0 -564
  190. data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +0 -599
  191. data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +0 -568
  192. data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +0 -583
  193. data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +0 -565
  194. data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +0 -564
  195. data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +0 -573
  196. data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +0 -564
  197. data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +0 -569
  198. data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +0 -585
  199. data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +0 -565
  200. data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +0 -567
  201. data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +0 -582
  202. data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +0 -579
  203. data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +0 -568
  204. data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +0 -588
  205. data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +0 -574
  206. data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +0 -597
  207. data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +0 -575
  208. data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +0 -565
  209. data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +0 -572
  210. data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +0 -567
  211. data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +0 -568
  212. data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +0 -588
  213. data/site/news/2015/02/26/introducing-jekyll-talk/index.html +0 -563
  214. data/site/news/2015/10/26/jekyll-3-0-released/index.html +0 -592
  215. data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +0 -576
  216. data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +0 -566
  217. data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +0 -599
  218. data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +0 -583
  219. data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +0 -578
  220. data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +0 -569
  221. data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +0 -565
  222. data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +0 -571
  223. data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +0 -566
  224. data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +0 -572
  225. data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +0 -576
  226. data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +0 -564
  227. data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +0 -566
  228. data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +0 -567
  229. data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +0 -676
  230. data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +0 -571
  231. data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +0 -566
  232. data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +0 -645
  233. data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +0 -569
  234. data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +0 -592
  235. data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +0 -649
  236. data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +0 -598
  237. data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +0 -594
  238. data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +0 -589
  239. data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +0 -569
  240. data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +0 -573
  241. data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +0 -565
  242. data/site/news/index.html +0 -3609
  243. data/site/news/releases/index.html +0 -3344
  244. data/site/philosophy.html +0 -46
  245. data/site/readme.md +0 -23
  246. data/site/robots.txt +0 -1
  247. data/site/sitemap.xml +0 -485
  248. data/site/tutorials/convert-site-to-jekyll/index.html +0 -793
  249. data/site/tutorials/custom-404-page/index.html +0 -358
  250. data/site/tutorials/home/index.html +0 -323
  251. data/site/tutorials/index.html +0 -10
  252. data/site/tutorials/navigation/index.html +0 -872
  253. data/site/tutorials/orderofinterpretation/index.html +0 -441
data/site/news/2016/10/06/jekyll-3-3-is-here/index.html DELETED
@@ -1,645 +0,0 @@
1
- <!DOCTYPE HTML>
2
- <html lang="en-US">
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
- <meta charset="UTF-8">
6
- <meta name="viewport" content="width=device-width,initial-scale=1">
7
- <meta name="generator" content="Jekyll v3.6.0">
8
- <link type="application/atom+xml" rel="alternate" href="https://jekyllrb.com/feed.xml" title="Jekyll • Simple, blog-aware, static sites">
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
- <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Lato:300,300italic,400,400italic,700,700italic,900">
11
- <link rel="stylesheet" href="/css/screen.css">
12
- <link rel="icon" type="image/x-icon" href="/favicon.ico">
13
- <!-- Begin Jekyll SEO tag v2.3.0 -->
14
- <title>Jekyll 3.3 is here with better theme support, new URL filters, and tons more | Jekyll • Simple, blog-aware, static sites</title>
15
- <meta property="og:title" content="Jekyll 3.3 is here with better theme support, new URL filters, and tons more">
16
- <meta name="author" content="parkr">
17
- <meta property="og:locale" content="en_US">
18
- <meta name="description" content="There are tons of great new quality-of-life features you can use in 3.3. Three key things you might want to try:">
19
- <meta property="og:description" content="There are tons of great new quality-of-life features you can use in 3.3. Three key things you might want to try:">
20
- <link rel="canonical" href="https://jekyllrb.com/news/2016/10/06/jekyll-3-3-is-here/">
21
- <meta property="og:url" content="https://jekyllrb.com/news/2016/10/06/jekyll-3-3-is-here/">
22
- <meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
23
- <meta property="og:type" content="article">
24
- <meta property="article:published_time" content="2016-10-06T11:10:38-07:00">
25
- <meta name="twitter:card" content="summary">
26
- <meta name="twitter:site" content="@jekyllrb">
27
- <meta name="twitter:creator" content="@parkr">
28
- <meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
29
- <script type="application/ld+json">
30
- {"name":null,"description":"There are tons of great new quality-of-life features you can use in 3.3. Three key things you might want to try:","url":"https://jekyllrb.com/news/2016/10/06/jekyll-3-3-is-here/","headline":"Jekyll 3.3 is here with better theme support, new URL filters, and tons more","dateModified":"2016-10-06T11:10:38-07:00","datePublished":"2016-10-06T11:10:38-07:00","sameAs":null,"@type":"BlogPosting","author":{"@type":"Person","name":"parkr"},"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"},"name":"parkr"},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/news/2016/10/06/jekyll-3-3-is-here/"},"@context":"http://schema.org"}</script>
31
- <!-- End Jekyll SEO tag -->
32
-
33
- <!--[if lt IE 9]>
34
- <script src="/js/html5shiv.min.js"></script>
35
- <script src="/js/respond.min.js"></script>
36
- <![endif]-->
37
- </head>
38
-
39
-
40
- <body class="wrap">
41
- <header>
42
- <nav class="mobile-nav show-on-mobiles">
43
- <ul>
44
- <li class="">
45
- <a href="/">Home</a>
46
- </li>
47
- <li class="">
48
- <a href="/docs/home/">Docs</a>
49
- </li>
50
- <li class="current">
51
- <a href="/news/">News</a>
52
- </li>
53
- <li class="">
54
- <a href="/community/">Community</a>
55
- </li>
56
- <li class="">
57
- <a href="/help/">Help</a>
58
- </li>
59
- <li>
60
- <a href="https://github.com/jekyll/jekyll">GitHub</a>
61
- </li>
62
- </ul>
63
-
64
- </nav>
65
- <div class="grid">
66
- <div class="unit one-third center-on-mobiles">
67
- <h1>
68
- <a href="/">
69
- <span class="sr-only">Jekyll</span>
70
- <img src="/img/logo-2x.png" width="249" height="115" alt="Jekyll Logo">
71
- </a>
72
- </h1>
73
- </div>
74
- <nav class="main-nav unit two-thirds hide-on-mobiles">
75
- <ul>
76
- <li class="">
77
- <a href="/">Home</a>
78
- </li>
79
- <li class="">
80
- <a href="/docs/home/">Docs</a>
81
- </li>
82
- <li class="current">
83
- <a href="/news/">News</a>
84
- </li>
85
- <li class="">
86
- <a href="/community/">Community</a>
87
- </li>
88
- <li class="">
89
- <a href="/help/">Help</a>
90
- </li>
91
- <li>
92
- <a href="https://github.com/jekyll/jekyll">GitHub</a>
93
- </li>
94
- </ul>
95
-
96
- </nav>
97
- </div>
98
- </header>
99
-
100
-
101
- <section class="news">
102
- <div class="grid">
103
-
104
- <div class="docs-nav-mobile unit whole show-on-mobiles">
105
- <select onchange="if (this.value) window.location.href=this.value">
106
- <option value="">Navigate the blog…</option>
107
- <option value="/news/">Home</option>
108
- <optgroup label="v1.x">
109
-
110
- <option value="/news/2017/09/21/jekyll-3-6-0-released/">Jekyll turns 3.6!</option>
111
-
112
- <option value="/news/2017/08/12/jekyll-3-5-2-released/">Jekyll 3.5.2 Released</option>
113
-
114
- <option value="/news/2017/07/17/jekyll-3-5-1-released/">Jekyll 3.5.1 Released</option>
115
-
116
- <option value="/news/2017/06/15/jekyll-3-5-0-released/">Jekyll turns 3.5, oh my!</option>
117
-
118
- <option value="/news/2017/03/21/jekyll-3-4-3-released/">Jekyll 3.4.3 Released</option>
119
-
120
- <option value="/news/2017/03/09/jekyll-3-4-2-released/">Jekyll 3.4.2 Released</option>
121
-
122
- <option value="/news/2017/03/02/jekyll-3-4-1-released/">Jekyll 3.4.1, or "Unintended Consequences"</option>
123
-
124
- <option value="/news/2017/01/18/jekyll-3-4-0-released/">Jekyll turns 3.4.0</option>
125
-
126
- <option value="/news/2016/11/14/jekyll-3-3-1-released/">Jekyll 3.3.1 Released</option>
127
-
128
- <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>
129
-
130
- <option value="/news/2016/08/24/jekyll-admin-initial-release/">Jekyll Admin Initial Release</option>
131
-
132
- <option value="/news/2016/08/02/jekyll-3-2-1-released/">Jekyll 3.2.1 Released with Fix for Windows</option>
133
-
134
- <option value="/news/2016/07/26/jekyll-3-2-0-released/">Jekyll turns 3.2</option>
135
-
136
- <option value="/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/">Jekyll's Google Summer of Code Project: The CMS You Always Wanted</option>
137
-
138
- <option value="/news/2016/05/19/jekyll-3-1-6-released/">Jekyll 3.1.6 Released</option>
139
-
140
- <option value="/news/2016/05/18/jekyll-3-1-5-released/">Jekyll 3.1.5 Released</option>
141
-
142
- <option value="/news/2016/05/18/jekyll-3-1-4-released/">Jekyll 3.1.4 "Stability Sam" Released</option>
143
-
144
- <option value="/news/2016/04/26/jekyll-3-0-5-released/">Jekyll 3.0.5 Released</option>
145
-
146
- <option value="/news/2016/04/19/jekyll-3-1-3-released/">Jekyll 3.1.3 Released</option>
147
-
148
- <option value="/news/2016/04/19/jekyll-3-0-4-released/">Jekyll 3.0.4 Released</option>
149
-
150
- <option value="/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/">Making it easier to contribute to Jekyll</option>
151
-
152
- <option value="/news/2016/02/19/jekyll-3-1-2-released/">Jekyll 3.1.2 Released!</option>
153
-
154
- <option value="/news/2016/02/08/jekyll-3-0-3-released/">Jekyll 3.0.3 Released</option>
155
-
156
- <option value="/news/2016/01/28/jekyll-3-1-1-released/">Jekyll 3.1.1 Released</option>
157
-
158
- <option value="/news/2016/01/24/jekyll-3-1-0-released/">Jekyll 3.1.0 Released</option>
159
-
160
- <option value="/news/2016/01/20/jekyll-3-0-2-released/">Jekyll 3.0.2 Released</option>
161
-
162
- <option value="/news/2015/11/17/jekyll-3-0-1-released/">Jekyll 3.0.1 Released</option>
163
-
164
- <option value="/news/2015/10/26/jekyll-3-0-released/">Jekyll 3.0 Released</option>
165
-
166
- <option value="/news/2015/02/26/introducing-jekyll-talk/">Join the Discussion at Jekyll Talk</option>
167
-
168
- <option value="/news/2015/01/24/jekyll-3-0-0-beta1-released/">Jekyll 3.0.0.beta1 Released</option>
169
-
170
- <option value="/news/2015/01/20/jekyll-meet-and-greet/">Jekyll Meet &amp; Greet at GitHub HQ</option>
171
-
172
- <option value="/news/2014/12/22/jekyll-2-5-3-released/">Jekyll Release for the Holidays! v2.5.3 Out</option>
173
-
174
- <option value="/news/2014/12/17/alfredxing-welcome-to-jekyll-core/">Alfred Xing has joined the Jekyll core team</option>
175
-
176
- <option value="/news/2014/11/12/jekyll-2-5-2-released/">Jekyll 2.5.2 Released</option>
177
-
178
- <option value="/news/2014/11/09/jekyll-2-5-1-released/">Jekyll 2.5.1 Released</option>
179
-
180
- <option value="/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/">Jekyll's Mid-Life Crisis (Or, Jekyll turns 2.5.0)</option>
181
-
182
- <option value="/news/2014/09/09/jekyll-2-4-0-released/">A Wild Jekyll 2.4.0 Appeared!</option>
183
-
184
- <option value="/news/2014/08/10/jekyll-2-3-0-released/">Jekyll 2.3.0 Released</option>
185
-
186
- <option value="/news/2014/07/29/jekyll-2-2-0-released/">Jekyll 2.2.0 Released</option>
187
-
188
- <option value="/news/2014/07/01/jekyll-2-1-1-released/">Jekyll 2.1.1 Released</option>
189
-
190
- <option value="/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/">Jekyll Turns 21! Err... I mean 2.1.0.</option>
191
-
192
- <option value="/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/">Pick Up your $1 Jekyll Sticker</option>
193
-
194
- <option value="/news/2014/05/08/jekyll-2-0-3-released/">Jekyll 2.0.3 Released</option>
195
-
196
- <option value="/news/2014/05/06/jekyll-turns-2-0-0/">Jekyll turns 2.0.0</option>
197
-
198
- <option value="/news/2014/03/27/jekyll-1-5-1-released/">Jekyll 1.5.1 Released</option>
199
-
200
- <option value="/news/2014/03/24/jekyll-1-5-0-released/">Jekyll 1.5.0 Released</option>
201
-
202
- <option value="/news/2014/01/13/jekyll-1-4-3-released/">Jekyll 1.4.3 Released</option>
203
-
204
- <option value="/news/2013/12/16/jekyll-1-4-2-released/">Jekyll 1.4.2 Released</option>
205
-
206
- <option value="/news/2013/12/09/jekyll-1-4-1-released/">Jekyll 1.4.1 Released</option>
207
-
208
- <option value="/news/2013/12/07/jekyll-1-4-0-released/">Jekyll 1.4.0 Released</option>
209
-
210
- <option value="/news/2013/11/26/jekyll-1-3-1-released/">Jekyll 1.3.1 Released</option>
211
-
212
- <option value="/news/2013/11/04/jekyll-1-3-0-released/">Jekyll 1.3.0 Released</option>
213
-
214
- <option value="/news/2013/10/28/jekyll-1-3-0-rc1-released/">Jekyll 1.3.0.rc1 Released</option>
215
-
216
- <option value="/news/2013/09/14/jekyll-1-2-1-released/">Jekyll 1.2.1 Released</option>
217
-
218
- <option value="/news/2013/09/06/jekyll-1-2-0-released/">Jekyll 1.2.0 Released</option>
219
-
220
- <option value="/news/2013/07/25/jekyll-1-1-2-released/">Jekyll 1.1.2 Released</option>
221
-
222
- <option value="/news/2013/07/25/jekyll-1-0-4-released/">Jekyll 1.0.4 Released</option>
223
-
224
- <option value="/news/2013/07/24/jekyll-1-1-1-released/">Jekyll 1.1.1 Released</option>
225
-
226
- <option value="/news/2013/07/14/jekyll-1-1-0-released/">Jekyll 1.1.0 Released</option>
227
-
228
- <option value="/news/2013/06/07/jekyll-1-0-3-released/">Jekyll 1.0.3 Released</option>
229
-
230
- <option value="/news/2013/05/12/jekyll-1-0-2-released/">Jekyll 1.0.2 Released</option>
231
-
232
- <option value="/news/2013/05/08/jekyll-1-0-1-released/">Jekyll 1.0.1 Released</option>
233
-
234
- <option value="/news/2013/05/05/jekyll-1-0-0-released/">Jekyll 1.0.0 Released</option>
235
-
236
- </optgroup>
237
- </select>
238
- </div>
239
-
240
-
241
- <div class="unit four-fifths">
242
- <article>
243
- <h2>
244
- Jekyll 3.3 is here with better theme support, new URL filters, and tons more
245
- <a href="/news/2016/10/06/jekyll-3-3-is-here/" class="permalink" title="Permalink">∞</a>
246
- </h2>
247
- <span class="post-category">
248
- <span class="label">
249
- release
250
- </span>
251
- </span>
252
- <div class="post-meta">
253
- <span class="post-date">
254
- 06 Oct 2016
255
- </span>
256
- <a href="https://github.com/parkr" class="post-author">
257
- <img class="avatar avatar-small" src="https://avatars3.githubusercontent.com/parkr?v=3&amp;s=24" alt="parkr" srcset="https://avatars3.githubusercontent.com/parkr?v=3&amp;s=24 1x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=48 2x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=72 3x, https://avatars3.githubusercontent.com/parkr?v=3&amp;s=96 4x" width="24" height="24" data-proofer-ignore="true">
258
- parkr
259
- </a>
260
- </div>
261
- <div class="post-content">
262
- <p>There are tons of great new quality-of-life features you can use in 3.3.
263
- Three key things you might want to try:</p>
264
-
265
- <h3 id="1-themes-can-now-ship-static--dynamic-assets-in-an-assets-directory">1. Themes can now ship static &amp; dynamic assets in an <code class="highlighter-rouge">/assets</code> directory</h3>
266
-
267
- <p>In Jekyll 3.2, we shipped the ability to use a theme that was packaged as a
268
- <a href="http://guides.rubygems.org/">gem</a>. 3.2 included support for includes,
269
- layouts, and sass partials. In 3.3, we’re adding assets to that list.</p>
270
-
271
- <p>In an effort to make theme management a bit easier, any files you put into
272
- <code class="highlighter-rouge">/assets</code> in your theme will be read in as though they were part of the
273
- user’s site. This means you can ship SCSS and CoffeeScript, images and
274
- webfonts, and so on – anything you’d consider a part of the
275
- <em>presentation</em>. Same rules apply here as in a Jekyll site: if it has YAML
276
- front matter, it will be converted and rendered. No YAML front matter, and
277
- it will simply be copied over like a static asset.</p>
278
-
279
- <p>Note that if a user has a file of the same path, the theme content will not
280
- be included in the site, i.e. a user’s <code class="highlighter-rouge">/assets/main.scss</code> will be read and
281
- processed if present instead of a theme’s <code class="highlighter-rouge">/assets/main.scss</code>.</p>
282
-
283
- <p>See our <a href="/docs/themes/#assets">documentation on the subject</a>
284
- for more info.</p>
285
-
286
- <h3 id="2-relative_url-and-absolute_url-filters">2. <code class="highlighter-rouge">relative_url</code> and <code class="highlighter-rouge">absolute_url</code> filters</h3>
287
-
288
- <p>Want a clean way to prepend the <code class="highlighter-rouge">baseurl</code> or <code class="highlighter-rouge">url</code> in your config? These
289
- new filters have you covered. When working locally, if you set your
290
- <code class="highlighter-rouge">baseurl</code> to match your deployment environment, say <code class="highlighter-rouge">baseurl: "/myproject"</code>,
291
- then <code class="highlighter-rouge">relative_url</code> will ensure that this baseurl is prepended to anything
292
- you pass it:</p>
293
-
294
- <figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span> =&gt; /myproject/docs/assets</code></pre></figure>
295
-
296
- <p>By default, <code class="highlighter-rouge">baseurl</code> is set to <code class="highlighter-rouge">""</code> and therefore yields (never set to
297
- <code class="highlighter-rouge">"/"</code>):</p>
298
-
299
- <figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">relative_url</span><span class="w"> </span><span class="p">}}</span> =&gt; /docs/assets</code></pre></figure>
300
-
301
- <p>A result of <code class="highlighter-rouge">relative_url</code> will safely always produce a URL which is
302
- relative to the domain root. A similar principle applies to <code class="highlighter-rouge">absolute_url</code>.
303
- It prepends your <code class="highlighter-rouge">baseurl</code> and <code class="highlighter-rouge">url</code> values, making absolute URLs all the
304
- easier to make:</p>
305
-
306
- <figure class="highlight"><pre><code class="language-liquid" data-lang="liquid"><span class="p">{{</span><span class="w"> </span><span class="s2">"/docs/assets/"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nf">absolute_url</span><span class="w"> </span><span class="p">}}</span> =&gt; https://jekyllrb.com/myproject/docs/assets</code></pre></figure>
307
-
308
- <h3 id="3-siteurl-is-set-by-the-development-server">3. <code class="highlighter-rouge">site.url</code> is set by the development server</h3>
309
-
310
- <p>When you run <code class="highlighter-rouge">jekyll serve</code> locally, it starts a web server, usually at
311
- <code class="highlighter-rouge">http://localhost:4000</code>, that you use to preview your site during
312
- development. If you are using the new <code class="highlighter-rouge">absolute_url</code> filter, or using
313
- <code class="highlighter-rouge">site.url</code> anywhere, you have probably had to create a development config
314
- which resets the <code class="highlighter-rouge">url</code> value to point to <code class="highlighter-rouge">http://localhost:4000</code>.</p>
315
-
316
- <p>No longer! When you run <code class="highlighter-rouge">jekyll serve</code>, Jekyll will build your site with
317
- the value of the <code class="highlighter-rouge">host</code>, <code class="highlighter-rouge">port</code>, and SSL-related options. This defaults to
318
- <code class="highlighter-rouge">url: http://localhost:4000</code>. When you are developing locally, <code class="highlighter-rouge">site.url</code>
319
- will yield <code class="highlighter-rouge">http://localhost:4000</code>.</p>
320
-
321
- <p>This happens by default when running Jekyll locally. It will not be set if
322
- you set <code class="highlighter-rouge">JEKYLL_ENV=production</code> and run <code class="highlighter-rouge">jekyll serve</code>. If <code class="highlighter-rouge">JEKYLL_ENV</code> is
323
- any value except <code class="highlighter-rouge">development</code> (its default value), Jekyll will not
324
- overwrite the value of <code class="highlighter-rouge">url</code> in your config. And again, this only applies
325
- to serving, not to building.</p>
326
-
327
- <h2 id="a-lot-more">A <em>lot</em> more!</h2>
328
-
329
- <p>There are dozens of bug fixes and minor improvements to make your Jekyll
330
- experience better than ever. With every Jekyll release, we strive to bring
331
- greater stability and reliability to your everyday development workflow.</p>
332
-
333
- <p>As always, thanks to our many contributors who contributed countless hours
334
- of their free time to making this release happen:</p>
335
-
336
- <p>Anatoliy Yastreb, Anthony Gaudino, Antonio, Ashwin Maroli, Ben Balter,
337
- Charles Horn, Chris Finazzo, Daniel Chapman, David Zhang, Eduardo
338
- Bouças, Edward Thomson, Eloy Espinaco, Florian Thomas, Frank Taillandier,
339
- Gerardo, Heng Kwokfu, Heng, K. (Stephen), Jeff Kolesky, Jonathan Thornton,
340
- Jordon Bedwell, Jussi Kinnula, Júnior Messias, Kyle O’Brien, Manmeet Gill,
341
- Mark H. Wilkinson, Marko Locher, Mertcan GÖKGÖZ, Michal Švácha, Mike
342
- Kasberg, Nadjib Amar, Nicolas Hoizey, Nicolas Porcel, Parker Moore, Pat
343
- Hawks, Patrick Marsceill, Stephen Checkoway, Stuart Kent, XhmikosR, Zlatan
344
- Vasović, mertkahyaoglu, shingo-nakanishi, and vohedge.</p>
345
-
346
- <p><a href="/docs/history/#v3-3-0">Full release notes</a> are available
347
- for your perusal. If you notice any issues, please don’t hesitate to file a
348
- bug report.</p>
349
-
350
- <p>Happy Jekylling!</p>
351
-
352
- </div>
353
- </article>
354
-
355
- </div>
356
-
357
- <div class="unit one-fifth hide-on-mobiles">
358
- <aside>
359
- <ul>
360
- <li class="">
361
- <a href="/news/">All News</a>
362
- </li>
363
- <li class="">
364
- <a href="/news/releases/">Jekyll Releases</a>
365
- </li>
366
- </ul>
367
- <h4>Recent Releases</h4>
368
- <ul>
369
-
370
- <li class="">
371
- <a href="/news/2017/09/21/jekyll-3-6-0-released/">Version 3.6.0</a>
372
- </li>
373
-
374
- <li class="">
375
- <a href="/news/2017/08/12/jekyll-3-5-2-released/">Version 3.5.2</a>
376
- </li>
377
-
378
- <li class="">
379
- <a href="/news/2017/07/17/jekyll-3-5-1-released/">Version 3.5.1</a>
380
- </li>
381
-
382
- <li class="">
383
- <a href="/news/2017/06/15/jekyll-3-5-0-released/">Version 3.5.0</a>
384
- </li>
385
-
386
- <li class="">
387
- <a href="/news/2017/03/21/jekyll-3-4-3-released/">Version 3.4.3</a>
388
- </li>
389
-
390
- <li>
391
- <a href="/docs/history/">History »</a>
392
- </li>
393
- </ul>
394
- <h4>Other News</h4>
395
- <ul>
396
-
397
-
398
-
399
-
400
-
401
-
402
-
403
-
404
-
405
-
406
-
407
-
408
-
409
-
410
-
411
-
412
-
413
-
414
-
415
-
416
-
417
-
418
- <li class="">
419
- <a href="/news/2016/08/24/jekyll-admin-initial-release/">Jekyll Admin Initial Release</a>
420
- </li>
421
-
422
-
423
-
424
-
425
-
426
-
427
-
428
- <li class="">
429
- <a href="/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/">Jekyll's Google Summer of Code Project: The CMS You Always Wanted</a>
430
- </li>
431
-
432
-
433
-
434
-
435
-
436
-
437
-
438
-
439
-
440
-
441
-
442
-
443
-
444
-
445
-
446
- <li class="">
447
- <a href="/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/">Making it easier to contribute to Jekyll</a>
448
- </li>
449
-
450
-
451
-
452
-
453
-
454
-
455
-
456
-
457
-
458
-
459
-
460
-
461
-
462
-
463
-
464
-
465
-
466
- <li class="">
467
- <a href="/news/2015/02/26/introducing-jekyll-talk/">Join the Discussion at Jekyll Talk</a>
468
- </li>
469
-
470
-
471
-
472
-
473
-
474
- <li class="">
475
- <a href="/news/2015/01/20/jekyll-meet-and-greet/">Jekyll Meet &amp; Greet at GitHub HQ</a>
476
- </li>
477
-
478
-
479
-
480
-
481
-
482
- <li class="">
483
- <a href="/news/2014/12/17/alfredxing-welcome-to-jekyll-core/">Alfred Xing has joined the Jekyll core team</a>
484
- </li>
485
-
486
-
487
-
488
-
489
-
490
-
491
-
492
-
493
-
494
-
495
-
496
-
497
-
498
-
499
-
500
-
501
-
502
-
503
-
504
- <li class="">
505
- <a href="/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/">Pick Up your $1 Jekyll Sticker</a>
506
- </li>
507
-
508
-
509
-
510
-
511
-
512
-
513
-
514
-
515
-
516
-
517
-
518
-
519
-
520
-
521
-
522
-
523
-
524
-
525
-
526
-
527
-
528
-
529
-
530
-
531
-
532
-
533
-
534
-
535
-
536
-
537
-
538
-
539
-
540
-
541
-
542
-
543
-
544
-
545
-
546
-
547
-
548
-
549
-
550
-
551
- </ul>
552
- </aside>
553
- </div>
554
-
555
-
556
- <div class="clear"></div>
557
-
558
- </div>
559
- </section>
560
-
561
-
562
- <footer>
563
- <div class="grid">
564
- <div class="unit one-third center-on-mobiles">
565
- <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>
566
- </div>
567
- <div class="unit two-thirds align-right center-on-mobiles">
568
- <p>
569
- Proudly hosted by
570
- <a href="https://github.com">
571
- <img src="/img/footer-logo.png" width="100" height="30" alt="GitHub • Social coding">
572
- </a>
573
- </p>
574
- </div>
575
- </div>
576
- </footer>
577
-
578
- <script>
579
- var anchorForId = function (id) {
580
- var anchor = document.createElement("a");
581
- anchor.className = "header-link";
582
- anchor.href = "#" + id;
583
- anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
584
- anchor.title = "Permalink";
585
- return anchor;
586
- };
587
-
588
- var linkifyAnchors = function (level, containingElement) {
589
- var headers = containingElement.getElementsByTagName("h" + level);
590
- for (var h = 0; h < headers.length; h++) {
591
- var header = headers[h];
592
-
593
- if (typeof header.id !== "undefined" && header.id !== "") {
594
- header.appendChild(anchorForId(header.id));
595
- }
596
- }
597
- };
598
-
599
- document.onreadystatechange = function () {
600
- if (this.readyState === "complete") {
601
- var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
602
- if (!contentBlock) {
603
- return;
604
- }
605
- for (var level = 1; level <= 6; level++) {
606
- linkifyAnchors(level, contentBlock);
607
- }
608
- }
609
- };
610
- </script>
611
-
612
-
613
- <!-- Gauges (http://get.gaug.es/) -->
614
- <script>
615
- var _gauges = _gauges || [];
616
- (function() {
617
- var t = document.createElement('script');
618
- t.type = 'text/javascript';
619
- t.async = true;
620
- t.id = 'gauges-tracker';
621
- t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
622
- t.src = '//secure.gaug.es/track.js';
623
- var s = document.getElementsByTagName('script')[0];
624
- s.parentNode.insertBefore(t, s);
625
- })();
626
- </script>
627
-
628
-
629
-
630
- <!-- Google Analytics (https://www.google.com/analytics) -->
631
- <script>
632
- !function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
633
- (j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
634
- L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
635
- L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
636
-
637
- ga('create', 'UA-50755011-1', 'jekyllrb.com');
638
- ga('send', 'pageview');
639
-
640
- </script>
641
-
642
-
643
-
644
- </body>
645
- </html>