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

Multiple versions of the docs #2

Open
lejsekt opened this issue Mar 19, 2021 · 2 comments
Open

Multiple versions of the docs #2

lejsekt opened this issue Mar 19, 2021 · 2 comments

Comments

@lejsekt
Copy link

lejsekt commented Mar 19, 2021

Hi,
first of all, thank you for a nice theme!

How would you go about creating a versioning menu switch? Like for example:
URI: https://docs.antora.org/antora/2.3/
UI - the 2.3 version in the upper right corner

@basil
Copy link
Owner

basil commented Mar 19, 2021

Multiple versions of the docs

Although the original Antora theme is a documentation theme, my variant is a Hugo theme. As such, there is not a 1-to-1 mapping of each concept from the original Antora theme to the Hugo theme. For example, the styling of blog post categories in the Hugo theme doesn't exist in the original Antora theme doesn because there is no concept of blog post categories in Antora.

I thought about how to map the "versions dropdown" concept from the Antora theme to the Hugo theme. Hugo doesn't have a concept of versioned pages as far as I know, so a direct mapping isn't possible.

One possibility would be to adapt the original "versions dropdown" concept to be a dropdown of available languages for a page, using Hugo's multilingual mode. I think the UI would look quite nice. However, I don't need multilingual mode for my own web site, so I haven't implemented that yet. A pull request to add multilingual support to this Hugo theme, using the UI of the "versions dropdown" from the original Antora theme, would be quite welcome!

@boydkelly
Copy link

Interesting.... I'd actually like to see multilingual support for well.... multilingual support!!! Thanks for the beautiful theme!!!

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

3 participants