Context
Doxia is a great content generation framework. It allows good things like:
- using lightweight markup languages
- support several good documentation formats
- parsers which define the semantics (text, links, formatting)
- sink which defines the syntax for a given output
- macro mechanisms which facilate the renderering
Unlikely, from a developer point of view, Doxia has some limitations. Here are some pains:
- Meta informations in Sink are not enough
- Sink doesn't provide CSS
- macros are sticks with the core, i.e. not a plugin approach
- too coupling with Maven
- not thread safe
- TODO add more known limitations
Solutions
This proposal is more a starting discussion of the next Doxia.
References
http://docs.oasis-open.org/office/v1.1/
http://dev.xwiki.org/xwiki/bin/view/Design/NewRenderingArchitecture
Labels