This will cause CI to build docs for specific branches when they are
pushed to, and to copy the result into a subdirectory of the docs/
directory, instead of the root. The task will also update a
"versions.json" file, for the pages to be able to display/select other
versions.
The doc template is changed slightly to display a select field on top
of the quick search, using some js to fill the versions from the
generated versions.json file, and to change url when a different version
is selected.
This has been tested with a local server, trying to emulate the doc
structure, but the CI part hasn't been really tested.
Known Issues:
- the version.json file contains all versions configured to build, but
the doc for these might not have been generated yet, which would
result in 404 errors.
- the logic doesn't know if the current page of the doc exists for the
selectable versions, so this will also result in 404 errors when
switching to a version that didn't have the current doc page..
- the url manipulation logic is a bit dirty, as it assumes that the path
is always of the form of /docs/<version>/….
- theming could certainly be slightly improved.
Concatenated jquery.effects.core.js jquery.effects.slide.js from jquery 1.8.18
to one file and changed the original reference in layout.html to the new
filename.