[petsc-users] [RFC] Docs: TeX -> HTML

[William Gropp]

Another option is to try tohtml, which is what I use for the MPI Standard.  It has a way to specify how to handle some TeX commands (it isn’t a full implementation of TeX, so some more sophisticated uses of TeX are beyond it).

Bill

William Gropp
Director, Parallel Computing Institute
Thomas M. Siebel Chair in Computer Science
Chief Scientist, NCSA
University of Illinois Urbana-Champaign





On Jul 23, 2016, at 4:25 AM, Marco Zocca <zocca.marco at gmail.com> wrote:

> Dear all,
> 
>  following the discussion at PETSc'16, I have tried to render the
> TeX-based manual into HTML with latex2html [1] and pandoc [2] .
> 
> Neither attempt was successful, because of the presence of certain
> external TeX packages used for rendering various custom aspects of the
> manual.
> 
> There is no 1:1 way of converting such a document. However there are a
> number of templates for rendering static websites that use LaTeX math
> and verbatim source code (e.g. readthedocs [3] for manual-type
> documents, which also supports MathJax [4] and re-renders at every
> repository push).
> 
> At any rate, the conversion requires copying blocks of text and code
> to the web-based version, i.e. removing all the LaTeX markup,
> therefore effectively committing to maintaining 2 versions of the
> manual up to date and in sync with each other.
> 
> 
> Before committing to any approach, I would like your input on this:
> 
> 1) Do you have any preference for web rendering/site hosting solution?
> 
> 2) Are you OK with the idea of essentially forking the manual into PDF
> output and web output ? It is not huge work (an afternoon of tweaking
> initially and a couple minutes at every new release) but we should be
> sure about the approach in the first place.
> 
> Any and all feedback is welcome;
> 
> Thank you and kind regards,
> Marco
> 
> 
> [1] https://www.ctan.org/tex-archive/support/latex2html/
> [2] http://pandoc.org/
> [3] https://readthedocs.org/
> [4] http://mathjax.readthedocs.io/en/latest/tex.html