facebook / docusaurus

Easy to maintain open source documentation websites.
https://docusaurus.io
MIT License
54.16k stars 8.12k forks source link

Trailing Slash Appended to Asset Files in Docusaurus 3.3.2 #10139

Closed karl-cardenas-coding closed 1 month ago

karl-cardenas-coding commented 1 month ago

Have you read the Contributing Guidelines on issues?

Prerequisites

Description

We are attempting to upgrade to Docusarus 3.3.2, and we are noticing an interesting behavior with trailing slashes on asset files. We have by default the following baseURL and trailingSlash configuration

  baseUrl: "/",
  trailingSlash: true,

After the upgrade, if we do a docusarus serve we get a broken page that are missing assets. Upon closer inspection we noticed that asset files are specified with a / at the end. For example runtime-main.d2091a86.js/

image

It's strange that not all files have this behavior.

If we change the trailingSlash configuration to false then this issue goes away.

Reproducible demo

We have a PR in our public repo that can be used to test https://github.com/spectrocloud/librarium/pull/2839.

Just make sure you set the following env values before starting any server or build

ALGOLIA_APP_ID=1234567890
ALGOLIA_SEARCH_KEY=1234567890

Steps to reproduce

Upgrade to Docusarus 3.3.2 and set the configuration file to have the following baseURL and trailingSlash configuration

  baseUrl: "/",
  trailingSlash: true,

Expected behavior

We would expect asset files to not have an extra / at the end.

Actual behavior

Pages are loading with missing assets.

Your environment

Self-service

slorber commented 1 month ago

😅 sorry for that, likely a regression introduced by https://github.com/facebook/docusaurus/pull/10090

I forgot serve might not just serve HTML files 😓

karl-cardenas-coding commented 1 month ago

All good @slorber and thank you for validating what we seemed was a bit odd 😄