• Stars
    star
    276
  • Rank 149,319 (Top 3 %)
  • Language
    HTML
  • License
    Other
  • Created about 5 years ago
  • Updated about 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A Superhero-inspired modification of the Cinder theme for MkDocs

Cinder + Superhero

A Superhero-inspired 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.