Doc generators

m.css is not just for stat­ic sites and blogs — there’s a need for a mod­ern, light­weight and mo­bile-friend­ly lay­out for API doc­u­men­ta­tion as well. The m.css doc­u­men­ta­tion gen­er­a­tors are de­fined by their first-class search func­tion­al­i­ty and clut­ter-free out­put, fa­vor­ing hu­man-pro­duced doc­u­men­ta­tion over au­to­gen­er­at­ed con­tent.

Fea­tures

All m.css doc­u­men­ta­tion themes share the fol­low­ing fea­tures:

  • Mod­ern, light­weight and mo­bile-friend­ly HTM­L5 markup
  • Min­i­mal­is­tic de­sign with­out un­nec­es­sary chrome and UI el­e­ments
  • Fo­cused on pre­sent­ing the ac­tu­al writ­ten doc­u­men­ta­tion while re­duc­ing ques­tion­able au­to-gen­er­at­ed con­tent
  • Math ren­dered as em­bed­ded SVG in­stead of raster im­ages / Math­Jax, mak­ing use of the m.math plug­in
  • Graphviz / Dot di­a­grams ren­dered as em­bed­ded SVG, as im­ple­ment­ed in m.dot
  • Us­ing Pyg­ments for bet­ter code high­light­ing, cour­tesy of the m.code plug­in

Doxy­gen C++ theme »

More than just a theme — tak­ing the XML out­put pro­duced by Doxy­gen, clean­ing it up, re­duc­ing the au­to­gen­er­at­ed clut­ter, while mak­ing it mo­bile-friend­ly and ex­tend­ing it with bet­ter con­tent lay­out­ing ca­pa­bil­i­ties and im­proved sup­port for C++11 and be­yond. Ful­ly com­pat­i­ble with Doxy­gen URL for­mat and tag files to avoid bro­ken links once you switch.

Python docs »

All fea­tures you’re used to from ei­ther the m.css Pel­i­can theme or the Doxy­gen C++ theme, on­ly for Python doc­u­men­ta­tion. Ex­tract­ing Python APIs us­ing re­flec­tion, not pars­ing Python sources it­self. With ded­i­cat­ed sup­port for py­bind11 projects.