From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: Re: epub version of Emacs manual (was: request for participating) Date: Sun, 22 Dec 2019 11:14:41 -0800 Organization: UCLA Computer Science Department Message-ID: <5a687389-173f-d77b-e52e-640162fbe86c@cs.ucla.edu> References: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="83155"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.2.2 Cc: emacs-devel@gnu.org To: Sam Qasbah Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Dec 22 20:15:22 2019 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1ij6hE-000LRK-AP for ged-emacs-devel@m.gmane.org; Sun, 22 Dec 2019 20:15:21 +0100 Original-Received: from localhost ([::1]:50122 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ij6hC-0003lw-Hv for ged-emacs-devel@m.gmane.org; Sun, 22 Dec 2019 14:15:18 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54561) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ij6gg-0003K7-Uj for emacs-devel@gnu.org; Sun, 22 Dec 2019 14:14:48 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ij6gf-0005Fq-BN for emacs-devel@gnu.org; Sun, 22 Dec 2019 14:14:46 -0500 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:36400) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ij6ge-0005CS-W8 for emacs-devel@gnu.org; Sun, 22 Dec 2019 14:14:45 -0500 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 266191600F1; Sun, 22 Dec 2019 11:14:43 -0800 (PST) Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id vuAonZUkKeVM; Sun, 22 Dec 2019 11:14:42 -0800 (PST) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 0B8A6160158; Sun, 22 Dec 2019 11:14:42 -0800 (PST) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id 0odRGXOMS-Ky; Sun, 22 Dec 2019 11:14:41 -0800 (PST) Original-Received: from [192.168.1.9] (cpe-23-242-74-103.socal.res.rr.com [23.242.74.103]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id B614A1600F1; Sun, 22 Dec 2019 11:14:41 -0800 (PST) In-Reply-To: Content-Language: en-US X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] X-Received-From: 131.179.128.68 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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" Xref: news.gmane.org gmane.emacs.devel:243565 Archived-At: On 12/22/19 9:23 AM, Sam Qasbah wrote: > It is not a simple conversion from texi > to epub, but a craft work of organizing and adapting the files, rewriting > the formatting and adding a cover with a "fascinating" flavor. Thanks for volunteering; it looks like a worthwhile thing to have. A good way to get started would be to propose a patch to the Emacs master version, to support an epub manual. You can do this by sending email to bug-gnu-emacs@gnu.org and attach a patch, preferably in 'git format-patch' format; see for an example. However, I worry that this would mean there would be two versions of the Emacs manual, the main one maintained by developers in .texi format, and the epub one which presumably would lag behind the main one. We wouldn't, for example, want to delay an Emacs release while waiting for the epub version to catch up. Is there some way to avoid this problem, by automating the epub version generation? Perhaps it would be better to live with a not-quite-so-nice conversion, if the conversion could be automated more. For ideas along those lines, please see: https://per.bothner.com/blog/2016/texinfo-roadmap/ https://github.com/jlhg/texinfo2epub https://github.com/ikrukov/epub https://lists.gnu.org/archive/html/bug-texinfo/2018-07/msg00009.html