使用 mkdocs-static-i18n 更改 GitHub 页面主页上的翻译会导致 404

问题描述 投票:0回答:1

所以我使用 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。我认为这就是问题所在。

internationalization github-pages mkdocs mkdocs-material
1个回答
0
投票

显然问题与配置的

alternate
部分有关。如果这对任何人都有帮助,我做了以下更改以使其发挥作用:

extra:
  alternate:
    # Switch to English
    - name: English
      link: ""
      lang: en

    # Switch to French
    - name: Français
      link: fr
      lang: fr
© www.soinside.com 2019 - 2024. All rights reserved.