dag/kibr — Issue #19: Markup of definitions/notes etc
Author: dag
Created: 2012-02-02 12:13:26+00:00
State: open
Labels: Conceptual

Possible options:

* Keep the current LaTeX. IMO LaTeX is a crappy storage format as it's really only meant for print. On the plus side, we don't need to convert existing definitions (but still need basic conversion to HTML for presentation).
* Docbook. Semantically rich and good for storage, but verbose to edit.
* Some edit-friendly format that converts more or less directly to docbook, such as asciidoc.
* Creole. Not very rich but standardized and web-edit-friendly. Things we need such as subscripts are not yet standard.
* Custom preprocessor, possibly on top of any of the above. Could be used to turn `x1` into whatever is the real markup for subscripts, and for cross-linking `{words in brackets}` etc.

I think the best option is maybe raw docbook with custom preprocessor. I suspect asciidoc has too much syntax that might get in our way. Definitions and notes are mostly plain text with subscripts and cross-links - unless this is a result of the current limitations of jbovlaste / LaTeX markup being little known?