diff --git a/docs/content/extras/urls.md b/docs/content/extras/urls.md index d9f545a49..20bf27d8b 100644 --- a/docs/content/extras/urls.md +++ b/docs/content/extras/urls.md @@ -32,20 +32,14 @@ Organization](/content/organization/) for more details. ## Canonicalization - By default, all relative URLs encountered in the input are left unmodified, -e.g. `/css/foo.css` would stay as `/css/foo.css`. +e.g. `/css/foo.css` would stay as `/css/foo.css`, +i.e. `canonifyurls` defaults to `false`. By setting `canonifyurls` to `true`, all relative URLs would instead be *canonicalized* using `baseurl`. For example, assuming you have `baseurl = http://yoursite.example.com/` defined in the site-wide -config.toml, the relative URL `/css/foo.css` would be turned into +`config.toml`, the relative URL `/css/foo.css` would be turned into the absolute URL `http://yoursite.example.com/css/foo.css`. Benefits of canonicalization include fixing all URLs to be absolute, which may @@ -56,46 +50,13 @@ Benefits of non-canonicalization include being able to have resource inclusion be scheme-relative, so that http vs https can be decided based on how this page was retrieved. -### Caveat: Default of `canonifyurls` changed in v0.11 +> Note: In the May 2014 release of Hugo v0.11, the default value of `canonifyurls` was switched from `true` to `false`, which we think is the better default and should continue to be the case going forward. So, please verify and adjust your website accordingly if you are upgrading from v0.10 or older versions. -
Hugo Version | -Release Date | -Default | -
---|---|---|
v0.9 | -2013-11-15 | -canonifyurls = true (non-configurable) |
-
v0.10 | -2014-03-01 | -canonifyurls = true |
-
v0.11 | -2014-05-29 | -canonifyurls = false |
-
v0.12 | -2014-09-01 | -canonifyurls = false |
-
v0.13-DEV | -in development | -canonifyurls = false (as of January 2015) |
-