bootDoc - advanced DDoc framework using Twitter's Bootstrap
Jakob Ovrum
jakobovrum at gmail.com
Wed May 2 11:26:08 PDT 2012
This project is finally published and documented, so here's an
announcement.
https://github.com/JakobOvrum/bootDoc
bootDoc is a configurable DDoc theme, with advanced JavaScript
features like a package tree and module tree, as well as fully
qualified symbol anchors. The style itself and some of the
components come from Twitter's Bootstrap framework.
Demonstration of Phobos documentation using bootDoc
http://jakobovrum.github.com/bootdoc-phobos/
LuaD's official documentation also uses bootDoc
http://jakobovrum.github.com/LuaD/
bootDoc is designed to be easily usable with any project. It is
used as a git-submodule in both of the above sample scenarios.
All project-specific settings are provided by a separate
configuration file (settings.ddoc), which is documented on the
project's Github wiki.
bootDoc includes a general-purpose generation script. See the
readme on Github for usage information. The script uses a
candyDoc-style modules.ddoc as input, making the transition from
candyDoc projects easy.
Note about noscript: JavaScript is used to get around the static
nature of DDoc. The sidebar does not work without JavaScript, and
neither do fully qualified anchor names. However, anchors with
ambiguous names (such as those usable for symbols on dlang.org)
work both with and without JavaScript, with the same limitations.
Comments, issues, enhancement requests, questions or rants about
JavaScript - all feedback is much appreciated!
More information about the Digitalmars-d-announce
mailing list