emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Improving the presentation of Emacs user documentation


From: Julius Pfrommer
Subject: Re: Improving the presentation of Emacs user documentation
Date: Wed, 10 Feb 2016 12:18:29 +0100

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



reply via email to

[Prev in Thread] Current Thread [Next in Thread]