Replies: 1 comment 4 replies
-
We're aware that the options available in the MkDocs ecosystem are very opinionated and require specific setups, which is why we are working on better support for i18n and versioning – in our view similar problems. We're also aiming to support git and non-git workflows. In the meantime, there have been some discussions how you can achieve custom versioning. Integration mainly requires generating a |
Beta Was this translation helpful? Give feedback.
4 replies
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
-
Please tell me, is there any ready-made solution or approximate understanding of how can i implement versioning in doc?
I will describe my limitations right away:
nav
)navigation.tabs
are already occupied by documentation sectionsdocs
directory in my vision (optional if another option suitable for the rest of the requirements is found)I have looked at and tried different options, but have not found anything suitable yet:
mike
is the main option that your documentation offers. Looking through the issues I saw statements that mike is quite flexible, but I don't see it. Even if we accept all the limitations of working with mike tied to git - it still doesn't work offline.i18-static-plugin
- I wanted to change the design of the language selector and adapt the plugin for version selection, because it works offline and supports the directory structure I need. However, the plugin itself has locale validation, which prevents me from setting version IDs (0.1.0) instead of locales (en/fr) inmkdocs.yml
mkdocs-versioning
plugin is the second plugin that can be found for versioning. It works, but you need to callmkdocs build
multiple times and throw documentation of different versions intodocs
each time for each version. This can be automated. But this plugin also embeds the version selector inside the navigation, which does not look very clean and seems unintuitive to me. It also does not seem to work well withmkdocs serve
.navigation.tabs
), then the second level of the directory structure is transferred to the tabs, then sidebar and etc. Please tell me if it is possible to do this without forking your project and without understanding exactly how it works.Beta Was this translation helpful? Give feedback.
All reactions