所以我使用 GitHub Pages 和 mkdocs 构建了一个网站。我正在使用 mkdocs-static-i18n 部署翻译(法语)。一切都运行良好除了主页上的(从index.md构建的)。如果我尝试更改该页面上的语言,则会收到 404 错误消息。知道问题可能是什么吗?我正在使用 static-i18n 的文件夹版本。这是相关代码,网站名称被遮盖了:
- i18n:
docs_structure: folder
default_language: en
languages:
- locale: en
default: true
name: English
build: true
site_name: My website
site_description: My description
- locale: fr
name: Français
build: true
site_name: French name
site_description: French description
nav_translations:
My stuff
extra:
alternate:
# Switch to English
- name: English
link: /en/
lang: en
# Switch to French
- name: Français
link: /fr/
lang: fr
我尝试将 index.md 的名称更改为 homepage 以避免此问题,但我遇到了同样的问题,并且基本链接无法正确重定向到我的主页。
编辑:我注意到点击翻译会缩短我的网址。例如,如果主页是something.github.io/some-page,它会变成something.github.io/fr,而不是something.github.io/some-page/fr。我认为这就是问题所在。
显然问题与配置的
alternate
部分有关。如果这对任何人都有帮助,我做了以下更改以使其发挥作用:
extra:
alternate:
# Switch to English
- name: English
link: ""
lang: en
# Switch to French
- name: Français
link: fr
lang: fr