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

upgrade notes: mention trailing slash in permalink; fixes #4440

This commit is contained in:
Dean Attali 2016-02-02 16:16:12 -08:00
parent 7886fdb166
commit 75b55ff4f2
1 changed files with 5 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
site/_docs/upgrading/2-to-3.md
View File

@ -99,4 +99,9 @@ This can be fixed by removing the following line from your `_config.yml` file:
relative_permalinks: true
{% endhighlight %}
### Permalinks no longer automatically add a trailing slash
In Jekyll 2, any URL constructed from the `permalink:` field had a trailing slash (`/`) added to it automatically. Jekyll 3 no longer adds a trailing slash automatically to `permalink:` URLs. This can potentially result in old links to pages returning a 404 error. For example, suppose a page previously contained the YAML `permalink: /:year-:month-:day-:title` that resulted in the URL `example.com/2016-02-01-test/` (notice the trailing slash). In Jekyll 3, the URL for the same page is `example.com/2016-02-01-test`, and consequently any links to the old URL will result in a 404 error. In order to maintain the same URLs and avoid this problem, a trailing slash should be added to the `permalink:` field, for example `permalink: /:year-:month-:day-:title/`.
_Did we miss something? Please click "Improve this page" above and add a section. Thanks!_