Skip to content

A Superhero-inspired modification of the Cinder theme for MkDocs

License

Notifications You must be signed in to change notification settings

Orbiter/MkDocs-Theme-Cinder-Superhero

Repository files navigation

Cinder + Superhero

A Superhero-inspired bootstrap dark theme based on Cinder for MKDocs

A live version of this mkdocs project is hosted as github pages

This is how documentation will look like:

Screenshot

Usage:

  • Install MKDocs according to https://www.mkdocs.org/#installation
  • Run mkdocs serve to host a live version of your documents, watch them at http://localhost:8000/
  • Run mkdocs build to make a static web page out of your documentation inside site
  • Edit the documentation markdown files in docs to make your own documentation

Why? Why???

The original Cinder implementation is great but has some design decisions which are fixed here:

  • For a privacy-aware implementation we do not want any external links. Therefore all context, loaded by CDNs or other sources (google etc.) had been either removed or completely embedded. This MKDocs theme is now privacy-aware!
  • The very bright appearance of Cinder does not fit Programming-oriented colour styles where we prefer a dark appearance. As a reference the superhero implementation is the best place to steal styles and colours. So this is like the dark version of Cinder.

About

A Superhero-inspired modification of the Cinder theme for MkDocs

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published