Skip to content

Outstanding mkdocs theme with a focus on navigation, customization and usability

License

Notifications You must be signed in to change notification settings

electrocreative/mkdocs-custommill

 
 

Repository files navigation

PyPI

CustomMill theme for MkDocs

Another iteration on the awesome Windmill theme for MkDocs. This is permitted by the MIT License.

Highlights:

  • Convenient navigation for larger documentation projects.
  • Retains state of the navigation menu across page transitions.
  • Deep nesting of documentation folders
  • Search with term highlighting.
  • User may search in a quick dropdown or load results in a full page.
  • Default mkdocs theme within pages, including syntax highlighting.
  • Custom coloring through sass

Quick start

To install using pip:

pip install mkdocs-custommill

To use in mkdocs.yml:

theme: custommill

Demo and documentation

See here for a demo and some documentation :)

Development

If doing development on mkdocs-custommill, check it out with

git clone https://github.com/Siphalor/mkdocs-custommill/
cd mkdocs-custommill

About

Outstanding mkdocs theme with a focus on navigation, customization and usability

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 39.8%
  • HTML 31.8%
  • SCSS 21.9%
  • Python 3.5%
  • CSS 2.8%
  • Batchfile 0.2%