Documentation page version switch

I’m building a documentation page for a project based on Hugo. To make it searchable I already got the idea to use Caddy including the search plugin in front of the site. But there is a different topic where I have no idea how to handle that.

I want to provide a select box to choose the version of the documentation since the docs are different for sure for different versions of the documented tool. Have somebody already done that?

One example should be http://readme.drone.io vs http://readme.drone.io/0.5 with the exception that the UI would look the same. And this is also missing a switch for the versions.

Like this but based on Hugo instead of readme.io and including a select to switch:

1 Like

Since I’m not allowed to add another link, this is just for reference of the search function within caddy webserver: https://caddyserver.com/docs/search

Did you implement the versioning functionality? I am writing a documentation site and trying to achieve the same.

No solution so far from my side.

FYI I think it can be done. I have found this example (Camunda docs)

But it is not clear how the site is doing it. Any ideas?

Let me dig this graveyard, because I have the same feature requirement.

From the way Camunda theme and configs are written, they use a list of tags manually defined in the config file and it seems to rely on branches and deployment conventions.

Unfortunately, their theme is not as reusable as I wanted. I tried to use it for LibrePCB, but references to Camunda are everywhere and menus require following their conventions (plus a lot of overrides). Sounds easier to create a new one from scratch.

What are the changes needed in the bitbucket-pipeline.yml for getting the version control in my documentation website so that it renders the specific version based on tags of git. Are there any other other file changes too?