[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
- RE: Improving the presentation of Emacs user documentation, (continued)
- RE: Improving the presentation of Emacs user documentation, Drew Adams, 2016/02/08
- Re: Improving the presentation of Emacs user documentation, Marcin Borkowski, 2016/02/08
- Re: Improving the presentation of Emacs user documentation, Marcin Borkowski, 2016/02/08
- RE: Improving the presentation of Emacs user documentation, Nicolas Petton, 2016/02/08
- RE: Improving the presentation of Emacs user documentation, Drew Adams, 2016/02/08
- Re: Improving the presentation of Emacs user documentation, Nicolas Petton, 2016/02/08
- Re: Improving the presentation of Emacs user documentation, Richard Stallman, 2016/02/09
- Re: Improving the presentation of Emacs user documentation, Nicolas Petton, 2016/02/09
Re: Improving the presentation of Emacs user documentation, Stefan Monnier, 2016/02/08
Re: Improving the presentation of Emacs user documentation,
Julius Pfrommer <=