Re: [RFC] Org version of the Org manual

[tsd@tsdye.com (Thomas S. Dye)]

Achim Gratz <Stromeko@nexgo.de> 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