Site generator for alternative docs pages for the DragonRuby Game Toolkit API.
It's a single babashka script, which uses bootleg's support for enlive to parse out then re-render the required content.
You can install the dependencies in a local temp directory and run the script in one step by running build.sh
. It will throw an error if the top level structure of the source page has changed - bb list-sections
can be used to obtain the current list and the script needs to be updated manually to match.
The source content is obtained from the DragonRuby documentation.
The output includes only what I consider to be the "core API docs", excluding the rationale, FAQs, getting started, deploying/publishing guides and code samples, making it easier to use a browser's search feature to find the relevant section. It splits out the TOC into a separate page - the reason for this is to make browsing the docs on a phone easier (swipe back to return to TOC). It also adds sticky headers which makes it easier to keep track of the current context.