Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Unclear how to work with mkdocs-static-i18n and mike versioning at the same time #265

Closed
jodygarnett opened this issue Sep 27, 2023 · 2 comments

Comments

@jodygarnett
Copy link

jodygarnett commented Sep 27, 2023

Really enjoying this project, running into a difficulty combing mike publishing and mkdocs-static-i18n language control.

I am sure I just do not understand the interaction between these two plugins.

From the "home" page the language chooser is ending up directing to 404 page:

  1. From here https://jodygarnett.github.io/core-geonetwork/4.2.5/ selecting fr 404: https://jodygarnett.github.io/fr/

  2. From https://jodygarnett.github.io/core-geonetwork/4.2.5/fr/ selecting en 200 (but empty): https://jodygarnett.github.io

  3. From https://jodygarnett.github.io/core-geonetwork/4.2.5/devel/docs/markdown/ selecting fr 200: https://jodygarnett.github.io/core-geonetwork/4.2.5/fr/devel/docs/markdown/

My mkdocs.yaml configuration is I hope normal:

plugins:
  - i18n:
      docs_structure: suffix
      reconfigure_material: true
      languages:
        - locale: en
          default: true
          name: English
          build: true
        - locale: fr
          name: Français
          build: !ENV [FRENCH,true]
          site_name: 'Online Help (FR)'

And am deploying to mike using (there is no special mike configuration set):

mike deploy --push --update-aliases 4.2.5 latest 
@jodygarnett
Copy link
Author

Indeed I run into similar issues testing mike serve locally.

@jodygarnett
Copy link
Author

Oh dear, if I read the manual site_url is required, which addresses this problem.

Thanks 🤣

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant