Docusaurus in a subdirectory of existing site

[schlameel]

I want my Docusaurus pages to be in /docs of an existing site, but I cannot link from inside Docusaurus to pages outside of Docusaurus.

/contact is a valid page. If I enter https://mysite/contact in the browser I get the page outside of Docusaurus.

A link in a Docusaurus page to /contact will cause a 404.

How can I tell Docusaurus to allow links outside of itself?

[slorber]

By default, Docusaurus uses soft navigation (not reloading the HTML page) to navigate to other pages it created. If you want to link to a page Docusaurus did not create, you shouldn't use soft navigation, because Docusaurus can't render this page client-side, and will display a 404 instead.

You can link to pages outside of Docusaurus by forcing a hard navigation through various ways:

• using the full qualified name of the page (including protocol/domain)
• using target="_blank" prop on the link/config to open in a new browser tab
• using pathname:///contact, this is our escape hatch to out-out of the regular soft navigation using a special URL protocol. It works with <Link> but also theme config and Markdown [link](pathname:///contact)) syntax