I use MkDocs but wish the navigation were more compact like ReadTheDocs.
In this post I’ll recount the steps I followed to create the ReadTheDocs Dropdown theme.
tldr Goal: Provide collapsable menu support in a MkDocs theme.
Results: mkdocs-rtd-dropdown
Preparing the Theme Using their theming guide, I set up a theme repository with the ReadTheDocs theme from the mkdocs repo. At this point, the theme is just a copy of the existing ReadTheDocs theme.
As a security precaution (and because my workflow allows), I use IP filtering on my server firewalls. Not having a dedicated IP address at home means I need a way to keep my IP addresses in-sync with my servers.
My workstations are persistently connected to AirVPN which has a poll-able API providing the needed exit IP address.
Aside: If you need a featureful VPN, I recommend AirVPN. They’re an Italian based operation offering the most bang-for-the-buck service of any I’ve used.
LinConf is a blanket organization on GitHub where I intend to publish Ansible roles, tests and modules which adhere to the following important design principles:
Dependency free Structural consistency High extensibility High modularity Dependencies Roles stored in the LinConf organization should be as free as possible from inter-role dependencies. The Ansible version is all that should be required.
Roles will deliberately not coordinate tasks between themselves. As such, variables and plays will tell the environments entire story without knowledge of each roles inner-workings.
