facebook / facebook/docusaurus

RFC: Support i18n locale-specific content ?

未关闭
#11,076 1 条评论 3 个 reaction 已指派 0 人 在 GitHub 查看
feature
主要语言
TypeScript
星标
66.2k
派生
10k
平均合并
1 天 3 小时
30 天内合并 PR
52

描述

### Description

Many users requested the ability to create i18n locale-specific content.

By that, I mean localized sites are mostly the same and share many pages, apart from a few exceptions like
- `/en/docs/english-only-doc`: this page only exists for the `en` locale
- `/fr/docs/french-only-doc`: this page only exists for the `fr` locale

One problem is that Docusaurus assumes that all localized sites have the same structure as the default locale. Things such as the language fallback and the i18n SEO (hreflang meta headers) and UX (ability to switch locale while staying on the same page) rely on this assumption.

---

In this RFC, I'd like to open the discussion with the community to see what can be done to make your life easier without breaking that assumption that would break features that other users like.

Recent issues discussing this topic:
- https://github.com/facebook/docusaurus/discussions/11074
- https://github.com/facebook/docusaurus/issues/11001

### API design

One possibility could be to create an API that enables users to provide front matter such as pages that do not exist in a given locale are still created but automatically redirected to another page.

This is a behavior implemented here: https://github.com/facebook/docusaurus/issues/11001#issuecomment-2745377291

The page `/fr/docs/english-only-docs` could automatically redirect to the root `/fr/` for example, or any other URL provided by the user.

贡献指南

打开贡献指南

评估

这个 Issue 还没有评估数据。

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。