mirror of
https://github.com/facebook/docusaurus.git
synced 2025-04-29 18:27:56 +02:00
docs(v2): localize 404 page with Netlify + docs (#4178)
This commit is contained in:
parent
6af8fbb0d2
commit
e3ae349889
2 changed files with 23 additions and 0 deletions
|
@ -262,6 +262,16 @@ The Docusaurus v2 website use this strategy:
|
|||
|
||||
:::
|
||||
|
||||
:::tip
|
||||
|
||||
Static hosting providers generally redirect `/unknown/urls` to `/404.html` by convention, always showing an **English 404 page**.
|
||||
|
||||
**Localize your 404 pages** by configuring your host to redirect `/fr/*` to `/fr/404.html`.
|
||||
|
||||
This is not always possible, and depends on your host: GitHub Pages can't do this, [Netlify](https://docs.netlify.com/routing/redirects/redirect-options/#custom-404-page-handling) can.
|
||||
|
||||
:::
|
||||
|
||||
### Multi-domain deployment
|
||||
|
||||
You can also build your site for a single locale:
|
||||
|
@ -283,3 +293,12 @@ On your [static hosting provider](../deployment.mdx):
|
|||
This strategy is **not possible** with Github Pages, as it is only possible to **have a single deployment**.
|
||||
|
||||
:::
|
||||
|
||||
### Hybrid
|
||||
|
||||
It is possible to have some locales using sub-paths, and others using subdomains.
|
||||
|
||||
It is also possible to deploy each locale as a separate subdomain, assemble the subdomains in a single unified domain at the CDN level:
|
||||
|
||||
- Deploy your site as `fr.docusaurus.io`
|
||||
- Configure a CDN to serve it from `docusaurus.io/fr`
|
||||
|
|
|
@ -5,4 +5,8 @@
|
|||
/classic/blog/2020/01/19/docusaurus-2020-recap /classic/blog/2021/01/19/docusaurus-2020-recap
|
||||
|
||||
|
||||
# Redirect each country sub-path to appropriate localized 404 file
|
||||
# See https://docs.netlify.com/routing/redirects/redirect-options/#custom-404-page-handling
|
||||
/fr/* /fr/404.html 404
|
||||
|
||||
|
||||
|
|
Loading…
Add table
Reference in a new issue