Currently I keep documentation for old releases in separate folders. So that if docs.mysite.com hosts the latest release, then docs.mysite.com/2021 and docs.mysite.com/2020 host two old releases. This structure is convenient for some readers, but not for others.
Is there a "change version" feature in MadCap Flare? I'm looking to set up a dropdown similar to the one found on Python's documentation. Here's the example: The Python Tutorial. You can switch versions from the dropdown in the header.
Change version dropdown on each topic
-
chetangrazitti
- Jr. Propeller Head
- Posts: 2
- Joined: Tue Jul 16, 2019 9:20 pm
-
robdocsmith
- Sr. Propeller Head
- Posts: 271
- Joined: Thu May 24, 2018 3:11 pm
- Location: Queensland, Australia
Re: Change version dropdown on each topic
I don't think there's a native solution in Flare.
However, that's a neat little Javascript on the Python site. If you look at the source for the page you can see a reference at the bottom of the source to the script https://docs.python.org/3.10/_static/switchers.js. I'd be borrowing the idea and modifying the code to suit my needs.
On change of the drop down it loads the new index.html page from the selected version folder and if an older version selected, posts a notice to a placeholder that they should consider upgrading. I should think it would be possible to put a script like that into the header for your help system. You'd need to retrospectively add the script to your older help systems if you wanted users to be able to switch back to the current version.
Rob
However, that's a neat little Javascript on the Python site. If you look at the source for the page you can see a reference at the bottom of the source to the script https://docs.python.org/3.10/_static/switchers.js. I'd be borrowing the idea and modifying the code to suit my needs.
On change of the drop down it loads the new index.html page from the selected version folder and if an older version selected, posts a notice to a placeholder that they should consider upgrading. I should think it would be possible to put a script like that into the header for your help system. You'd need to retrospectively add the script to your older help systems if you wanted users to be able to switch back to the current version.
Rob