A theme for rendering manuals using mkdocs
Project description
Theme for creating team manuals
This theme is based on top of mkdocs-basic-theme.
https://github.com/mkdocs/mkdocs-basic-theme
Usage
Install the theme
pip install mkdocs-manuals-theme
Use the theme in mkdocs.yml
theme:
name: mkdocs-manuals-theme
Development
Setting up dev environment:
# create and activate virtual env
python3 -m venv .venv
source .venv/bin/activate
# install requirements
pip install '.[dev]'
Summary of understanding
The documentation around templating is pretty good. It is all on one page :) https://www.mkdocs.org/dev-guide/themes/#navigation-objects
There are 2 global variables on each page:
nav
and toc
Nav is an iterable of 3 kinds of page: section
, page
and link
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mkdocs-manuals-theme-0.4.0.tar.gz
(14.2 kB
view hashes)
Built Distribution
Close
Hashes for mkdocs-manuals-theme-0.4.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 40276fa3ba9ca9ad396eb6a5c63c1354f72c83c5e15abab87acacc3a0838d6c9 |
|
MD5 | 1036f61c54a3e1bb15d65a3c1d2d2553 |
|
BLAKE2b-256 | 6143c85975dd0de2fdddbd7232e84606e840585447311f31210f3454cfb90600 |
Close
Hashes for mkdocs_manuals_theme-0.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a5d270aff8d0c3524aac2d5131e2fe9e03bb19d2e8aa7fd2d2465144534f1be7 |
|
MD5 | 95f66e305a7fae21fb8dedc2399725b3 |
|
BLAKE2b-256 | f0e28b316a481de3c7f48b42dcf1485a19729eced170c74eb8f87ca152943609 |