* Share redoc JavaScript between API versions
The redoc JavaScript is a big file, and there's no need
to keep a separate copy for each version of the API.
This patch removes the copy per-version and moves the script
to a central location.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* Use central stylesheet for API reference
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* Update ReDoc to v1.19.3
Changelog can be found at https://github.com/Rebilly/ReDoc/blob/v1.19.3/CHANGELOG.md
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* Hide "request type" badges in menu
ReDoc 1.13 added "request type" badges in the menu
given that we didn't show these before, this patch
hides them.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* Add .map file for ReDoc
Having a .map file allows debugging script issues
in the ReDoc JavaScript (which is minified).
It's a big file, but may be useful to have.
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
* rough pass at tabs, jsonification
* GHPages 147, authoring YML, sitemap via plugin, working JS
* Update Gemfile
* Removing dk.rb artifact
* Simplifying authoring YML even more
* More YML simplification
* Remove jekyll-seo -- even more perf gain
* Glossary support
* Collections support
* Incremental off; GH Pages 172 gets build time to 50 seconds
* Simplify both left and right sidebars
- Rewrite the sidebars to use the same CSS class instead of having two
very similar classes. This involves removing all affix related
attributes and functionality from the sidebars and replaced them with
`position: sticky`.
- The table of content elements should not be floated
- Removed unused CSS rules related to the sidebars
- Remove JavaScript used to resize the sidebars
* Improve the mobile menu to be fixed
- Simply JS used to hide/display the navigation bar on mobile viewports
- The mobile menu should be fixed so it can be viewable from the bottom
of the page. Before this change, you would have to scroll up to see
the menu that `position: absolute`
* Fix disappearing top navbar on homepage
- Change the calculation of the affix offset for the navbar on the home
page to ensure the navbar never leaves the viewport. This change also
takes into account the change of how the sidebars' offsets are used
* Fix auto scrolling on overflow
* Add polyfill for 'position: sticky' on IE
* Fix hamburger menu at incorrect breakpoint
* Fix left nav hidden after expanding from mobile
If you expand and collapse the left nav while on mobile and expand to a
desktop view, the left nav would be hidden; this has been fixed
* Unify navbar on homepage with rest of website
- Renamed docker-compose.yaml to archives.yaml since we are not using it
as a docker-compose.yaml anymore
- Added current docs into that archive list, added a key that can
be set to to indicate that the archive is the latest
- Output a new file that can be used by non-current
archives to build up a list of all archives including what's current,
dynamically
- Single-sourced and liquefied the list that builds up the archives in
the latest version
