search

basil / antora-default-ui-hugo-theme

A Hugo theme based on the Antora default UI, with full support for Asciidoctor
https://antora-default-ui-hugo-theme.netlify.app
Mozilla Public License 2.0
11 stars 5 forks source link

Multiple versions of the docs #2

Open lejsekt opened 3 years ago

lejsekt commented 3 years ago

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 commented 3 years ago

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 commented 3 years ago

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