Hosting environments that add a trailing back slash break page links

[littlespex]

🐛 Bug Report

Hosting setups that add a trailing back slash to urls break all inter-site links on the page.

Have you read the Contributing Guidelines on issues?

Yes

To Reproduce

1. Create a new site using npx @docusaurus/init@next init test-site classic
2. Create two new sub folders in docs called a and b
3. Add attached file a.md to a folder, and b.md to b folder.
   • a.md.zip
   • b.md.zip
4. Replace sidebar.js with attached version.
   • sidebars.js.zip
5. run npm run build to generate the flat site.
6. Load the site in any browser by navigating directly to the url of page a: http://127.0.0.1:8080/docs/a/a
7. Click the link Link to page "b"

Expected behavior

Page b should load.

Actual Behavior

Page Not Found page.

Your Environment

• Docusaurus version used: 2.0.0-alpha.48
• Environment name and version (e.g. Chrome 78.0.3904.108, Node.js 10.17.0): Safari 13.0.5 (15608.5.11), Chrome 80.0.3987.132, Firefox 73.0.1
• Operating system and version (desktop or mobile): macOS 10.15.3 (19D76)

Reproducible Demo

(Paste the link to an example repo, including a siteConfig.js, and exact instructions to reproduce the issue.)

http://littlespex.com/docusaurus/docs/a/a

test-site.zip

[bravo-kernel]

@littlespex are you sure the browser is adding that slash? Try running your site locally and see if the slash gets added. If not, it most likely is your hosting server.

FYI I am seeing the same behavior on Netlify (adding the slash, breaking the links)

[bravo-kernel]

💡 If you are using Netlify, disabling Pretty URLs should solve the problem. I unchecked the first two boxes to prevent Netlify from both lowercasing the urls and.. adding the trailing slash.

[littlespex]

I had updated the ticket description earlier to mention the hosting environment instead of the browser. Unfortunately we don’t have admin control over our docs environment and the team that runs it has enabled these url rewrite rules for other reasons. Our current workaround is to revert to docusaurus v1 which works as expected.

[davidhagg]

We are having this issue too running on an Azure Webservice.

[dotansimha]

Same here, with GH Pages.

[dotansimha]

My current way to workaround that:

1. Create a file called static/js/fix-location.js with:

if (window && window.location && window.location.pathname.endsWith('/') && window.location.pathname !== '/') {
  window.history.replaceState('', '', window.location.pathname.substr(0, window.location.pathname.length - 1))
}

2. Load this file as static JS file in docusaurus.config.js:

  scripts: [
    {
      src: '/js/fix-location.js',
      async: false,
      defer: false,
    },