dan
/
jekyll
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Updates to 3.3.0 release post per comments.

This commit is contained in:
Parker Moore 2016-10-06 09:36:56 -07:00
parent a138b02b10
commit c90d44d2be
No known key found for this signature in database
GPG Key ID: 193CDEBA72063C58
1 changed files with 26 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
site/_posts/2016-10-03-jekyll-3-3-0-released.markdown
View File

@ -7,24 +7,26 @@ version: 3.3.0
categories: [release] categories: [release]
--- ---
We have tons of new features for you in our latest release of Jekyll. Three There are tons of great new quality-of-life features you can use in 3.3.
key things you might want to give a whirl: Three key things you might want to try:
### 1. Themes can now ship static & dynamic assets in an `/assets` directory ### 1. Themes can now ship static & dynamic assets in an `/assets` directory
We're really stoked about this one. In Jekyll 3.2, we shipped the ability In Jekyll 3.2, we shipped the ability to use a theme that was packaged as a
to use a theme that was packaged as a gem. Due to security necessities and [gem](http://guides.rubygems.org/). 3.2 included support for includes,
ease-of-use concerns, this initial ship only included support for includes, layouts, and sass partials. In 3.3, we're adding assets to that list.
layouts, and sass partials. A theme couldn't write any CSS, JavaScript, or
content to your site.
In an effort to make theme management a bit easier, any files you put into In an effort to make theme management a bit easier, any files you put into
`/assets` in your theme will be read in as though they were part of the `/assets` in your theme will be read in as though they were part of the
user's site. This means you can ship SCSS and CoffeeScript, images and user's site. This means you can ship SCSS and CoffeeScript, images and
webfonts, JSON and other data. Same rules apply here as in a Jekyll site: webfonts, and so on -- anything you'd consider a part of the
if it has YAML front matter, it will be converted and renderd. No YAML *presentation*. Same rules apply here as in a Jekyll site: if it has YAML
front matter, and it will simply be copied over like a static asset. Neat, front matter, it will be converted and rendered. No YAML front matter, and
huh? it will simply be copied over like a static asset.
Note that if a user has a file of the same path, the theme content will not
be included in the site, i.e. a user's `/assets/main.scss` will be written
instead of a theme's `/assets/main.scss`. It's
See our [documentation on the subject]({{ "/docs/themes/#assets" | relative_url }}) See our [documentation on the subject]({{ "/docs/themes/#assets" | relative_url }})
for more info. for more info.
@ -43,7 +45,16 @@ you pass it:
{% endraw %} {% endraw %}
{% endhighlight %} {% endhighlight %}
A result of `relative_url` will safely always yield a link which is By default, `baseurl` is set to `""` and therefore yields (never set to
`"/"`):
{% highlight liquid %}
{% raw %}
{{ "/docs/assets/" | relative_url }} => /docs/assets
{% endraw %}
{% endhighlight %}
A result of `relative_url` will safely always produce a URL which is
relative to the domain root. A similar principle applies to `absolute_url`. relative to the domain root. A similar principle applies to `absolute_url`.
It prepends your `baseurl` and `url` values, making absolute URL's all the It prepends your `baseurl` and `url` values, making absolute URL's all the
easier to make: easier to make:
@ -67,8 +78,9 @@ the value of the `host`, `port`, and SSL-related options. This defaults to
`url: http://localhost:4000`. When you are developing locally, `site.url` `url: http://localhost:4000`. When you are developing locally, `site.url`
will yield `http://localhost:4000`. will yield `http://localhost:4000`.
Note that this only applies when `JEKYLL_ENV` is equal to `development`. If This happens by default when running Jekyll locally. It will not be set if
you set `JEKYLL_ENV=production` and run `jekyll serve`, it will not you set `JEKYLL_ENV=production` and run `jekyll serve`. If `JEKYLL_ENV` is
any value except `development` (its default value), Jekyll will not
overwrite the value of `url` in your config. And again, this only applies overwrite the value of `url` in your config. And again, this only applies
to serving, not to building. to serving, not to building.