Re: Improving the presentation of Emacs user documentation

[Julius Pfrommer <julius.pfrommer@kit.edu>]

John Wiegley:
> Awesome. Feel free to dig into texi2html, plus better CSS. Double
> bonus if it looks great in eww and on mobile.

There may be a low-cost solution with almost equal results.

Many projects use Sphinx [1] to render their documentation to html.
The look-and-feel of the generated html is selected via themes. Some of
the themes look very similar to the spacemacs example [2].

Somebody already wrote a tool that converts the GCC texinfo
documentation to rst (restructured text), that can then be fed into
Sphinx:
https://gcc.gnu.org/ml/gcc-patches/2015-11/msg01030.html

Depending on the maturity of the conversion, this could be an
alternative build chain to render the documentation to html without
changing the input format. Also, Sphinx can generate good-looking PDFs
and more formats.

[1] http://www.sphinx-doc.org/en/stable/
[2] http://read-the-docs.readthedocs.org/en/latest/theme.html