From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Julius Pfrommer Newsgroups: gmane.emacs.devel Subject: Re: Improving the presentation of Emacs user documentation Date: Wed, 10 Feb 2016 12:18:29 +0100 Message-ID: <20160210121829.000005c2@kit.edu> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1455110452 22623 80.91.229.3 (10 Feb 2016 13:20:52 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 10 Feb 2016 13:20:52 +0000 (UTC) To: , Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Feb 10 14:20:39 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1aTUh5-0000Um-T6 for ged-emacs-devel@m.gmane.org; Wed, 10 Feb 2016 14:20:32 +0100 Original-Received: from localhost ([::1]:39142 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aTUh5-0002FH-2X for ged-emacs-devel@m.gmane.org; Wed, 10 Feb 2016 08:20:31 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:34465) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aTSn8-0001bP-N1 for emacs-devel@gnu.org; Wed, 10 Feb 2016 06:18:39 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aTSn4-0007yJ-Mi for emacs-devel@gnu.org; Wed, 10 Feb 2016 06:18:38 -0500 Original-Received: from scc-mailout-kit-01-web.scc.kit.edu ([129.13.231.93]:35490) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aTSn4-0007y1-GE for emacs-devel@gnu.org; Wed, 10 Feb 2016 06:18:34 -0500 Original-Received: from kit-msx-28.kit.edu ([2a00:1398:9:f612::28]) by scc-mailout-kit-01.scc.kit.edu with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (envelope-from ) id 1aTSn1-0001ze-2g; Wed, 10 Feb 2016 12:18:32 +0100 Original-Received: from localhost (217.231.126.162) by smtp.kit.edu (129.13.50.106) with Microsoft SMTP Server (TLS) id 15.0.1156.6; Wed, 10 Feb 2016 12:18:30 +0100 X-Mailer: Claws Mail 3.13.0 (GTK+ 2.24.28; i686-w64-mingw32) X-Originating-IP: [217.231.126.162] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 129.13.231.93 X-Mailman-Approved-At: Wed, 10 Feb 2016 08:20:03 -0500 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:199688 Archived-At: 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