jekyll-docs 3.1.6 → 3.2.0
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.
- checksums.yaml +4 -4
- data/lib/jekyll-docs.rb +7 -13
- data/site/community/index.html +305 -0
- data/site/conduct/index.html +10 -0
- data/site/css/screen.css +1445 -0
- data/site/docs/assets/index.html +701 -0
- data/site/docs/collections/index.html +973 -0
- data/site/docs/conduct/index.html +718 -0
- data/site/docs/configuration/index.html +1337 -0
- data/site/docs/continuous-integration/index.html +846 -0
- data/site/docs/contributing/index.html +815 -0
- data/site/docs/datafiles/index.html +742 -0
- data/site/docs/deployment-methods/index.html +866 -0
- data/site/docs/drafts/index.html +615 -0
- data/site/docs/extras/index.html +656 -0
- data/site/docs/frontmatter/index.html +776 -0
- data/site/docs/github-pages/index.html +778 -0
- data/site/docs/history/index.html +3293 -0
- data/site/docs/home/index.html +627 -0
- data/site/docs/index.html +10 -0
- data/site/docs/installation/index.html +682 -0
- data/site/docs/migrations/index.html +627 -0
- data/site/docs/pages/index.html +698 -0
- data/site/docs/pagination/index.html +840 -0
- data/site/docs/permalinks/index.html +924 -0
- data/site/docs/plugins/index.html +1726 -0
- data/site/docs/posts/index.html +811 -0
- data/site/docs/quickstart/index.html +599 -0
- data/site/docs/resources/index.html +717 -0
- data/site/docs/sites/index.html +676 -0
- data/site/docs/static-files/index.html +655 -0
- data/site/docs/structure/index.html +794 -0
- data/site/docs/templates/index.html +1105 -0
- data/site/docs/themes/index.html +751 -0
- data/site/docs/troubleshooting/index.html +826 -0
- data/site/docs/upgrading/0-to-2/index.html +802 -0
- data/site/docs/upgrading/2-to-3/index.html +785 -0
- data/site/docs/upgrading/index.html +664 -0
- data/site/docs/usage/index.html +673 -0
- data/site/docs/variables/index.html +1013 -0
- data/site/docs/windows/index.html +775 -0
- data/site/feed.xml +222 -0
- data/site/github.html +10 -0
- data/site/help/index.html +246 -0
- data/site/img/article-footer.png +0 -0
- data/site/img/footer-logo.png +0 -0
- data/site/img/logo-2x.png +0 -0
- data/site/index.html +200 -16
- data/site/issues.html +10 -0
- data/site/news/2013/05/05/jekyll-1-0-0-released/index.html +524 -0
- data/site/news/2013/05/08/jekyll-1-0-1-released/index.html +524 -0
- data/site/news/2013/05/12/jekyll-1-0-2-released/index.html +525 -0
- data/site/news/2013/06/07/jekyll-1-0-3-released/index.html +522 -0
- data/site/news/2013/07/14/jekyll-1-1-0-released/index.html +524 -0
- data/site/news/2013/07/24/jekyll-1-1-1-released/index.html +523 -0
- data/site/news/2013/07/25/jekyll-1-0-4-released/index.html +519 -0
- data/site/news/2013/07/25/jekyll-1-1-2-released/index.html +519 -0
- data/site/news/2013/09/06/jekyll-1-2-0-released/index.html +526 -0
- data/site/news/2013/09/14/jekyll-1-2-1-released/index.html +520 -0
- data/site/news/2013/10/28/jekyll-1-3-0-rc1-released/index.html +518 -0
- data/site/news/2013/11/04/jekyll-1-3-0-released/index.html +553 -0
- data/site/news/2013/11/26/jekyll-1-3-1-released/index.html +522 -0
- data/site/news/2013/12/07/jekyll-1-4-0-released/index.html +537 -0
- data/site/news/2013/12/09/jekyll-1-4-1-released/index.html +519 -0
- data/site/news/2013/12/16/jekyll-1-4-2-released/index.html +518 -0
- data/site/news/2014/01/13/jekyll-1-4-3-released/index.html +527 -0
- data/site/news/2014/03/24/jekyll-1-5-0-released/index.html +518 -0
- data/site/news/2014/03/27/jekyll-1-5-1-released/index.html +523 -0
- data/site/news/2014/05/06/jekyll-turns-2-0-0/index.html +539 -0
- data/site/news/2014/05/08/jekyll-2-0-3-released/index.html +519 -0
- data/site/news/2014/06/04/jekyll-stickers-1-dollar-stickermule/index.html +521 -0
- data/site/news/2014/06/28/jekyll-turns-21-i-mean-2-1-0/index.html +536 -0
- data/site/news/2014/07/01/jekyll-2-1-1-released/index.html +533 -0
- data/site/news/2014/07/29/jekyll-2-2-0-released/index.html +522 -0
- data/site/news/2014/08/10/jekyll-2-3-0-released/index.html +542 -0
- data/site/news/2014/09/09/jekyll-2-4-0-released/index.html +528 -0
- data/site/news/2014/11/05/jekylls-midlife-crisis-jekyll-turns-2-5-0/index.html +551 -0
- data/site/news/2014/11/09/jekyll-2-5-1-released/index.html +529 -0
- data/site/news/2014/11/12/jekyll-2-5-2-released/index.html +519 -0
- data/site/news/2014/12/17/alfredxing-welcome-to-jekyll-core/index.html +526 -0
- data/site/news/2014/12/22/jekyll-2-5-3-released/index.html +521 -0
- data/site/news/2015/01/20/jekyll-meet-and-greet/index.html +522 -0
- data/site/news/2015/01/24/jekyll-3-0-0-beta1-released/index.html +542 -0
- data/site/news/2015/02/26/introducing-jekyll-talk/index.html +517 -0
- data/site/news/2015/10/26/jekyll-3-0-released/index.html +546 -0
- data/site/news/2015/11/17/jekyll-3-0-1-released/index.html +530 -0
- data/site/news/2016/01/20/jekyll-3-0-2-released/index.html +520 -0
- data/site/news/2016/01/24/jekyll-3-1-0-released/index.html +553 -0
- data/site/news/2016/01/28/jekyll-3-1-1-released/index.html +537 -0
- data/site/news/2016/02/08/jekyll-3-0-3-released/index.html +532 -0
- data/site/news/2016/02/19/jekyll-3-1-2-released/index.html +523 -0
- data/site/news/2016/03/10/making-it-easier-to-contribute-to-jekyll/index.html +519 -0
- data/site/news/2016/04/19/jekyll-3-0-4-released/index.html +525 -0
- data/site/news/2016/04/19/jekyll-3-1-3-released/index.html +521 -0
- data/site/news/2016/04/26/jekyll-3-0-5-released/index.html +526 -0
- data/site/news/2016/05/18/jekyll-3-1-4-released/index.html +530 -0
- data/site/news/2016/05/18/jekyll-3-1-5-released/index.html +518 -0
- data/site/news/2016/05/19/jekyll-3-1-6-released/index.html +520 -0
- data/site/news/2016/06/03/update-on-jekyll-s-google-summer-of-code-projects/index.html +521 -0
- data/site/news/2016/07/26/jekyll-3-2-0-released/index.html +630 -0
- data/site/news/index.html +2831 -10
- data/site/news/releases/index.html +2603 -10
- data/site/sitemap.xml +327 -0
- metadata +99 -111
- data/site/_config.yml +0 -25
- data/site/_data/docs.yml +0 -49
- data/site/_docs/assets.md +0 -94
- data/site/_docs/collections.md +0 -380
- data/site/_docs/conduct.md +0 -55
- data/site/_docs/configuration.md +0 -747
- data/site/_docs/continuous-integration.md +0 -221
- data/site/_docs/contributing.md +0 -124
- data/site/_docs/datafiles.md +0 -151
- data/site/_docs/deployment-methods.md +0 -213
- data/site/_docs/drafts.md +0 -20
- data/site/_docs/extras.md +0 -22
- data/site/_docs/frontmatter.md +0 -191
- data/site/_docs/github-pages.md +0 -133
- data/site/_docs/history.md +0 -2323
- data/site/_docs/index.md +0 -57
- data/site/_docs/installation.md +0 -106
- data/site/_docs/migrations.md +0 -9
- data/site/_docs/pages.md +0 -100
- data/site/_docs/pagination.md +0 -224
- data/site/_docs/permalinks.md +0 -308
- data/site/_docs/plugins.md +0 -903
- data/site/_docs/posts.md +0 -237
- data/site/_docs/quickstart.md +0 -26
- data/site/_docs/resources.md +0 -38
- data/site/_docs/sites.md +0 -23
- data/site/_docs/static_files.md +0 -52
- data/site/_docs/structure.md +0 -211
- data/site/_docs/templates.md +0 -451
- data/site/_docs/troubleshooting.md +0 -207
- data/site/_docs/upgrading.md +0 -10
- data/site/_docs/upgrading/0-to-2.md +0 -140
- data/site/_docs/upgrading/2-to-3.md +0 -126
- data/site/_docs/usage.md +0 -101
- data/site/_docs/variables.md +0 -390
- data/site/_docs/windows.md +0 -46
- data/site/_includes/analytics.html +0 -30
- data/site/_includes/anchor_links.html +0 -33
- data/site/_includes/docs_contents.html +0 -8
- data/site/_includes/docs_contents_mobile.html +0 -10
- data/site/_includes/docs_option.html +0 -11
- data/site/_includes/docs_ul.html +0 -17
- data/site/_includes/footer.html +0 -15
- data/site/_includes/header.html +0 -18
- data/site/_includes/news_contents.html +0 -33
- data/site/_includes/news_contents_mobile.html +0 -11
- data/site/_includes/news_item.html +0 -24
- data/site/_includes/primary-nav-items.html +0 -17
- data/site/_includes/section_nav.html +0 -39
- data/site/_includes/top.html +0 -17
- data/site/_layouts/default.html +0 -13
- data/site/_layouts/docs.html +0 -26
- data/site/_layouts/news.html +0 -19
- data/site/_layouts/news_item.html +0 -27
- data/site/_layouts/page.html +0 -18
- data/site/_posts/2013-05-06-jekyll-1-0-0-released.markdown +0 -23
- data/site/_posts/2013-05-08-jekyll-1-0-1-released.markdown +0 -27
- data/site/_posts/2013-05-12-jekyll-1-0-2-released.markdown +0 -28
- data/site/_posts/2013-06-07-jekyll-1-0-3-released.markdown +0 -25
- data/site/_posts/2013-07-14-jekyll-1-1-0-released.markdown +0 -27
- data/site/_posts/2013-07-24-jekyll-1-1-1-released.markdown +0 -31
- data/site/_posts/2013-07-25-jekyll-1-0-4-released.markdown +0 -20
- data/site/_posts/2013-07-25-jekyll-1-1-2-released.markdown +0 -20
- data/site/_posts/2013-09-06-jekyll-1-2-0-released.markdown +0 -23
- data/site/_posts/2013-09-14-jekyll-1-2-1-released.markdown +0 -19
- data/site/_posts/2013-10-28-jekyll-1-3-0-rc1-released.markdown +0 -17
- data/site/_posts/2013-11-04-jekyll-1-3-0-released.markdown +0 -43
- data/site/_posts/2013-11-26-jekyll-1-3-1-released.markdown +0 -21
- data/site/_posts/2013-12-07-jekyll-1-4-0-released.markdown +0 -30
- data/site/_posts/2013-12-09-jekyll-1-4-1-released.markdown +0 -18
- data/site/_posts/2013-12-16-jekyll-1-4-2-released.markdown +0 -18
- data/site/_posts/2014-01-13-jekyll-1-4-3-released.markdown +0 -26
- data/site/_posts/2014-03-24-jekyll-1-5-0-released.markdown +0 -19
- data/site/_posts/2014-03-27-jekyll-1-5-1-released.markdown +0 -26
- data/site/_posts/2014-05-06-jekyll-turns-2-0-0.markdown +0 -31
- data/site/_posts/2014-05-08-jekyll-2-0-3-released.markdown +0 -18
- data/site/_posts/2014-06-04-jekyll-stickers-1-dollar-stickermule.markdown +0 -19
- data/site/_posts/2014-06-28-jekyll-turns-21-i-mean-2-1-0.markdown +0 -31
- data/site/_posts/2014-07-01-jekyll-2-1-1-released.markdown +0 -30
- data/site/_posts/2014-07-29-jekyll-2-2-0-released.markdown +0 -19
- data/site/_posts/2014-08-10-jekyll-2-3-0-released.markdown +0 -41
- data/site/_posts/2014-09-09-jekyll-2-4-0-released.markdown +0 -25
- data/site/_posts/2014-11-06-jekylls-midlife-crisis-jekyll-turns-2-5-0.markdown +0 -47
- data/site/_posts/2014-11-08-jekyll-2-5-1-released.markdown +0 -29
- data/site/_posts/2014-11-12-jekyll-2-5-2-released.markdown +0 -18
- data/site/_posts/2014-12-17-alfredxing-welcome-to-jekyll-core.md +0 -27
- data/site/_posts/2014-12-22-jekyll-2-5-3-released.markdown +0 -20
- data/site/_posts/2015-01-20-jekyll-meet-and-greet.markdown +0 -20
- data/site/_posts/2015-01-24-jekyll-3-0-0-beta1-released.markdown +0 -40
- data/site/_posts/2015-02-26-introducing-jekyll-talk.markdown +0 -15
- data/site/_posts/2015-10-26-jekyll-3-0-released.markdown +0 -35
- data/site/_posts/2015-11-17-jekyll-3-0-1-released.markdown +0 -25
- data/site/_posts/2016-01-20-jekyll-3-0-2-released.markdown +0 -19
- data/site/_posts/2016-01-24-jekyll-3-1-0-released.markdown +0 -50
- data/site/_posts/2016-01-28-jekyll-3-1-1-released.markdown +0 -33
- data/site/_posts/2016-02-08-jekyll-3-0-3-released.markdown +0 -32
- data/site/_posts/2016-02-19-jekyll-3-1-2-released.markdown +0 -20
- data/site/_sass/_font-awesome.scss +0 -25
- data/site/_sass/_gridism.scss +0 -124
- data/site/_sass/_mixins.scss +0 -38
- data/site/_sass/_normalize.scss +0 -1
- data/site/_sass/_pygments.scss +0 -78
- data/site/_sass/_style.scss +0 -1002
- data/site/css/screen.scss +0 -9
- data/site/help/index.md +0 -41
- data/site/redirects/github.html +0 -4
- data/site/redirects/issues.html +0 -4
|
@@ -0,0 +1,701 @@
|
|
|
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.2.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.0.0 -->
|
|
14
|
+
<title>Assets - Jekyll • Simple, blog-aware, static sites</title>
|
|
15
|
+
<meta property="og:title" content="Assets">
|
|
16
|
+
<meta name="description" content="Transform your plain text into static websites and blogs">
|
|
17
|
+
<meta property="og:description" content="Transform your plain text into static websites and blogs">
|
|
18
|
+
<link rel="canonical" href="https://jekyllrb.com/docs/assets/">
|
|
19
|
+
<meta property="og:url" content="https://jekyllrb.com/docs/assets/">
|
|
20
|
+
<meta property="og:site_name" content="Jekyll • Simple, blog-aware, static sites">
|
|
21
|
+
<meta property="og:type" content="article">
|
|
22
|
+
<meta property="article:published_time" content="2016-07-27T18:44:57-07:00">
|
|
23
|
+
<meta name="twitter:card" content="summary">
|
|
24
|
+
<meta name="twitter:site" content="@jekyllrb">
|
|
25
|
+
<meta name="google-site-verification" content="onQcXpAvtHBrUI5LlroHNE_FP0b2qvFyPq7VZw36iEY">
|
|
26
|
+
<script type="application/ld+json">
|
|
27
|
+
{
|
|
28
|
+
"@context": "http://schema.org",
|
|
29
|
+
"@type": "BlogPosting",
|
|
30
|
+
"headline": "Assets",
|
|
31
|
+
"datePublished": "2016-07-27T18:44:57-07:00",
|
|
32
|
+
"description": "Transform your plain text into static websites and blogs",
|
|
33
|
+
"logo": "https://jekyllrb.comimg/logo-2x.png",
|
|
34
|
+
"url": "https://jekyllrb.com/docs/assets/"
|
|
35
|
+
}
|
|
36
|
+
</script>
|
|
37
|
+
<!-- End Jekyll SEO tag -->
|
|
38
|
+
<!--[if lt IE 9]>
|
|
39
|
+
<script src="/js/html5shiv.min.js"></script>
|
|
40
|
+
<script src="/js/respond.min.js"></script>
|
|
41
|
+
<![endif]-->
|
|
42
|
+
</head>
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
<body class="wrap">
|
|
46
|
+
<header>
|
|
47
|
+
<nav class="mobile-nav show-on-mobiles">
|
|
48
|
+
<ul>
|
|
49
|
+
<li class="">
|
|
50
|
+
<a href="/">Home</a>
|
|
51
|
+
</li>
|
|
52
|
+
<li class="current">
|
|
53
|
+
<a href="/docs/home/">Docs</a>
|
|
54
|
+
</li>
|
|
55
|
+
<li class="">
|
|
56
|
+
<a href="/news/">News</a>
|
|
57
|
+
</li>
|
|
58
|
+
<li class="">
|
|
59
|
+
<a href="/community/">Community</a>
|
|
60
|
+
</li>
|
|
61
|
+
<li class="">
|
|
62
|
+
<a href="/help/">Help</a>
|
|
63
|
+
</li>
|
|
64
|
+
<li>
|
|
65
|
+
<a href="https://github.com/jekyll/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a>
|
|
66
|
+
</li>
|
|
67
|
+
</ul>
|
|
68
|
+
|
|
69
|
+
</nav>
|
|
70
|
+
<div class="grid">
|
|
71
|
+
<div class="unit one-third center-on-mobiles">
|
|
72
|
+
<h1>
|
|
73
|
+
<a href="/">
|
|
74
|
+
<span class="sr-only">Jekyll</span>
|
|
75
|
+
<img src="/img/logo-2x.png" width="249" height="115" alt="Jekyll Logo">
|
|
76
|
+
</a>
|
|
77
|
+
</h1>
|
|
78
|
+
</div>
|
|
79
|
+
<nav class="main-nav unit two-thirds hide-on-mobiles">
|
|
80
|
+
<ul>
|
|
81
|
+
<li class="">
|
|
82
|
+
<a href="/">Home</a>
|
|
83
|
+
</li>
|
|
84
|
+
<li class="current">
|
|
85
|
+
<a href="/docs/home/">Docs</a>
|
|
86
|
+
</li>
|
|
87
|
+
<li class="">
|
|
88
|
+
<a href="/news/">News</a>
|
|
89
|
+
</li>
|
|
90
|
+
<li class="">
|
|
91
|
+
<a href="/community/">Community</a>
|
|
92
|
+
</li>
|
|
93
|
+
<li class="">
|
|
94
|
+
<a href="/help/">Help</a>
|
|
95
|
+
</li>
|
|
96
|
+
<li>
|
|
97
|
+
<a href="https://github.com/jekyll/jekyll"><span class="hide-on-mobiles">View on </span>GitHub</a>
|
|
98
|
+
</li>
|
|
99
|
+
</ul>
|
|
100
|
+
|
|
101
|
+
</nav>
|
|
102
|
+
</div>
|
|
103
|
+
</header>
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
<section class="docs">
|
|
107
|
+
<div class="grid">
|
|
108
|
+
|
|
109
|
+
<div class="docs-nav-mobile unit whole show-on-mobiles">
|
|
110
|
+
<select onchange="if (this.value) window.location.href=this.value">
|
|
111
|
+
<option value="">Navigate the docs…</option>
|
|
112
|
+
|
|
113
|
+
<optgroup label="Getting Started">
|
|
114
|
+
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
<option value="https://jekyllrb.com/docs/home/">Welcome</option>
|
|
118
|
+
|
|
119
|
+
|
|
120
|
+
|
|
121
|
+
<option value="https://jekyllrb.com/docs/quickstart/">Quick-start guide</option>
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
|
|
125
|
+
<option value="https://jekyllrb.com/docs/installation/">Installation</option>
|
|
126
|
+
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
<option value="https://jekyllrb.com/docs/usage/">Basic Usage</option>
|
|
130
|
+
|
|
131
|
+
|
|
132
|
+
|
|
133
|
+
<option value="https://jekyllrb.com/docs/structure/">Directory structure</option>
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
|
|
137
|
+
<option value="https://jekyllrb.com/docs/configuration/">Configuration</option>
|
|
138
|
+
|
|
139
|
+
|
|
140
|
+
</optgroup>
|
|
141
|
+
|
|
142
|
+
<optgroup label="Your Content">
|
|
143
|
+
|
|
144
|
+
|
|
145
|
+
|
|
146
|
+
<option value="https://jekyllrb.com/docs/frontmatter/">Front Matter</option>
|
|
147
|
+
|
|
148
|
+
|
|
149
|
+
|
|
150
|
+
<option value="https://jekyllrb.com/docs/posts/">Writing posts</option>
|
|
151
|
+
|
|
152
|
+
|
|
153
|
+
|
|
154
|
+
<option value="https://jekyllrb.com/docs/drafts/">Working with drafts</option>
|
|
155
|
+
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
<option value="https://jekyllrb.com/docs/pages/">Creating pages</option>
|
|
159
|
+
|
|
160
|
+
|
|
161
|
+
|
|
162
|
+
<option value="https://jekyllrb.com/docs/static-files/">Static Files</option>
|
|
163
|
+
|
|
164
|
+
|
|
165
|
+
|
|
166
|
+
<option value="https://jekyllrb.com/docs/variables/">Variables</option>
|
|
167
|
+
|
|
168
|
+
|
|
169
|
+
|
|
170
|
+
<option value="https://jekyllrb.com/docs/collections/">Collections</option>
|
|
171
|
+
|
|
172
|
+
|
|
173
|
+
|
|
174
|
+
<option value="https://jekyllrb.com/docs/datafiles/">Data Files</option>
|
|
175
|
+
|
|
176
|
+
|
|
177
|
+
|
|
178
|
+
<option value="https://jekyllrb.com/docs/assets/">Assets</option>
|
|
179
|
+
|
|
180
|
+
|
|
181
|
+
|
|
182
|
+
<option value="https://jekyllrb.com/docs/migrations/">Blog migrations</option>
|
|
183
|
+
|
|
184
|
+
|
|
185
|
+
</optgroup>
|
|
186
|
+
|
|
187
|
+
<optgroup label="Customization">
|
|
188
|
+
|
|
189
|
+
|
|
190
|
+
|
|
191
|
+
<option value="https://jekyllrb.com/docs/templates/">Templates</option>
|
|
192
|
+
|
|
193
|
+
|
|
194
|
+
|
|
195
|
+
<option value="https://jekyllrb.com/docs/permalinks/">Permalinks</option>
|
|
196
|
+
|
|
197
|
+
|
|
198
|
+
|
|
199
|
+
<option value="https://jekyllrb.com/docs/pagination/">Pagination</option>
|
|
200
|
+
|
|
201
|
+
|
|
202
|
+
|
|
203
|
+
<option value="https://jekyllrb.com/docs/plugins/">Plugins</option>
|
|
204
|
+
|
|
205
|
+
|
|
206
|
+
|
|
207
|
+
<option value="https://jekyllrb.com/docs/themes/">Themes</option>
|
|
208
|
+
|
|
209
|
+
|
|
210
|
+
|
|
211
|
+
<option value="https://jekyllrb.com/docs/extras/">Extras</option>
|
|
212
|
+
|
|
213
|
+
|
|
214
|
+
</optgroup>
|
|
215
|
+
|
|
216
|
+
<optgroup label="Deployment">
|
|
217
|
+
|
|
218
|
+
|
|
219
|
+
|
|
220
|
+
<option value="https://jekyllrb.com/docs/github-pages/">GitHub Pages</option>
|
|
221
|
+
|
|
222
|
+
|
|
223
|
+
|
|
224
|
+
<option value="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</option>
|
|
225
|
+
|
|
226
|
+
|
|
227
|
+
|
|
228
|
+
<option value="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</option>
|
|
229
|
+
|
|
230
|
+
|
|
231
|
+
</optgroup>
|
|
232
|
+
|
|
233
|
+
<optgroup label="Miscellaneous">
|
|
234
|
+
|
|
235
|
+
|
|
236
|
+
|
|
237
|
+
<option value="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</option>
|
|
238
|
+
|
|
239
|
+
|
|
240
|
+
|
|
241
|
+
<option value="https://jekyllrb.com/docs/sites/">Sites using Jekyll</option>
|
|
242
|
+
|
|
243
|
+
|
|
244
|
+
|
|
245
|
+
<option value="https://jekyllrb.com/docs/resources/">Resources</option>
|
|
246
|
+
|
|
247
|
+
|
|
248
|
+
|
|
249
|
+
<option value="https://jekyllrb.com/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</option>
|
|
250
|
+
|
|
251
|
+
|
|
252
|
+
|
|
253
|
+
<option value="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</option>
|
|
254
|
+
|
|
255
|
+
|
|
256
|
+
</optgroup>
|
|
257
|
+
|
|
258
|
+
<optgroup label="Meta">
|
|
259
|
+
|
|
260
|
+
|
|
261
|
+
|
|
262
|
+
<option value="https://jekyllrb.com/docs/contributing/">Contributing</option>
|
|
263
|
+
|
|
264
|
+
|
|
265
|
+
|
|
266
|
+
<option value="https://jekyllrb.com/docs/conduct/">Code of Conduct</option>
|
|
267
|
+
|
|
268
|
+
|
|
269
|
+
|
|
270
|
+
<option value="https://jekyllrb.com/docs/history/">History</option>
|
|
271
|
+
|
|
272
|
+
|
|
273
|
+
</optgroup>
|
|
274
|
+
|
|
275
|
+
</select>
|
|
276
|
+
</div>
|
|
277
|
+
|
|
278
|
+
|
|
279
|
+
<div class="unit four-fifths">
|
|
280
|
+
<article>
|
|
281
|
+
<div class="improve right hide-on-mobiles">
|
|
282
|
+
<a href="https://github.com/jekyll/jekyll/edit/master/site/_docs/assets.md"><i class="fa fa-pencil"></i> Improve this page</a>
|
|
283
|
+
</div>
|
|
284
|
+
<h1>Assets</h1>
|
|
285
|
+
<p>Jekyll provides built-in support for Sass and can work with CoffeeScript via
|
|
286
|
+
a Ruby gem. In order to use them, you must first create a file with the
|
|
287
|
+
proper extension name (one of <code class="highlighter-rouge">.sass</code>, <code class="highlighter-rouge">.scss</code>, or <code class="highlighter-rouge">.coffee</code>) and <strong><em>start the
|
|
288
|
+
file with two lines of triple dashes</em></strong>, like this:</p>
|
|
289
|
+
|
|
290
|
+
<figure class="highlight"><pre><code class="language-sass" data-lang="sass"><span class="nt">---</span>
|
|
291
|
+
<span class="nt">---</span>
|
|
292
|
+
|
|
293
|
+
<span class="c1">// start content
|
|
294
|
+
</span><span class="nc">.my-definition</span>
|
|
295
|
+
<span class="nl">font-size</span><span class="p">:</span> <span class="m">1</span><span class="mi">.2em</span></code></pre></figure>
|
|
296
|
+
|
|
297
|
+
<p>Jekyll treats these files the same as a regular page, in that the output file
|
|
298
|
+
will be placed in the same directory that it came from. For instance, if you
|
|
299
|
+
have a file named <code class="highlighter-rouge">css/styles.scss</code> in your site’s source folder, Jekyll
|
|
300
|
+
will process it and put it in your site’s destination folder under
|
|
301
|
+
<code class="highlighter-rouge">css/styles.css</code>.</p>
|
|
302
|
+
|
|
303
|
+
<div class="note info">
|
|
304
|
+
<h5>Jekyll processes all Liquid filters and tags in asset files</h5>
|
|
305
|
+
<p>If you are using <a href="https://mustache.github.io">Mustache</a>
|
|
306
|
+
or another JavaScript templating language that conflicts with
|
|
307
|
+
the <a href="/docs/templates/">Liquid template syntax</a>, you
|
|
308
|
+
will need to place <code>{% raw %}</code> and
|
|
309
|
+
<code>{% endraw %}</code> tags around your code.</p>
|
|
310
|
+
</div>
|
|
311
|
+
|
|
312
|
+
<h2 id="sassscss">Sass/SCSS</h2>
|
|
313
|
+
|
|
314
|
+
<p>Jekyll allows you to customize your Sass conversion in certain ways.</p>
|
|
315
|
+
|
|
316
|
+
<p>Place all your partials in your <code class="highlighter-rouge">sass_dir</code>, which defaults to
|
|
317
|
+
<code class="highlighter-rouge"><source>/_sass</code>. Place your main SCSS or Sass files in the place you want
|
|
318
|
+
them to be in the output file, such as <code class="highlighter-rouge"><source>/css</code>. For an example, take
|
|
319
|
+
a look at <a href="https://github.com/jekyll/jekyll-sass-converter/tree/master/example">this example site using Sass support in Jekyll</a>.</p>
|
|
320
|
+
|
|
321
|
+
<p>If you are using Sass <code class="highlighter-rouge">@import</code> statements, you’ll need to ensure that your
|
|
322
|
+
<code class="highlighter-rouge">sass_dir</code> is set to the base directory that contains your Sass files. You
|
|
323
|
+
can do that thusly:</p>
|
|
324
|
+
|
|
325
|
+
<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">sass</span><span class="pi">:</span>
|
|
326
|
+
<span class="s">sass_dir</span><span class="pi">:</span> <span class="s">_sass</span></code></pre></figure>
|
|
327
|
+
|
|
328
|
+
<p>The Sass converter will default the <code class="highlighter-rouge">sass_dir</code> configuration option to
|
|
329
|
+
<code class="highlighter-rouge">_sass</code>.</p>
|
|
330
|
+
|
|
331
|
+
<div class="note info">
|
|
332
|
+
<h5>The <code>sass_dir</code> is only used by Sass</h5>
|
|
333
|
+
<p>
|
|
334
|
+
|
|
335
|
+
Note that the <code>sass_dir</code> becomes the load path for Sass imports,
|
|
336
|
+
nothing more. This means that Jekyll does not know about these files
|
|
337
|
+
directly, so any files here should not contain the YAML Front Matter as
|
|
338
|
+
described above nor will they be transformed as described above. This
|
|
339
|
+
folder should only contain imports.
|
|
340
|
+
|
|
341
|
+
</p>
|
|
342
|
+
</div>
|
|
343
|
+
|
|
344
|
+
<p>You may also specify the output style with the <code class="highlighter-rouge">style</code> option in your
|
|
345
|
+
<code class="highlighter-rouge">_config.yml</code> file:</p>
|
|
346
|
+
|
|
347
|
+
<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">sass</span><span class="pi">:</span>
|
|
348
|
+
<span class="s">style</span><span class="pi">:</span> <span class="s">compressed</span></code></pre></figure>
|
|
349
|
+
|
|
350
|
+
<p>These are passed to Sass, so any output style options Sass supports are valid
|
|
351
|
+
here, too.</p>
|
|
352
|
+
|
|
353
|
+
<h2 id="coffeescript">Coffeescript</h2>
|
|
354
|
+
|
|
355
|
+
<p>To enable Coffeescript in Jekyll 3.0 and up you must</p>
|
|
356
|
+
|
|
357
|
+
<ul>
|
|
358
|
+
<li>Install the <code class="highlighter-rouge">jekyll-coffeescript</code> gem</li>
|
|
359
|
+
<li>Ensure that your <code class="highlighter-rouge">_config.yml</code> is up-to-date and includes the following:</li>
|
|
360
|
+
</ul>
|
|
361
|
+
|
|
362
|
+
<figure class="highlight"><pre><code class="language-yaml" data-lang="yaml"><span class="s">gems</span><span class="pi">:</span>
|
|
363
|
+
<span class="pi">-</span> <span class="s">jekyll-coffeescript</span></code></pre></figure>
|
|
364
|
+
|
|
365
|
+
|
|
366
|
+
|
|
367
|
+
|
|
368
|
+
|
|
369
|
+
|
|
370
|
+
|
|
371
|
+
|
|
372
|
+
|
|
373
|
+
|
|
374
|
+
|
|
375
|
+
|
|
376
|
+
|
|
377
|
+
|
|
378
|
+
|
|
379
|
+
|
|
380
|
+
|
|
381
|
+
|
|
382
|
+
|
|
383
|
+
|
|
384
|
+
|
|
385
|
+
|
|
386
|
+
|
|
387
|
+
|
|
388
|
+
|
|
389
|
+
|
|
390
|
+
|
|
391
|
+
|
|
392
|
+
|
|
393
|
+
|
|
394
|
+
|
|
395
|
+
|
|
396
|
+
|
|
397
|
+
|
|
398
|
+
|
|
399
|
+
|
|
400
|
+
|
|
401
|
+
|
|
402
|
+
|
|
403
|
+
|
|
404
|
+
|
|
405
|
+
|
|
406
|
+
|
|
407
|
+
|
|
408
|
+
|
|
409
|
+
|
|
410
|
+
|
|
411
|
+
|
|
412
|
+
|
|
413
|
+
|
|
414
|
+
|
|
415
|
+
|
|
416
|
+
<div class="section-nav">
|
|
417
|
+
<div class="left align-right">
|
|
418
|
+
|
|
419
|
+
|
|
420
|
+
|
|
421
|
+
<a href="/docs/datafiles/" class="prev">Back</a>
|
|
422
|
+
|
|
423
|
+
</div>
|
|
424
|
+
<div class="right align-left">
|
|
425
|
+
|
|
426
|
+
|
|
427
|
+
|
|
428
|
+
<a href="/docs/migrations/" class="next">Next</a>
|
|
429
|
+
|
|
430
|
+
</div>
|
|
431
|
+
</div>
|
|
432
|
+
<div class="clear"></div>
|
|
433
|
+
|
|
434
|
+
</article>
|
|
435
|
+
</div>
|
|
436
|
+
|
|
437
|
+
<div class="unit one-fifth hide-on-mobiles">
|
|
438
|
+
<aside>
|
|
439
|
+
|
|
440
|
+
<h4>Getting Started</h4>
|
|
441
|
+
<ul>
|
|
442
|
+
|
|
443
|
+
|
|
444
|
+
|
|
445
|
+
<li class=""><a href="https://jekyllrb.com/docs/home/">Welcome</a></li>
|
|
446
|
+
|
|
447
|
+
|
|
448
|
+
|
|
449
|
+
<li class=""><a href="https://jekyllrb.com/docs/quickstart/">Quick-start guide</a></li>
|
|
450
|
+
|
|
451
|
+
|
|
452
|
+
|
|
453
|
+
<li class=""><a href="https://jekyllrb.com/docs/installation/">Installation</a></li>
|
|
454
|
+
|
|
455
|
+
|
|
456
|
+
|
|
457
|
+
<li class=""><a href="https://jekyllrb.com/docs/usage/">Basic Usage</a></li>
|
|
458
|
+
|
|
459
|
+
|
|
460
|
+
|
|
461
|
+
<li class=""><a href="https://jekyllrb.com/docs/structure/">Directory structure</a></li>
|
|
462
|
+
|
|
463
|
+
|
|
464
|
+
|
|
465
|
+
<li class=""><a href="https://jekyllrb.com/docs/configuration/">Configuration</a></li>
|
|
466
|
+
|
|
467
|
+
</ul>
|
|
468
|
+
|
|
469
|
+
|
|
470
|
+
<h4>Your Content</h4>
|
|
471
|
+
<ul>
|
|
472
|
+
|
|
473
|
+
|
|
474
|
+
|
|
475
|
+
<li class=""><a href="https://jekyllrb.com/docs/frontmatter/">Front Matter</a></li>
|
|
476
|
+
|
|
477
|
+
|
|
478
|
+
|
|
479
|
+
<li class=""><a href="https://jekyllrb.com/docs/posts/">Writing posts</a></li>
|
|
480
|
+
|
|
481
|
+
|
|
482
|
+
|
|
483
|
+
<li class=""><a href="https://jekyllrb.com/docs/drafts/">Working with drafts</a></li>
|
|
484
|
+
|
|
485
|
+
|
|
486
|
+
|
|
487
|
+
<li class=""><a href="https://jekyllrb.com/docs/pages/">Creating pages</a></li>
|
|
488
|
+
|
|
489
|
+
|
|
490
|
+
|
|
491
|
+
<li class=""><a href="https://jekyllrb.com/docs/static-files/">Static Files</a></li>
|
|
492
|
+
|
|
493
|
+
|
|
494
|
+
|
|
495
|
+
<li class=""><a href="https://jekyllrb.com/docs/variables/">Variables</a></li>
|
|
496
|
+
|
|
497
|
+
|
|
498
|
+
|
|
499
|
+
<li class=""><a href="https://jekyllrb.com/docs/collections/">Collections</a></li>
|
|
500
|
+
|
|
501
|
+
|
|
502
|
+
|
|
503
|
+
<li class=""><a href="https://jekyllrb.com/docs/datafiles/">Data Files</a></li>
|
|
504
|
+
|
|
505
|
+
|
|
506
|
+
|
|
507
|
+
<li class="current"><a href="https://jekyllrb.com/docs/assets/">Assets</a></li>
|
|
508
|
+
|
|
509
|
+
|
|
510
|
+
|
|
511
|
+
<li class=""><a href="https://jekyllrb.com/docs/migrations/">Blog migrations</a></li>
|
|
512
|
+
|
|
513
|
+
</ul>
|
|
514
|
+
|
|
515
|
+
|
|
516
|
+
<h4>Customization</h4>
|
|
517
|
+
<ul>
|
|
518
|
+
|
|
519
|
+
|
|
520
|
+
|
|
521
|
+
<li class=""><a href="https://jekyllrb.com/docs/templates/">Templates</a></li>
|
|
522
|
+
|
|
523
|
+
|
|
524
|
+
|
|
525
|
+
<li class=""><a href="https://jekyllrb.com/docs/permalinks/">Permalinks</a></li>
|
|
526
|
+
|
|
527
|
+
|
|
528
|
+
|
|
529
|
+
<li class=""><a href="https://jekyllrb.com/docs/pagination/">Pagination</a></li>
|
|
530
|
+
|
|
531
|
+
|
|
532
|
+
|
|
533
|
+
<li class=""><a href="https://jekyllrb.com/docs/plugins/">Plugins</a></li>
|
|
534
|
+
|
|
535
|
+
|
|
536
|
+
|
|
537
|
+
<li class=""><a href="https://jekyllrb.com/docs/themes/">Themes</a></li>
|
|
538
|
+
|
|
539
|
+
|
|
540
|
+
|
|
541
|
+
<li class=""><a href="https://jekyllrb.com/docs/extras/">Extras</a></li>
|
|
542
|
+
|
|
543
|
+
</ul>
|
|
544
|
+
|
|
545
|
+
|
|
546
|
+
<h4>Deployment</h4>
|
|
547
|
+
<ul>
|
|
548
|
+
|
|
549
|
+
|
|
550
|
+
|
|
551
|
+
<li class=""><a href="https://jekyllrb.com/docs/github-pages/">GitHub Pages</a></li>
|
|
552
|
+
|
|
553
|
+
|
|
554
|
+
|
|
555
|
+
<li class=""><a href="https://jekyllrb.com/docs/deployment-methods/">Deployment methods</a></li>
|
|
556
|
+
|
|
557
|
+
|
|
558
|
+
|
|
559
|
+
<li class=""><a href="https://jekyllrb.com/docs/continuous-integration/">Continuous Integration</a></li>
|
|
560
|
+
|
|
561
|
+
</ul>
|
|
562
|
+
|
|
563
|
+
|
|
564
|
+
<h4>Miscellaneous</h4>
|
|
565
|
+
<ul>
|
|
566
|
+
|
|
567
|
+
|
|
568
|
+
|
|
569
|
+
<li class=""><a href="https://jekyllrb.com/docs/troubleshooting/">Troubleshooting</a></li>
|
|
570
|
+
|
|
571
|
+
|
|
572
|
+
|
|
573
|
+
<li class=""><a href="https://jekyllrb.com/docs/sites/">Sites using Jekyll</a></li>
|
|
574
|
+
|
|
575
|
+
|
|
576
|
+
|
|
577
|
+
<li class=""><a href="https://jekyllrb.com/docs/resources/">Resources</a></li>
|
|
578
|
+
|
|
579
|
+
|
|
580
|
+
|
|
581
|
+
<li class=""><a href="https://jekyllrb.com/docs/upgrading/0-to-2/">Upgrading from 0.x to 2.x</a></li>
|
|
582
|
+
|
|
583
|
+
|
|
584
|
+
|
|
585
|
+
<li class=""><a href="https://jekyllrb.com/docs/upgrading/2-to-3/">Upgrading from 2.x to 3.x</a></li>
|
|
586
|
+
|
|
587
|
+
</ul>
|
|
588
|
+
|
|
589
|
+
|
|
590
|
+
<h4>Meta</h4>
|
|
591
|
+
<ul>
|
|
592
|
+
|
|
593
|
+
|
|
594
|
+
|
|
595
|
+
<li class=""><a href="https://jekyllrb.com/docs/contributing/">Contributing</a></li>
|
|
596
|
+
|
|
597
|
+
|
|
598
|
+
|
|
599
|
+
<li class=""><a href="https://jekyllrb.com/docs/conduct/">Code of Conduct</a></li>
|
|
600
|
+
|
|
601
|
+
|
|
602
|
+
|
|
603
|
+
<li class=""><a href="https://jekyllrb.com/docs/history/">History</a></li>
|
|
604
|
+
|
|
605
|
+
</ul>
|
|
606
|
+
|
|
607
|
+
|
|
608
|
+
</aside>
|
|
609
|
+
</div>
|
|
610
|
+
|
|
611
|
+
|
|
612
|
+
<div class="clear"></div>
|
|
613
|
+
|
|
614
|
+
</div>
|
|
615
|
+
</section>
|
|
616
|
+
|
|
617
|
+
|
|
618
|
+
<footer>
|
|
619
|
+
<div class="grid">
|
|
620
|
+
<div class="unit one-third center-on-mobiles">
|
|
621
|
+
<p>The contents of this website are <br>© 2016 under the terms of the <a href="https://github.com/jekyll/jekyll/blob/master/LICENSE">MIT License</a>.</p>
|
|
622
|
+
</div>
|
|
623
|
+
<div class="unit two-thirds align-right center-on-mobiles">
|
|
624
|
+
<p>
|
|
625
|
+
Proudly hosted by
|
|
626
|
+
<a href="https://github.com">
|
|
627
|
+
<img src="/img/footer-logo.png" width="100" height="30" alt="GitHub • Social coding">
|
|
628
|
+
</a>
|
|
629
|
+
</p>
|
|
630
|
+
</div>
|
|
631
|
+
</div>
|
|
632
|
+
</footer>
|
|
633
|
+
|
|
634
|
+
<script>
|
|
635
|
+
var anchorForId = function (id) {
|
|
636
|
+
var anchor = document.createElement("a");
|
|
637
|
+
anchor.className = "header-link";
|
|
638
|
+
anchor.href = "#" + id;
|
|
639
|
+
anchor.innerHTML = "<span class=\"sr-only\">Permalink</span><i class=\"fa fa-link\"></i>";
|
|
640
|
+
anchor.title = "Permalink";
|
|
641
|
+
return anchor;
|
|
642
|
+
};
|
|
643
|
+
|
|
644
|
+
var linkifyAnchors = function (level, containingElement) {
|
|
645
|
+
var headers = containingElement.getElementsByTagName("h" + level);
|
|
646
|
+
for (var h = 0; h < headers.length; h++) {
|
|
647
|
+
var header = headers[h];
|
|
648
|
+
|
|
649
|
+
if (typeof header.id !== "undefined" && header.id !== "") {
|
|
650
|
+
header.appendChild(anchorForId(header.id));
|
|
651
|
+
}
|
|
652
|
+
}
|
|
653
|
+
};
|
|
654
|
+
|
|
655
|
+
document.onreadystatechange = function () {
|
|
656
|
+
if (this.readyState === "complete") {
|
|
657
|
+
var contentBlock = document.getElementsByClassName("docs")[0] || document.getElementsByClassName("news")[0];
|
|
658
|
+
if (!contentBlock) {
|
|
659
|
+
return;
|
|
660
|
+
}
|
|
661
|
+
for (var level = 1; level <= 6; level++) {
|
|
662
|
+
linkifyAnchors(level, contentBlock);
|
|
663
|
+
}
|
|
664
|
+
}
|
|
665
|
+
};
|
|
666
|
+
</script>
|
|
667
|
+
|
|
668
|
+
|
|
669
|
+
<!-- Gauges (http://gaug.es/) -->
|
|
670
|
+
<script>
|
|
671
|
+
var _gauges = _gauges || [];
|
|
672
|
+
(function() {
|
|
673
|
+
var t = document.createElement('script');
|
|
674
|
+
t.type = 'text/javascript';
|
|
675
|
+
t.async = true;
|
|
676
|
+
t.id = 'gauges-tracker';
|
|
677
|
+
t.setAttribute('data-site-id', '503c5af6613f5d0f19000027');
|
|
678
|
+
t.src = '//secure.gaug.es/track.js';
|
|
679
|
+
var s = document.getElementsByTagName('script')[0];
|
|
680
|
+
s.parentNode.insertBefore(t, s);
|
|
681
|
+
})();
|
|
682
|
+
</script>
|
|
683
|
+
|
|
684
|
+
|
|
685
|
+
|
|
686
|
+
<!-- Google Analytics (http://google.com/analytics) -->
|
|
687
|
+
<script>
|
|
688
|
+
!function(j,e,k,y,l,L){j.GoogleAnalyticsObject=y,j[y]||(j[y]=function(){
|
|
689
|
+
(j[y].q=j[y].q||[]).push(arguments)}),j[y].l=+new Date,l=e.createElement(k),
|
|
690
|
+
L=e.getElementsByTagName(k)[0],l.src='//www.google-analytics.com/analytics.js',
|
|
691
|
+
L.parentNode.insertBefore(l,L)}(window,document,'script','ga');
|
|
692
|
+
|
|
693
|
+
ga('create', 'UA-50755011-1', 'jekyllrb.com');
|
|
694
|
+
ga('send', 'pageview');
|
|
695
|
+
|
|
696
|
+
</script>
|
|
697
|
+
|
|
698
|
+
|
|
699
|
+
|
|
700
|
+
</body>
|
|
701
|
+
</html>
|