[tor-bugs] #10979 [Tor bundles/installation]: Research if pandoc + po4a are good tools for a Tor Browser User Manual in Markdown

[Tor Bug Tracker & Wiki]

#10979: Research if pandoc + po4a are good tools for a Tor Browser User Manual in
Markdown
--------------------------------------+-----------------------
 Reporter:  lunar                     |          Owner:  lunar
     Type:  task                      |         Status:  new
 Priority:  normal                    |      Milestone:
Component:  Tor bundles/installation  |        Version:
 Keywords:  SponsorO                  |  Actual Points:
Parent ID:  #10978                    |         Points:
--------------------------------------+-----------------------
 [http://johnmacfarlane.net/pandoc/ Pandoc] can turn almost any markup into
 another markup. The HTML output can be made self-contained using the
 `--self-contained` command-line option.

 [http://po4a.alioth.debian.org/ 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.

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/10979>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online