jekyll-docs 3.6.1.0 → 3.6.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/jekyll.rb +195 -0
- data/lib/jekyll/cleaner.rb +110 -0
- data/lib/jekyll/collection.rb +230 -0
- data/lib/jekyll/command.rb +78 -0
- data/lib/jekyll/commands/build.rb +102 -0
- data/lib/jekyll/commands/clean.rb +43 -0
- data/lib/jekyll/commands/doctor.rb +153 -0
- data/lib/jekyll/commands/help.rb +34 -0
- data/lib/jekyll/commands/new.rb +156 -0
- data/lib/jekyll/commands/new_theme.rb +40 -0
- data/lib/jekyll/commands/serve.rb +245 -0
- data/lib/jekyll/commands/serve/servlet.rb +62 -0
- data/lib/jekyll/configuration.rb +410 -0
- data/lib/jekyll/converter.rb +54 -0
- data/lib/jekyll/converters/identity.rb +23 -0
- data/lib/jekyll/converters/markdown.rb +104 -0
- data/lib/jekyll/converters/markdown/kramdown_parser.rb +123 -0
- data/lib/jekyll/converters/markdown/rdiscount_parser.rb +35 -0
- data/lib/jekyll/converters/markdown/redcarpet_parser.rb +108 -0
- data/lib/jekyll/converters/smartypants.rb +36 -0
- data/lib/jekyll/convertible.rb +251 -0
- data/lib/jekyll/deprecator.rb +52 -0
- data/lib/jekyll/document.rb +507 -0
- data/lib/jekyll/drops/collection_drop.rb +22 -0
- data/lib/jekyll/drops/document_drop.rb +69 -0
- data/lib/jekyll/drops/drop.rb +214 -0
- data/lib/jekyll/drops/excerpt_drop.rb +15 -0
- data/lib/jekyll/drops/jekyll_drop.rb +33 -0
- data/lib/jekyll/drops/site_drop.rb +47 -0
- data/lib/jekyll/drops/static_file_drop.rb +13 -0
- data/lib/jekyll/drops/unified_payload_drop.rb +25 -0
- data/lib/jekyll/drops/url_drop.rb +88 -0
- data/lib/jekyll/entry_filter.rb +123 -0
- data/lib/jekyll/errors.rb +20 -0
- data/lib/jekyll/excerpt.rb +126 -0
- data/lib/jekyll/external.rb +74 -0
- data/lib/jekyll/filters.rb +430 -0
- data/lib/jekyll/filters/grouping_filters.rb +65 -0
- data/lib/jekyll/filters/url_filters.rb +60 -0
- data/lib/jekyll/frontmatter_defaults.rb +197 -0
- data/lib/jekyll/generator.rb +5 -0
- data/lib/jekyll/hooks.rb +104 -0
- data/lib/jekyll/layout.rb +62 -0
- data/lib/jekyll/liquid_extensions.rb +24 -0
- data/lib/jekyll/liquid_renderer.rb +49 -0
- data/lib/jekyll/liquid_renderer/file.rb +56 -0
- data/lib/jekyll/liquid_renderer/table.rb +96 -0
- data/lib/jekyll/log_adapter.rb +147 -0
- data/lib/jekyll/mime.types +825 -0
- data/lib/jekyll/page.rb +187 -0
- data/lib/jekyll/plugin.rb +98 -0
- data/lib/jekyll/plugin_manager.rb +113 -0
- data/lib/jekyll/publisher.rb +23 -0
- data/lib/jekyll/reader.rb +134 -0
- data/lib/jekyll/readers/collection_reader.rb +22 -0
- data/lib/jekyll/readers/data_reader.rb +77 -0
- data/lib/jekyll/readers/layout_reader.rb +71 -0
- data/lib/jekyll/readers/page_reader.rb +25 -0
- data/lib/jekyll/readers/post_reader.rb +72 -0
- data/lib/jekyll/readers/static_file_reader.rb +25 -0
- data/lib/jekyll/readers/theme_assets_reader.rb +49 -0
- data/lib/jekyll/regenerator.rb +201 -0
- data/lib/jekyll/related_posts.rb +52 -0
- data/lib/jekyll/renderer.rb +269 -0
- data/lib/jekyll/site.rb +472 -0
- data/lib/jekyll/static_file.rb +162 -0
- data/lib/jekyll/stevenson.rb +61 -0
- data/lib/jekyll/tags/highlight.rb +141 -0
- data/lib/jekyll/tags/include.rb +215 -0
- data/lib/jekyll/tags/link.rb +37 -0
- data/lib/jekyll/tags/post_url.rb +103 -0
- data/lib/jekyll/theme.rb +68 -0
- data/lib/jekyll/theme_builder.rb +119 -0
- data/lib/jekyll/url.rb +161 -0
- data/lib/jekyll/utils.rb +340 -0
- data/lib/jekyll/utils/ansi.rb +59 -0
- data/lib/jekyll/utils/exec.rb +27 -0
- data/lib/jekyll/utils/platforms.rb +82 -0
- data/lib/jekyll/utils/rouge.rb +21 -0
- data/lib/jekyll/utils/win_tz.rb +75 -0
- data/lib/jekyll/version.rb +5 -0
- data/lib/site_template/404.html +24 -0
- data/lib/site_template/_config.yml +43 -0
- data/lib/site_template/_posts/0000-00-00-welcome-to-jekyll.markdown.erb +25 -0
- data/lib/site_template/about.md +18 -0
- data/lib/site_template/index.md +6 -0
- data/lib/theme_template/CODE_OF_CONDUCT.md.erb +74 -0
- data/lib/theme_template/Gemfile +4 -0
- data/lib/theme_template/LICENSE.txt.erb +21 -0
- data/lib/theme_template/README.md.erb +52 -0
- data/lib/theme_template/_layouts/default.html +1 -0
- data/lib/theme_template/_layouts/page.html +5 -0
- data/lib/theme_template/_layouts/post.html +5 -0
- data/lib/theme_template/example/_config.yml.erb +1 -0
- data/lib/theme_template/example/_post.md +12 -0
- data/lib/theme_template/example/index.html +14 -0
- data/lib/theme_template/example/style.scss +7 -0
- data/lib/theme_template/gitignore.erb +5 -0
- data/lib/theme_template/theme.gemspec.erb +19 -0
- metadata +103 -156
- data/lib/jekyll-docs.rb +0 -31
- data/site/404.html +0 -153
- data/site/CNAME +0 -1
- data/site/community/index.html +0 -299
- data/site/conduct/index.html +0 -10
- data/site/css/screen.css +0 -1
- data/site/docs/assets/index.html +0 -724
- data/site/docs/code_of_conduct/index.html +0 -730
- data/site/docs/collections/index.html +0 -1097
- data/site/docs/conduct/index.html +0 -744
- data/site/docs/configuration/index.html +0 -1403
- data/site/docs/continuous-integration/buddyworks/index.html +0 -726
- data/site/docs/continuous-integration/circleci/index.html +0 -757
- data/site/docs/continuous-integration/index.html +0 -681
- data/site/docs/continuous-integration/travis-ci/index.html +0 -891
- data/site/docs/contributing/index.html +0 -863
- data/site/docs/datafiles/index.html +0 -780
- data/site/docs/deployment-methods/index.html +0 -875
- data/site/docs/drafts/index.html +0 -636
- data/site/docs/extras/index.html +0 -689
- data/site/docs/frontmatter/index.html +0 -821
- data/site/docs/github-pages/index.html +0 -819
- data/site/docs/history/index.html +0 -3955
- data/site/docs/home/index.html +0 -644
- data/site/docs/includes/index.html +0 -800
- data/site/docs/index.html +0 -10
- data/site/docs/installation/index.html +0 -732
- data/site/docs/maintaining/affinity-team-captain/index.html +0 -706
- data/site/docs/maintaining/avoiding-burnout/index.html +0 -709
- data/site/docs/maintaining/becoming-a-maintainer/index.html +0 -717
- data/site/docs/maintaining/index.html +0 -713
- data/site/docs/maintaining/merging-a-pull-request/index.html +0 -747
- data/site/docs/maintaining/reviewing-a-pull-request/index.html +0 -725
- data/site/docs/maintaining/special-labels/index.html +0 -705
- data/site/docs/maintaining/triaging-an-issue/index.html +0 -735
- data/site/docs/migrations/index.html +0 -647
- data/site/docs/pages/index.html +0 -695
- data/site/docs/pagination/index.html +0 -870
- data/site/docs/permalinks/index.html +0 -1035
- data/site/docs/plugins/index.html +0 -1800
- data/site/docs/posts/index.html +0 -858
- data/site/docs/quickstart/index.html +0 -650
- data/site/docs/resources/index.html +0 -769
- data/site/docs/sites/index.html +0 -702
- data/site/docs/static-files/index.html +0 -720
- data/site/docs/structure/index.html +0 -822
- data/site/docs/templates/index.html +0 -1208
- data/site/docs/themes/index.html +0 -935
- data/site/docs/troubleshooting/index.html +0 -916
- data/site/docs/upgrading/0-to-2/index.html +0 -826
- data/site/docs/upgrading/2-to-3/index.html +0 -824
- data/site/docs/upgrading/index.html +0 -693
- data/site/docs/usage/index.html +0 -705
- data/site/docs/variables/index.html +0 -1048
- data/site/docs/windows/index.html +0 -799
- data/site/favicon.ico +0 -0
- data/site/feed.xml +0 -372
- data/site/fonts/FontAwesome.eot +0 -0
- data/site/fonts/FontAwesome.svg +0 -12
- data/site/fonts/FontAwesome.ttf +0 -0
- data/site/fonts/FontAwesome.woff +0 -0
- data/site/github.html +0 -10
- data/site/help/index.html +0 -244
- data/site/icomoon-selection.json +0 -96
- data/site/img/article-footer.png +0 -0
- data/site/img/footer-arrow.png +0 -0
- data/site/img/footer-logo.png +0 -0
- data/site/img/jekyll-sticker.jpg +0 -0
- data/site/img/jekylllayoutconcept.png +0 -0
- data/site/img/logo-2x.png +0 -0
- data/site/img/logo-rss.png +0 -0
- data/site/img/octojekyll.png +0 -0
- data/site/index.html +0 -267
- data/site/issues.html +0 -10
- data/site/js/html5shiv.min.js +0 -4
- data/site/js/respond.min.js +0 -5
- data/site/latest_version.txt +0 -1
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +0 -570
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +0 -570
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +0 -571
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +0 -568
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +0 -570
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +0 -569
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +0 -565
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +0 -565
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +0 -572
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +0 -566
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +0 -564
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +0 -599
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +0 -568
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +0 -583
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +0 -565
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +0 -564
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +0 -573
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +0 -564
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +0 -569
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +0 -585
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +0 -565
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +0 -567
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +0 -582
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +0 -579
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +0 -568
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +0 -588
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +0 -574
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +0 -597
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +0 -575
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +0 -565
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +0 -572
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +0 -567
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +0 -568
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +0 -588
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +0 -563
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +0 -592
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +0 -576
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +0 -566
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +0 -599
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +0 -583
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +0 -578
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +0 -569
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +0 -565
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +0 -571
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +0 -566
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +0 -572
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +0 -576
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +0 -564
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +0 -566
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +0 -567
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +0 -676
- data/site/news/2016/08/02/jekyll-3-2-1-released/index.html +0 -571
- data/site/news/2016/08/24/jekyll-admin-initial-release/index.html +0 -566
- data/site/news/2016/10/06/jekyll-3-3-is-here/index.html +0 -645
- data/site/news/2016/11/14/jekyll-3-3-1-released/index.html +0 -569
- data/site/news/2017/01/18/jekyll-3-4-0-released/index.html +0 -592
- data/site/news/2017/03/02/jekyll-3-4-1-released/index.html +0 -649
- data/site/news/2017/03/09/jekyll-3-4-2-released/index.html +0 -598
- data/site/news/2017/03/21/jekyll-3-4-3-released/index.html +0 -594
- data/site/news/2017/06/15/jekyll-3-5-0-released/index.html +0 -589
- data/site/news/2017/07/17/jekyll-3-5-1-released/index.html +0 -569
- data/site/news/2017/08/12/jekyll-3-5-2-released/index.html +0 -573
- data/site/news/2017/09/21/jekyll-3-6-0-released/index.html +0 -565
- data/site/news/index.html +0 -3609
- data/site/news/releases/index.html +0 -3344
- data/site/philosophy.html +0 -46
- data/site/readme.md +0 -23
- data/site/robots.txt +0 -1
- data/site/sitemap.xml +0 -485
- data/site/tutorials/convert-site-to-jekyll/index.html +0 -793
- data/site/tutorials/custom-404-page/index.html +0 -358
- data/site/tutorials/home/index.html +0 -323
- data/site/tutorials/index.html +0 -10
- data/site/tutorials/navigation/index.html +0 -872
- data/site/tutorials/orderofinterpretation/index.html +0 -441
@@ -1,799 +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.1">
|
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 on Windows | Jekyll • Simple, blog-aware, static sites</title>
|
15
|
-
<meta property="og:title" content="Jekyll on Windows">
|
16
|
-
<meta property="og:locale" content="en_US">
|
17
|
-
<meta name="description" content="While Windows is not an officially-supported platform, it can be used to run Jekyll with the proper tweaks. This page aims to collect some of the general knowledge and lessons that have been unearthed by Windows users.">
|
18
|
-
<meta property="og:description" content="While Windows is not an officially-supported platform, it can be used to run Jekyll with the proper tweaks. This page aims to collect some of the general knowledge and lessons that have been unearthed by Windows users.">
|
19
|
-
<link rel="canonical" href="https://jekyllrb.com/docs/windows/">
|
20
|
-
<meta property="og:url" content="https://jekyllrb.com/docs/windows/">
|
21
|
-
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
|
22
|
-
<meta property="og:type" content="article">
|
23
|
-
<meta property="article:published_time" content="2017-10-24T09:09:24-07:00">
|
24
|
-
<meta name="twitter:card" content="summary">
|
25
|
-
<meta name="twitter:site" content="@jekyllrb">
|
26
|
-
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
|
27
|
-
<script type="application/ld+json">
|
28
|
-
{"name":null,"description":"While Windows is not an officially-supported platform, it can be used to run Jekyll with the proper tweaks. This page aims to collect some of the general knowledge and lessons that have been unearthed by Windows users.","url":"https://jekyllrb.com/docs/windows/","headline":"Jekyll on Windows","dateModified":"2017-10-24T09:09:24-07:00","datePublished":"2017-10-24T09:09:24-07:00","sameAs":null,"@type":"BlogPosting","author":null,"image":null,"publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://jekyllrb.com/img/logo-2x.png"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://jekyllrb.com/docs/windows/"},"@context":"http://schema.org"}</script>
|
29
|
-
<!-- End Jekyll SEO tag -->
|
30
|
-
|
31
|
-
<!--[if lt IE 9]>
|
32
|
-
<script src="/js/html5shiv.min.js"></script>
|
33
|
-
<script src="/js/respond.min.js"></script>
|
34
|
-
<![endif]-->
|
35
|
-
</head>
|
36
|
-
|
37
|
-
|
38
|
-
<body class="wrap">
|
39
|
-
<header>
|
40
|
-
<nav class="mobile-nav show-on-mobiles">
|
41
|
-
<ul>
|
42
|
-
<li class="">
|
43
|
-
<a href="/">Home</a>
|
44
|
-
</li>
|
45
|
-
<li class="current">
|
46
|
-
<a href="/docs/home/">Docs</a>
|
47
|
-
</li>
|
48
|
-
<li class="">
|
49
|
-
<a href="/news/">News</a>
|
50
|
-
</li>
|
51
|
-
<li class="">
|
52
|
-
<a href="/community/">Community</a>
|
53
|
-
</li>
|
54
|
-
<li class="">
|
55
|
-
<a href="/help/">Help</a>
|
56
|
-
</li>
|
57
|
-
<li>
|
58
|
-
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
59
|
-
</li>
|
60
|
-
</ul>
|
61
|
-
|
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>
|
71
|
-
</div>
|
72
|
-
<nav class="main-nav unit two-thirds hide-on-mobiles">
|
73
|
-
<ul>
|
74
|
-
<li class="">
|
75
|
-
<a href="/">Home</a>
|
76
|
-
</li>
|
77
|
-
<li class="current">
|
78
|
-
<a href="/docs/home/">Docs</a>
|
79
|
-
</li>
|
80
|
-
<li class="">
|
81
|
-
<a href="/news/">News</a>
|
82
|
-
</li>
|
83
|
-
<li class="">
|
84
|
-
<a href="/community/">Community</a>
|
85
|
-
</li>
|
86
|
-
<li class="">
|
87
|
-
<a href="/help/">Help</a>
|
88
|
-
</li>
|
89
|
-
<li>
|
90
|
-
<a href="https://github.com/jekyll/jekyll">GitHub</a>
|
91
|
-
</li>
|
92
|
-
</ul>
|
93
|
-
|
94
|
-
</nav>
|
95
|
-
</div>
|
96
|
-
</header>
|
97
|
-
|
98
|
-
|
99
|
-
<section class="docs">
|
100
|
-
<div class="grid">
|
101
|
-
|
102
|
-
<div class="docs-nav-mobile unit whole show-on-mobiles">
|
103
|
-
<select onchange="if (this.value) window.location.href=this.value">
|
104
|
-
<option value="">Navigate the docs…</option>
|
105
|
-
|
106
|
-
<optgroup label="Getting Started">
|
107
|
-
|
108
|
-
|
109
|
-
|
110
|
-
<option value="/docs/home/">Welcome</option>
|
111
|
-
|
112
|
-
|
113
|
-
|
114
|
-
<option value="/docs/quickstart/">Quick-start guide</option>
|
115
|
-
|
116
|
-
|
117
|
-
|
118
|
-
<option value="/docs/installation/">Installation</option>
|
119
|
-
|
120
|
-
|
121
|
-
|
122
|
-
<option value="/docs/windows/">Jekyll on Windows</option>
|
123
|
-
|
124
|
-
|
125
|
-
|
126
|
-
<option value="/docs/usage/">Basic Usage</option>
|
127
|
-
|
128
|
-
|
129
|
-
|
130
|
-
<option value="/docs/structure/">Directory structure</option>
|
131
|
-
|
132
|
-
|
133
|
-
|
134
|
-
<option value="/docs/configuration/">Configuration</option>
|
135
|
-
|
136
|
-
|
137
|
-
</optgroup>
|
138
|
-
|
139
|
-
<optgroup label="Your Content">
|
140
|
-
|
141
|
-
|
142
|
-
|
143
|
-
<option value="/docs/frontmatter/">Front Matter</option>
|
144
|
-
|
145
|
-
|
146
|
-
|
147
|
-
<option value="/docs/posts/">Writing posts</option>
|
148
|
-
|
149
|
-
|
150
|
-
|
151
|
-
<option value="/docs/drafts/">Working with drafts</option>
|
152
|
-
|
153
|
-
|
154
|
-
|
155
|
-
<option value="/docs/pages/">Creating pages</option>
|
156
|
-
|
157
|
-
|
158
|
-
|
159
|
-
<option value="/docs/static-files/">Static Files</option>
|
160
|
-
|
161
|
-
|
162
|
-
|
163
|
-
<option value="/docs/variables/">Variables</option>
|
164
|
-
|
165
|
-
|
166
|
-
|
167
|
-
<option value="/docs/collections/">Collections</option>
|
168
|
-
|
169
|
-
|
170
|
-
|
171
|
-
<option value="/docs/datafiles/">Data Files</option>
|
172
|
-
|
173
|
-
|
174
|
-
|
175
|
-
<option value="/docs/assets/">Assets</option>
|
176
|
-
|
177
|
-
|
178
|
-
|
179
|
-
<option value="/docs/migrations/">Blog migrations</option>
|
180
|
-
|
181
|
-
|
182
|
-
</optgroup>
|
183
|
-
|
184
|
-
<optgroup label="Customization">
|
185
|
-
|
186
|
-
|
187
|
-
|
188
|
-
<option value="/docs/templates/">Templates</option>
|
189
|
-
|
190
|
-
|
191
|
-
|
192
|
-
<option value="/docs/includes/">Includes</option>
|
193
|
-
|
194
|
-
|
195
|
-
|
196
|
-
<option value="/docs/permalinks/">Permalinks</option>
|
197
|
-
|
198
|
-
|
199
|
-
|
200
|
-
<option value="/docs/pagination/">Pagination</option>
|
201
|
-
|
202
|
-
|
203
|
-
|
204
|
-
<option value="/docs/plugins/">Plugins</option>
|
205
|
-
|
206
|
-
|
207
|
-
|
208
|
-
<option value="/docs/themes/">Themes</option>
|
209
|
-
|
210
|
-
|
211
|
-
|
212
|
-
<option value="/docs/extras/">Extras</option>
|
213
|
-
|
214
|
-
|
215
|
-
</optgroup>
|
216
|
-
|
217
|
-
<optgroup label="Deployment">
|
218
|
-
|
219
|
-
|
220
|
-
|
221
|
-
<option value="/docs/github-pages/">GitHub Pages</option>
|
222
|
-
|
223
|
-
|
224
|
-
|
225
|
-
<option value="/docs/deployment-methods/">Deployment methods</option>
|
226
|
-
|
227
|
-
|
228
|
-
|
229
|
-
<option value="/docs/continuous-integration/">Continuous Integration</option>
|
230
|
-
|
231
|
-
|
232
|
-
</optgroup>
|
233
|
-
|
234
|
-
<optgroup label="Miscellaneous">
|
235
|
-
|
236
|
-
|
237
|
-
|
238
|
-
<option value="/docs/troubleshooting/">Troubleshooting</option>
|
239
|
-
|
240
|
-
|
241
|
-
|
242
|
-
<option value="/docs/sites/">Sites using Jekyll</option>
|
243
|
-
|
244
|
-
|
245
|
-
|
246
|
-
<option value="/docs/resources/">Resources</option>
|
247
|
-
|
248
|
-
|
249
|
-
|
250
|
-
<option value="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
|
251
|
-
|
252
|
-
|
253
|
-
|
254
|
-
<option value="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
|
255
|
-
|
256
|
-
|
257
|
-
</optgroup>
|
258
|
-
|
259
|
-
<optgroup label="Meta">
|
260
|
-
|
261
|
-
|
262
|
-
|
263
|
-
<option value="/docs/contributing/">Contributing</option>
|
264
|
-
|
265
|
-
|
266
|
-
|
267
|
-
<option value="/docs/maintaining/">Maintaining Jekyll</option>
|
268
|
-
|
269
|
-
|
270
|
-
|
271
|
-
<option value="/docs/conduct/">Code of Conduct</option>
|
272
|
-
|
273
|
-
|
274
|
-
|
275
|
-
<option value="/docs/history/">History</option>
|
276
|
-
|
277
|
-
|
278
|
-
</optgroup>
|
279
|
-
|
280
|
-
</select>
|
281
|
-
</div>
|
282
|
-
|
283
|
-
|
284
|
-
<div class="unit four-fifths">
|
285
|
-
<article>
|
286
|
-
<div class="improve right hide-on-mobiles">
|
287
|
-
<a href="https://github.com/jekyll/jekyll/edit/master/docs/_docs/windows.md"><i class="fa fa-pencil"></i> Improve this page</a>
|
288
|
-
</div>
|
289
|
-
<h1>Jekyll on Windows</h1>
|
290
|
-
<p>While Windows is not an officially-supported platform, it can be used to run Jekyll with the proper tweaks. This page aims to collect some of the general knowledge and lessons that have been unearthed by Windows users.</p>
|
291
|
-
|
292
|
-
<h2 id="installing-jekyll">Installing Jekyll</h2>
|
293
|
-
|
294
|
-
<p>If you are using Windows 10 Anniversary Update, the easiest way to run Jekyll is by <a href="https://msdn.microsoft.com/en-us/commandline/wsl/install_guide">installing</a> the new Bash on Ubuntu on Windows.</p>
|
295
|
-
|
296
|
-
<h3 id="installation-via-bash-on-windows-10">Installation via Bash on Windows 10</h3>
|
297
|
-
|
298
|
-
<p><em>Note:</em> You must have <a href="https://msdn.microsoft.com/en-us/commandline/wsl/about">Bash on Ubuntu on Windows</a> enabled.</p>
|
299
|
-
|
300
|
-
<p>First let’s make sure all our packages / repositories are up to date. Open a new Command Prompt instance, and type the following:</p>
|
301
|
-
|
302
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>bash
|
303
|
-
</code></pre></div></div>
|
304
|
-
<p>Your Command Prompt instance should now be a Bash instance. Now we must update our repo lists and packages.</p>
|
305
|
-
|
306
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo apt-get update -y && sudo apt-get upgrade -y
|
307
|
-
</code></pre></div></div>
|
308
|
-
<p>Now we can install Ruby. To do this we will use a repository from <a href="https://www.brightbox.com/docs/ruby/ubuntu/">BrightBox</a>, which hosts optimized versions of Ruby for Ubuntu.</p>
|
309
|
-
|
310
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo apt-add-repository ppa:brightbox/ruby-ng
|
311
|
-
sudo apt-get update
|
312
|
-
sudo apt-get install ruby2.3 ruby2.3-dev build-essential
|
313
|
-
</code></pre></div></div>
|
314
|
-
|
315
|
-
<p>Next let’s update our Ruby gems:</p>
|
316
|
-
|
317
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo gem update
|
318
|
-
</code></pre></div></div>
|
319
|
-
|
320
|
-
<p>Now all that is left to do is install Jekyll.</p>
|
321
|
-
|
322
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo gem install jekyll bundler
|
323
|
-
</code></pre></div></div>
|
324
|
-
|
325
|
-
<p>Check if Jekyll installed properly by running:</p>
|
326
|
-
|
327
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jekyll -v
|
328
|
-
</code></pre></div></div>
|
329
|
-
|
330
|
-
<p><strong>And that’s it!</strong></p>
|
331
|
-
|
332
|
-
<p>To start a new project named <code class="highlighter-rouge">my_blog</code>, just run:</p>
|
333
|
-
|
334
|
-
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>jekyll new my_blog
|
335
|
-
</code></pre></div></div>
|
336
|
-
|
337
|
-
<p>You can make sure time management is working properly by inspecting your <code class="highlighter-rouge">_posts</code> folder. You should see a markdown file with the current date in the filename.</p>
|
338
|
-
|
339
|
-
<p><strong>Note:</strong> Bash on Ubuntu on Windows is still under development, so you may run into issues.</p>
|
340
|
-
|
341
|
-
<h3 id="installation-via-rubyinstaller">Installation via RubyInstaller</h3>
|
342
|
-
|
343
|
-
<p><a href="https://rubyinstaller.org/">RubyInstaller</a> is a self-contained Windows-based installer that includes the Ruby language, an execution environment, important documentation, and more.</p>
|
344
|
-
|
345
|
-
<ol>
|
346
|
-
<li>Download and Install a package manager version from <a href="https://rubyinstaller.org/downloads/">RubyInstaller Downloads</a>.</li>
|
347
|
-
<li>Install Jekyll and Bundler via a command prompt window: <code class="highlighter-rouge">gem install jekyll bundler</code>
|
348
|
-
</li>
|
349
|
-
<li>Check if Jekyll installed properly: <code class="highlighter-rouge">jekyll -v</code>
|
350
|
-
</li>
|
351
|
-
</ol>
|
352
|
-
|
353
|
-
<h3 id="installation-via-chocolatey">Installation via Chocolatey</h3>
|
354
|
-
|
355
|
-
<p>A quick way to install Jekyll using Chocolatey is to follow the <a href="https://davidburela.wordpress.com/2015/11/28/easily-install-jekyll-on-windows-with-3-command-prompt-entries-and-chocolatey/">installation instructions by David Burela</a>:</p>
|
356
|
-
|
357
|
-
<ol>
|
358
|
-
<li>Install a package manager for Windows called <a href="https://chocolatey.org/install" title="Package manager for Windows">Chocolatey</a>
|
359
|
-
</li>
|
360
|
-
<li>Install Ruby via Chocolatey: <code class="highlighter-rouge">choco install ruby -y</code>
|
361
|
-
</li>
|
362
|
-
<li>Reopen a command prompt and install Jekyll: <code class="highlighter-rouge">gem install jekyll</code>
|
363
|
-
</li>
|
364
|
-
</ol>
|
365
|
-
|
366
|
-
<p>Updates in the infrastructure of Ruby may cause SSL errors when attempting to use <code class="highlighter-rouge">gem install</code> with versions of the RubyGems package older than 2.6. (The RubyGems package installed via the Chocolatey tool is version 2.3) If you have installed an older version, you can update the RubyGems package using the directions <a href="http://guides.rubygems.org/ssl-certificate-update/#installing-using-update-packages">here</a>.</p>
|
367
|
-
|
368
|
-
<h3 id="installing-github-pages-via-chocolatey">Installing <em>github-pages</em> via Chocolatey</h3>
|
369
|
-
|
370
|
-
<p>This section is part of an article written by <a href="https://jwillmer.de/blog/tutorial/how-to-install-jekyll-and-pages-gem-on-windows-10-x46" title="Installation instructions by Jens Willmer">Jens Willmer</a>. To follow the instructions you need to have <a href="https://chocolatey.org/install" title="Package manager for Windows">Chocolatey</a> installed on your system. If you already have a version of Ruby installed you need to uninstall it before you can continue.</p>
|
371
|
-
|
372
|
-
<h4 id="install-ruby-and-ruby-development-kit">Install Ruby and Ruby development kit</h4>
|
373
|
-
|
374
|
-
<p>Open a command prompt and execute the following commands:</p>
|
375
|
-
|
376
|
-
<ul>
|
377
|
-
<li><code class="highlighter-rouge">choco install ruby -version 2.2.4</code></li>
|
378
|
-
<li>
|
379
|
-
<code class="highlighter-rouge">choco install ruby2.devkit</code> - <em>needed for compilation of json gem</em>
|
380
|
-
</li>
|
381
|
-
</ul>
|
382
|
-
|
383
|
-
<h4 id="configure-ruby-development-kit">Configure Ruby development kit</h4>
|
384
|
-
|
385
|
-
<p>The development kit did not set the environment path for Ruby so we need to do it.</p>
|
386
|
-
|
387
|
-
<ul>
|
388
|
-
<li>Open command prompt in <code class="highlighter-rouge">C:\tools\DevKit2</code>
|
389
|
-
</li>
|
390
|
-
<li>Execute <code class="highlighter-rouge">ruby dk.rb init</code> to create a file called <code class="highlighter-rouge">config.yml</code>
|
391
|
-
</li>
|
392
|
-
<li>Edit the <code class="highlighter-rouge">config.yml</code> file and include the path to Ruby <code class="highlighter-rouge">- C:/tools/ruby22</code>
|
393
|
-
</li>
|
394
|
-
<li>Execute the following command to set the path: <code class="highlighter-rouge">ruby dk.rb install</code>
|
395
|
-
</li>
|
396
|
-
</ul>
|
397
|
-
|
398
|
-
<h4 id="nokogiri-gem-installation">Nokogiri gem installation</h4>
|
399
|
-
|
400
|
-
<p>This gem is also needed in the github-pages and to get it running on Windows x64 we have to install a few things.</p>
|
401
|
-
|
402
|
-
<p><strong>Note:</strong> In the current <a href="https://github.com/sparklemotion/nokogiri/issues/1456#issuecomment-206481794" title="Nokogiri fails to install on Ruby 2.3 for Windows">pre release</a> it works out of the box with Windows x64 but this version is not referenced in the github-pages.</p>
|
403
|
-
|
404
|
-
<p><code class="language-ruby highlighter-rouge"><span class="n">choco</span> <span class="n">install</span> <span class="n">libxml2</span> <span class="o">-</span><span class="no">Source</span> <span class="s2">"https://www.nuget.org/api/v2/"</span></code></p>
|
405
|
-
|
406
|
-
<p><code class="language-ruby highlighter-rouge"><span class="n">choco</span> <span class="n">install</span> <span class="n">libxslt</span> <span class="o">-</span><span class="no">Source</span> <span class="s2">"https://www.nuget.org/api/v2/"</span></code></p>
|
407
|
-
|
408
|
-
<p><code class="language-ruby highlighter-rouge"><span class="n">choco</span> <span class="n">install</span> <span class="n">libiconv</span> <span class="o">-</span><span class="no">Source</span> <span class="s2">"https://www.nuget.org/api/v2/"</span></code></p>
|
409
|
-
|
410
|
-
<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="n">gem</span> <span class="n">install</span> <span class="n">nokogiri</span> <span class="o">--^</span>
|
411
|
-
<span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">xml2</span><span class="o">-</span><span class="kp">include</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libxml2</span><span class="o">.</span><span class="mf">2.7</span><span class="o">.</span><span class="mf">8.7</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="kp">include</span><span class="o">^</span>
|
412
|
-
<span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">xml2</span><span class="o">-</span><span class="n">lib</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libxml2</span><span class="p">.</span><span class="nf">redist</span><span class="o">.</span><span class="mf">2.7</span><span class="o">.</span><span class="mf">8.7</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="n">bin</span><span class="p">\</span><span class="n">v110</span><span class="p">\</span><span class="n">x64</span><span class="p">\</span><span class="no">Release</span><span class="p">\</span><span class="n">dynamic</span><span class="p">\</span><span class="n">cdecl</span><span class="o">^</span>
|
413
|
-
<span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">iconv</span><span class="o">-</span><span class="kp">include</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libiconv</span><span class="o">.</span><span class="mf">1.14</span><span class="o">.</span><span class="mf">0.11</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="kp">include</span><span class="o">^</span>
|
414
|
-
<span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">iconv</span><span class="o">-</span><span class="n">lib</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libiconv</span><span class="p">.</span><span class="nf">redist</span><span class="o">.</span><span class="mf">1.14</span><span class="o">.</span><span class="mf">0.11</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="n">bin</span><span class="p">\</span><span class="n">v110</span><span class="p">\</span><span class="n">x64</span><span class="p">\</span><span class="no">Release</span><span class="p">\</span><span class="n">dynamic</span><span class="p">\</span><span class="n">cdecl</span><span class="o">^</span>
|
415
|
-
<span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">xslt</span><span class="o">-</span><span class="kp">include</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libxslt</span><span class="o">.</span><span class="mf">1.1</span><span class="o">.</span><span class="mf">28.0</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="kp">include</span><span class="o">^</span>
|
416
|
-
<span class="o">--</span><span class="n">with</span><span class="o">-</span><span class="n">xslt</span><span class="o">-</span><span class="n">lib</span><span class="o">=</span><span class="no">C</span><span class="p">:\</span><span class="no">Chocolatey</span><span class="p">\</span><span class="n">lib</span><span class="p">\</span><span class="n">libxslt</span><span class="p">.</span><span class="nf">redist</span><span class="o">.</span><span class="mf">1.1</span><span class="o">.</span><span class="mf">28.0</span><span class="p">\</span><span class="n">build</span><span class="p">\</span><span class="n">native</span><span class="p">\</span><span class="n">bin</span><span class="p">\</span><span class="n">v110</span><span class="p">\</span><span class="n">x64</span><span class="p">\</span><span class="no">Release</span><span class="p">\</span><span class="n">dynamic</span>
|
417
|
-
</code></pre></div></div>
|
418
|
-
|
419
|
-
<h4 id="install-github-pages">Install github-pages</h4>
|
420
|
-
|
421
|
-
<ul>
|
422
|
-
<li>Open command prompt and install <a href="http://bundler.io/" title="Ruby Dependencie Manager">Bundler</a>: <code class="highlighter-rouge">gem install bundler</code>
|
423
|
-
</li>
|
424
|
-
<li>Create a file called <code class="highlighter-rouge">Gemfile</code> without any extension in your root directory of your blog</li>
|
425
|
-
<li>Copy & paste the two lines into the file:</li>
|
426
|
-
</ul>
|
427
|
-
|
428
|
-
<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">source</span> <span class="s1">'https://rubygems.org'</span>
|
429
|
-
<span class="n">gem</span> <span class="s1">'github-pages'</span><span class="p">,</span> <span class="ss">group: :jekyll_plugins</span>
|
430
|
-
</code></pre></div></div>
|
431
|
-
|
432
|
-
<ul>
|
433
|
-
<li>
|
434
|
-
<strong>Note:</strong> We use an unsecure connection because SSL throws exceptions in the version of Ruby</li>
|
435
|
-
<li>Open a command prompt, target your local blog repository root, and install github-pages: <code class="highlighter-rouge">bundle install</code>
|
436
|
-
</li>
|
437
|
-
</ul>
|
438
|
-
|
439
|
-
<p>After this process you should have github-pages installed on your system and you can host your blog again with <code class="highlighter-rouge">jekyll s</code>.
|
440
|
-
There will be a warning on startup that you should include <code class="highlighter-rouge">gem 'wdm', '>= 0.1.0' if Gem.win_platform?</code> to your <code class="highlighter-rouge">Gemfile</code> but I could not get <code class="highlighter-rouge">jekyll s</code> working if I include that line so for the moment I ignore that warning.</p>
|
441
|
-
|
442
|
-
<p>In the future the installation process of the github-pages should be as simple as the setup of the blog. But as long as the new version of the Nokogiri (<a href="https://github.com/sparklemotion/nokogiri/releases" title="Nokogiri Releases">v1.6.8</a>) is not stable and referenced, it is work to get it up and running on Windows.</p>
|
443
|
-
|
444
|
-
<hr>
|
445
|
-
|
446
|
-
<p>For a more conventional way of installing Jekyll you can follow this <a href="https://labs.sverrirs.com/jekyll/">complete guide to install Jekyll 3 on Windows by Sverrir Sigmundarson</a>.</p>
|
447
|
-
|
448
|
-
<p>Optionally you can use <a href="https://github.com/KeJunMao/fastjekyll#autoinstall-jekyll-for-windows">Autoinstall Jekyll for Windows</a>.</p>
|
449
|
-
|
450
|
-
<hr>
|
451
|
-
|
452
|
-
<h2 id="encoding">Encoding</h2>
|
453
|
-
|
454
|
-
<p>If you use UTF-8 encoding, make sure that no <code class="highlighter-rouge">BOM</code> header characters exist in your files or very, very bad things will happen to
|
455
|
-
Jekyll. This is especially relevant when you’re running Jekyll on Windows.</p>
|
456
|
-
|
457
|
-
<p>Additionally, you might need to change the code page of the console window to UTF-8 in case you get a “Liquid Exception: Incompatible character encoding” error during the site generation process. It can be done with the following command:</p>
|
458
|
-
|
459
|
-
<div class="language-sh highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>chcp 65001
|
460
|
-
</code></pre></div></div>
|
461
|
-
|
462
|
-
<h2 id="time-zone-management">Time-Zone Management</h2>
|
463
|
-
|
464
|
-
<p>Since Windows doesn’t have a native source of zoneinfo data, the Ruby Interpreter would not understand IANA Timezones and hence using them had the <code class="highlighter-rouge">TZ</code> environment variable default to UTC/GMT 00:00.
|
465
|
-
Though Windows users could alternatively define their blog’s timezone by setting the key to use POSIX format of defining timezones, it wasn’t as user-friendly when it came to having the clock altered to changing DST-rules.</p>
|
466
|
-
|
467
|
-
<p>Jekyll now uses a rubygem to internally configure Timezone based on established <a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones">IANA Timezone Database</a>.
|
468
|
-
While ‘new’ blogs created with Jekyll v3.4 and greater, will have the following added to their ‘Gemfile’ by default, existing sites <em>will</em> have to update their ‘Gemfile’ (and installed) to enable development on Windows:</p>
|
469
|
-
|
470
|
-
<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1"># Windows does not include zoneinfo files, so bundle the tzinfo-data gem</span>
|
471
|
-
<span class="n">gem</span> <span class="s1">'tzinfo-data'</span><span class="p">,</span> <span class="ss">platforms: </span><span class="p">[</span><span class="ss">:mingw</span><span class="p">,</span> <span class="ss">:mswin</span><span class="p">,</span> <span class="ss">:x64_mingw</span><span class="p">,</span> <span class="ss">:jruby</span><span class="p">]</span>
|
472
|
-
</code></pre></div></div>
|
473
|
-
|
474
|
-
<h2 id="auto-regeneration">Auto Regeneration</h2>
|
475
|
-
|
476
|
-
<p>As of v1.3.0, Jekyll uses the <code class="highlighter-rouge">listen</code> gem to watch for changes when the <code class="highlighter-rouge">--watch</code> switch is specified during a build or serve. While <code class="highlighter-rouge">listen</code> has built-in support for UNIX systems, it may require an extra gem for compatibility with Windows.</p>
|
477
|
-
|
478
|
-
<p>Add the following to the Gemfile for your site if you have issues with auto-regeneration on Windows alone:</p>
|
479
|
-
|
480
|
-
<div class="language-ruby highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">gem</span> <span class="s1">'wdm'</span><span class="p">,</span> <span class="s1">'~> 0.1.1'</span> <span class="k">if</span> <span class="no">Gem</span><span class="p">.</span><span class="nf">win_platform?</span>
|
481
|
-
</code></pre></div></div>
|
482
|
-
|
483
|
-
<p>You may first have to download and install the <a href="https://rubyinstaller.org/downloads/">Ruby DevKit</a> by following <a href="https://github.com/oneclick/rubyinstaller/wiki/Development-Kit">the instructions here</a>.</p>
|
484
|
-
|
485
|
-
|
486
|
-
|
487
|
-
|
488
|
-
|
489
|
-
|
490
|
-
|
491
|
-
|
492
|
-
|
493
|
-
|
494
|
-
|
495
|
-
|
496
|
-
|
497
|
-
|
498
|
-
|
499
|
-
|
500
|
-
|
501
|
-
|
502
|
-
<div class="section-nav">
|
503
|
-
<div class="left align-right">
|
504
|
-
|
505
|
-
|
506
|
-
|
507
|
-
<a href="/docs/installation/" class="prev">Back</a>
|
508
|
-
|
509
|
-
</div>
|
510
|
-
<div class="right align-left">
|
511
|
-
|
512
|
-
|
513
|
-
|
514
|
-
<a href="/docs/usage/" class="next">Next</a>
|
515
|
-
|
516
|
-
</div>
|
517
|
-
</div>
|
518
|
-
<div class="clear"></div>
|
519
|
-
|
520
|
-
</article>
|
521
|
-
</div>
|
522
|
-
|
523
|
-
<div class="unit one-fifth hide-on-mobiles">
|
524
|
-
<aside>
|
525
|
-
|
526
|
-
<h4>Getting Started</h4>
|
527
|
-
<ul>
|
528
|
-
|
529
|
-
|
530
|
-
|
531
|
-
<li class=""><a href="/docs/home/">Welcome</a></li>
|
532
|
-
|
533
|
-
|
534
|
-
|
535
|
-
<li class=""><a href="/docs/quickstart/">Quick-start guide</a></li>
|
536
|
-
|
537
|
-
|
538
|
-
|
539
|
-
<li class=""><a href="/docs/installation/">Installation</a></li>
|
540
|
-
|
541
|
-
|
542
|
-
|
543
|
-
<li class="current"><a href="/docs/windows/">Jekyll on Windows</a></li>
|
544
|
-
|
545
|
-
|
546
|
-
|
547
|
-
<li class=""><a href="/docs/usage/">Basic Usage</a></li>
|
548
|
-
|
549
|
-
|
550
|
-
|
551
|
-
<li class=""><a href="/docs/structure/">Directory structure</a></li>
|
552
|
-
|
553
|
-
|
554
|
-
|
555
|
-
<li class=""><a href="/docs/configuration/">Configuration</a></li>
|
556
|
-
|
557
|
-
</ul>
|
558
|
-
|
559
|
-
|
560
|
-
<h4>Your Content</h4>
|
561
|
-
<ul>
|
562
|
-
|
563
|
-
|
564
|
-
|
565
|
-
<li class=""><a href="/docs/frontmatter/">Front Matter</a></li>
|
566
|
-
|
567
|
-
|
568
|
-
|
569
|
-
<li class=""><a href="/docs/posts/">Writing posts</a></li>
|
570
|
-
|
571
|
-
|
572
|
-
|
573
|
-
<li class=""><a href="/docs/drafts/">Working with drafts</a></li>
|
574
|
-
|
575
|
-
|
576
|
-
|
577
|
-
<li class=""><a href="/docs/pages/">Creating pages</a></li>
|
578
|
-
|
579
|
-
|
580
|
-
|
581
|
-
<li class=""><a href="/docs/static-files/">Static Files</a></li>
|
582
|
-
|
583
|
-
|
584
|
-
|
585
|
-
<li class=""><a href="/docs/variables/">Variables</a></li>
|
586
|
-
|
587
|
-
|
588
|
-
|
589
|
-
<li class=""><a href="/docs/collections/">Collections</a></li>
|
590
|
-
|
591
|
-
|
592
|
-
|
593
|
-
<li class=""><a href="/docs/datafiles/">Data Files</a></li>
|
594
|
-
|
595
|
-
|
596
|
-
|
597
|
-
<li class=""><a href="/docs/assets/">Assets</a></li>
|
598
|
-
|
599
|
-
|
600
|
-
|
601
|
-
<li class=""><a href="/docs/migrations/">Blog migrations</a></li>
|
602
|
-
|
603
|
-
</ul>
|
604
|
-
|
605
|
-
|
606
|
-
<h4>Customization</h4>
|
607
|
-
<ul>
|
608
|
-
|
609
|
-
|
610
|
-
|
611
|
-
<li class=""><a href="/docs/templates/">Templates</a></li>
|
612
|
-
|
613
|
-
|
614
|
-
|
615
|
-
<li class=""><a href="/docs/includes/">Includes</a></li>
|
616
|
-
|
617
|
-
|
618
|
-
|
619
|
-
<li class=""><a href="/docs/permalinks/">Permalinks</a></li>
|
620
|
-
|
621
|
-
|
622
|
-
|
623
|
-
<li class=""><a href="/docs/pagination/">Pagination</a></li>
|
624
|
-
|
625
|
-
|
626
|
-
|
627
|
-
<li class=""><a href="/docs/plugins/">Plugins</a></li>
|
628
|
-
|
629
|
-
|
630
|
-
|
631
|
-
<li class=""><a href="/docs/themes/">Themes</a></li>
|
632
|
-
|
633
|
-
|
634
|
-
|
635
|
-
<li class=""><a href="/docs/extras/">Extras</a></li>
|
636
|
-
|
637
|
-
</ul>
|
638
|
-
|
639
|
-
|
640
|
-
<h4>Deployment</h4>
|
641
|
-
<ul>
|
642
|
-
|
643
|
-
|
644
|
-
|
645
|
-
<li class=""><a href="/docs/github-pages/">GitHub Pages</a></li>
|
646
|
-
|
647
|
-
|
648
|
-
|
649
|
-
<li class=""><a href="/docs/deployment-methods/">Deployment methods</a></li>
|
650
|
-
|
651
|
-
|
652
|
-
|
653
|
-
<li class=""><a href="/docs/continuous-integration/">Continuous Integration</a></li>
|
654
|
-
|
655
|
-
</ul>
|
656
|
-
|
657
|
-
|
658
|
-
<h4>Miscellaneous</h4>
|
659
|
-
<ul>
|
660
|
-
|
661
|
-
|
662
|
-
|
663
|
-
<li class=""><a href="/docs/troubleshooting/">Troubleshooting</a></li>
|
664
|
-
|
665
|
-
|
666
|
-
|
667
|
-
<li class=""><a href="/docs/sites/">Sites using Jekyll</a></li>
|
668
|
-
|
669
|
-
|
670
|
-
|
671
|
-
<li class=""><a href="/docs/resources/">Resources</a></li>
|
672
|
-
|
673
|
-
|
674
|
-
|
675
|
-
<li class=""><a href="/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
|
676
|
-
|
677
|
-
|
678
|
-
|
679
|
-
<li class=""><a href="/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
|
680
|
-
|
681
|
-
</ul>
|
682
|
-
|
683
|
-
|
684
|
-
<h4>Meta</h4>
|
685
|
-
<ul>
|
686
|
-
|
687
|
-
|
688
|
-
|
689
|
-
<li class=""><a href="/docs/contributing/">Contributing</a></li>
|
690
|
-
|
691
|
-
|
692
|
-
|
693
|
-
<li class=""><a href="/docs/maintaining/">Maintaining Jekyll</a></li>
|
694
|
-
|
695
|
-
|
696
|
-
|
697
|
-
<li class=""><a href="/docs/conduct/">Code of Conduct</a></li>
|
698
|
-
|
699
|
-
|
700
|
-
|
701
|
-
<li class=""><a href="/docs/history/">History</a></li>
|
702
|
-
|
703
|
-
</ul>
|
704
|
-
|
705
|
-
|
706
|
-
</aside>
|
707
|
-
</div>
|
708
|
-
|
709
|
-
|
710
|
-
<div class="clear"></div>
|
711
|
-
|
712
|
-
</div>
|
713
|
-
</section>
|
714
|
-
|
715
|
-
|
716
|
-
<footer>
|
717
|
-
<div class="grid">
|
718
|
-
<div class="unit one-third center-on-mobiles">
|
719
|
-
<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>
|
720
|
-
</div>
|
721
|
-
<div class="unit two-thirds align-right center-on-mobiles">
|
722
|
-
<p>
|
723
|
-
Proudly hosted by
|
724
|
-
<a href="https://github.com">
|
725
|
-
<img src="/img/footer-logo.png" width="100" height="30" alt="GitHub • Social coding">
|
726
|
-
</a>
|
727
|
-
</p>
|
728
|
-
</div>
|
729
|
-
</div>
|
730
|
-
</footer>
|
731
|
-
|
732
|
-
<script>
|
733
|
-
var anchorForId = function (id) {
|
734
|
-
var anchor = document.createElement("a");
|
735
|
-
anchor.className = "header-link";
|
736
|
-
anchor.href = "#" + id;
|
737
|
-
anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
|
738
|
-
anchor.title = "Permalink";
|
739
|
-
return anchor;
|
740
|
-
};
|
741
|
-
|
742
|
-
var linkifyAnchors = function (level, containingElement) {
|
743
|
-
var headers = containingElement.getElementsByTagName("h" + level);
|
744
|
-
for (var h = 0; h < headers.length; h++) {
|
745
|
-
var header = headers[h];
|
746
|
-
|
747
|
-
if (typeof header.id !== "undefined" && header.id !== "") {
|
748
|
-
header.appendChild(anchorForId(header.id));
|
749
|
-
}
|
750
|
-
}
|
751
|
-
};
|
752
|
-
|
753
|
-
document.onreadystatechange = function () {
|
754
|
-
if (this.readyState === "complete") {
|
755
|
-
var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
|
756
|
-
if (!contentBlock) {
|
757
|
-
return;
|
758
|
-
}
|
759
|
-
for (var level = 1; level <= 6; level++) {
|
760
|
-
linkifyAnchors(level, contentBlock);
|
761
|
-
}
|
762
|
-
}
|
763
|
-
};
|
764
|
-
</script>
|
765
|
-
|
766
|
-
|
767
|
-
<!-- Gauges (http://get.gaug.es/) -->
|
768
|
-
<script>
|
769
|
-
var _gauges = _gauges || [];
|
770
|
-
(function() {
|
771
|
-
var t = document.createElement('script');
|
772
|
-
t.type = 'text/javascript';
|
773
|
-
t.async = true;
|
774
|
-
t.id = 'gauges-tracker';
|
775
|
-
t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
|
776
|
-
t.src = '//secure.gaug.es/track.js';
|
777
|
-
var s = document.getElementsByTagName('script')[0];
|
778
|
-
s.parentNode.insertBefore(t, s);
|
779
|
-
})();
|
780
|
-
</script>
|
781
|
-
|
782
|
-
|
783
|
-
|
784
|
-
<!-- Google Analytics (https://www.google.com/analytics) -->
|
785
|
-
<script>
|
786
|
-
!function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
|
787
|
-
(j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
|
788
|
-
L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
|
789
|
-
L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
|
790
|
-
|
791
|
-
ga('create', 'UA-50755011-1', 'jekyllrb.com');
|
792
|
-
ga('send', 'pageview');
|
793
|
-
|
794
|
-
</script>
|
795
|
-
|
796
|
-
|
797
|
-
|
798
|
-
</body>
|
799
|
-
</html>
|