Publish Multiple Versions of Content
If you have documentation for multiple versions of a product, you can provide a dropdown menu for the users to switch between the versions. The feature will load the same page in another version, if it exists, otherwise redirecting to the home page of another version. Also, each version can have translations that the user can switch between in the HTML5 Help Center output.
To get a dropdown menu in your HTML5 Help Center output, each version must be published and their URL:s must be added to the used HTML5 layout.
 |
Tip
Moogsoft is a wonderful example of how the version switcher can be used.
Note
Step 9 to 14 in the following instruction are required for the dropdown menu to swap between the exact pages. You can choose not to use them, but then the version swap will direct the user to the main page instead.
To use the version dropdown menu, you need to organize your output topics in a specific folder structure:
-
Create a separate folder for each version on your server.
Note
It does not matter what the root folder is called. But it needs to point to the folder where your documents are stored. The slash ("/") at the beginning of the path represents the root of your server.
Then add subfolders for each version.
-
Publish each version and place them in the dedicated folder structure.
-
Select Layout in the top menu.
Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.
-
Select the Layout you want to update or Create a Layout.
Tip
You can copy the URL of the Layout Editor and paste it into a new tab in your browser. This can be useful if you frequently switch between your Paligo content and the Layout settings.
-
Select Help Center Theme Options in the sidebar.
-
Scroll down to Versions for version dropdown.
-
Enter a text and URL for each version like this
text:Version 5.1 (latest), url:/docs/index.html;. -
Select General in the sidebar.
-
Scroll down to Use a short and flat URL structure for output files.
-
Select Disable.
-
Scroll down to Use output file names made from id and SEO name.
-
Select Disable.
-
Scroll down to Ajax load content.
-
Select Disable.
-
Select Save.