From mboxrd@z Thu Jan 1 00:00:00 1970 From: tsd@tsdye.com (Thomas S. Dye) Subject: Re: [RFC] Org version of the Org manual Date: Sat, 09 Mar 2013 13:53:21 -1000 Message-ID: References: <87ehfuonx6.fsf@Rainer.invalid> <87zjyhotvi.fsf@yagnesh.org> <876213cbnu.fsf@Rainer.invalid> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([208.118.235.92]:56588) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UETaP-0004GK-SN for emacs-orgmode@gnu.org; Sat, 09 Mar 2013 18:53:59 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UETaN-0007fA-Ik for emacs-orgmode@gnu.org; Sat, 09 Mar 2013 18:53:57 -0500 Received: from oproxy12-pub.bluehost.com ([50.87.16.10]:35828) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1UETaN-0007ek-9m for emacs-orgmode@gnu.org; Sat, 09 Mar 2013 18:53:55 -0500 In-Reply-To: <876213cbnu.fsf@Rainer.invalid> (Achim Gratz's message of "Thu, 07 Mar 2013 19:22:45 +0100") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Achim Gratz Cc: emacs-orgmode@gnu.org Achim Gratz writes: > Thomas S. Dye writes: >> The orgmanual now creates a pdf file, too, but one lacking the indexes >> and with links that look like they need another run through TeX. > > In that case, texi2dvi and hence make should have signaled an error > (I've just pulled from your repo and it does). > >> When I'm done running `make orgmanual', my directory is very neat and >> tidy, which is nice, but I'll need to look at the auxiliary files used >> to build the indexes, so I can debug. > > Add > > TEXI2PDF+=--tidy That works nicely. I found the error and orgmanual.pdf is now produced without errors. I found that the common combination of `keybinding org-command', which I simplified in the translation to org, looks good in the info file but not in the pdf file, where the elements weren't easy to distinguish visually. I've changed all these to `keybinding, org-command' which still looks simple but works (for me) in both info and pdf formats. Is the html version of the Org manual generated from the .texi source? If so, could you show me how to augment Makefile so the html document is generated by `make orgmanual'? I want to check if the html document looks reasonable. My next step will be to bring orgmanual up-to-date with the changes that have been made to org.texi since I started the translation several months ago. There are still about a half dozen places where I've substituted a `XXX' placeholder for a problem I haven't been able to solve. Sections with problems have been marked FIXME. Most of the problems have to do with exporting a "special" character, such as `\' or `,'. I'm afraid these nagging problems will need to be solved by someone clever in the Org community. All the best, Tom -- Thomas S. Dye http://www.tsdye.com