Add Jekyll 3.3 release post
This commit is contained in:
		
							parent
							
								
									274d350d61
								
							
						
					
					
						commit
						761ddcae24
					
				| 
						 | 
					@ -0,0 +1,90 @@
 | 
				
			||||||
 | 
					---
 | 
				
			||||||
 | 
					layout: news_item
 | 
				
			||||||
 | 
					title: 'Jekyll 3.3 is here with better theme support, new URL filters, and tons more'
 | 
				
			||||||
 | 
					date: 2016-10-03 17:08:38 -0700
 | 
				
			||||||
 | 
					author: parkr
 | 
				
			||||||
 | 
					version: 3.3.0
 | 
				
			||||||
 | 
					categories: [release]
 | 
				
			||||||
 | 
					---
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					We have tons of new features for you in our latest release of Jekyll. Three
 | 
				
			||||||
 | 
					key things you might want to give a whirl:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### 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
 | 
				
			||||||
 | 
					to use a theme that was packaged as a gem. Due to security necessities and
 | 
				
			||||||
 | 
					ease-of-use concerns, this initial ship only included support for includes,
 | 
				
			||||||
 | 
					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
 | 
				
			||||||
 | 
					`/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
 | 
				
			||||||
 | 
					webfonts, JSON and other data. Same rules apply here as in a Jekyll site:
 | 
				
			||||||
 | 
					if it has YAML front matter, it will be converted and renderd. No YAML
 | 
				
			||||||
 | 
					front matter, and it will simply be copied over like a static asset. Neat,
 | 
				
			||||||
 | 
					huh?
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					See our [documentation on the subject](/docs/assets#assets-directory) for
 | 
				
			||||||
 | 
					more info.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### 2. `relative_url` and `absolute_url` filters
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Want a clean way to prepend the `baseurl` or `url` in your config? These
 | 
				
			||||||
 | 
					new filters have you covered. When working locally, if you set your
 | 
				
			||||||
 | 
					`baseurl` to match your deployment environment, say `baseurl: "/myproject"`,
 | 
				
			||||||
 | 
					then `relative_url` will ensure that this baseurl is prepended to anything
 | 
				
			||||||
 | 
					you pass it:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					{% highlight liquid %}
 | 
				
			||||||
 | 
					{% raw %}
 | 
				
			||||||
 | 
					{{ "/docs/assets/" | relative_url }} => /myproject/docs/assets
 | 
				
			||||||
 | 
					{% endraw %}
 | 
				
			||||||
 | 
					{% endhighlight %}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					A result of `relative_url` will safely always yield a link which is
 | 
				
			||||||
 | 
					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
 | 
				
			||||||
 | 
					easier to make:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					{% highlight liquid %}
 | 
				
			||||||
 | 
					{% raw %}
 | 
				
			||||||
 | 
					{{ "/docs/assets/" | absolute_url }} => http://jekyllrb.com/myproject/docs/assets
 | 
				
			||||||
 | 
					{% endraw %}
 | 
				
			||||||
 | 
					{% endhighlight %}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### 3. `site.url` is set by the development server
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					When you run `jekyll serve` locally, it starts a web server, usually at
 | 
				
			||||||
 | 
					`http://localhost:4000`, that you use to preview your site during
 | 
				
			||||||
 | 
					development. If you are using the new `absolute_url` filter, or using
 | 
				
			||||||
 | 
					`site.url` anywhere, you have probably had to create a development config
 | 
				
			||||||
 | 
					which resets the `url` value to point to `http://localhost:4000`.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					No longer! When you run `jekyll serve`, Jekyll will build your site with
 | 
				
			||||||
 | 
					the value of the `host`, `port`, and SSL-related options. This defaults to
 | 
				
			||||||
 | 
					`url: http://localhost:4000`. When you are developing locally, `site.url`
 | 
				
			||||||
 | 
					will yield `http://localhost:4000`.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Note that this only applies when `JEKYLL_ENV` is equal to `development`. If
 | 
				
			||||||
 | 
					you set `JEKYLL_ENV=production` and run `jekyll serve`, it will not
 | 
				
			||||||
 | 
					overwrite the value of `url` in your config. And again, this only applies
 | 
				
			||||||
 | 
					to serving, not to building.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					## A *lot* more!
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					There are dozens of bug fixes and minor improvements to make your Jekyll
 | 
				
			||||||
 | 
					experience better than ever. With every Jekyll release, we strive to bring
 | 
				
			||||||
 | 
					greater stability and reliability to your everyday development workflow.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					As always, thanks to our many contributors who contributed countless hours
 | 
				
			||||||
 | 
					of their free time to making this release happen:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					!! TODO: Add list of contributors for this release!
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					[Full release notes]({{ "/docs/history/" | relative_url }}) are available
 | 
				
			||||||
 | 
					for your perusal. If you notice any issues, please don't hesitate to file a
 | 
				
			||||||
 | 
					bug report.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Happy Jekylling!
 | 
				
			||||||
		Loading…
	
		Reference in New Issue