Research if pandoc + po4a are good tools for a Tor Browser User Manual in Markdown
Pandoc can turn almost any markup into another markup. The HTML output can be made self-contained using the --self-contained
command-line option.
po4a will extract content and merge translations for plain text. It can also do that for Docbook which might be more precise.
The pipeline would be: Markdown → Docbook → Extract / merge translations → HTML.
The --filter
option would allow use to easily select sections based on OS or language but is not available on wheezy or the TBB build VM. “Pragma style comments” and sed
might do the trick in the short term.