From 75b55ff4f26ee04f9b664ba354804d6b40685e6b Mon Sep 17 00:00:00 2001 From: Dean Attali Date: Tue, 2 Feb 2016 16:16:12 -0800 Subject: [PATCH] upgrade notes: mention trailing slash in permalink; fixes #4440 --- site/_docs/upgrading/2-to-3.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/site/_docs/upgrading/2-to-3.md b/site/_docs/upgrading/2-to-3.md index d3ff4a38..dbbda9a9 100644 --- a/site/_docs/upgrading/2-to-3.md +++ b/site/_docs/upgrading/2-to-3.md @@ -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!_