You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I would like have CI/CD of the documentation of my projects in a private static website and I am looking for a way to navigate between the different versions of the projects. Something close to what readthedocs provides.
My first guess was to have the documentation built for each version in different subfolders and edit the mako templates to show this kind of dropdown bar with the list of available version.
Is there a more straightfoward /already available/recommended way to achieve this?
The text was updated successfully, but these errors were encountered:
Thanks! Nothing so far. Your approach seems reasonable. Checking out tagged releases and generating output in versioned subfolders, all the while injecting a common header switcher template seems doable rather easily in a few straightforward lines of POSIX shell.
You're strongly encouraged to share your recipe afterwards! 😃
Currently we automatically generate a unique static documentation page (using pdoc3) for each branch. It is not a perfect solution but it does the job and easy to set up. I cannot share an example project as they are all private ones but I can give guidance if this approach would suit your needs.
kernc
changed the title
Multiple versions of a project
Document multiple versions of a project
Jun 25, 2020
Hi,
First of all: thanks for the great work!
I would like have CI/CD of the documentation of my projects in a private static website and I am looking for a way to navigate between the different versions of the projects. Something close to what readthedocs provides.
My first guess was to have the documentation built for each version in different subfolders and edit the mako templates to show this kind of dropdown bar with the list of available version.
Is there a more straightfoward /already available/recommended way to achieve this?
The text was updated successfully, but these errors were encountered: