Re: spanish/portuguese translations and texinfo tools
Subject: Re: spanish/portuguese translations and texinfo tools
From: Robert Dodier
Date: Sun, 10 Jul 2005 14:27:33 -0600
Hello,
I've been trying (again) to format the Portuguese and Spanish translations
of the Maxima reference manual.
A lot of effort has been put into the translations. Many thanks to
Jorge Barros de Abreu, Juan Pablo Romero, and Mario Rodriguez.
Thanks also to Karl Berry for his generous advice about texinfo.
In summary, .info and .html output is successful, and .pdf output
is troublesome. I would greatly appreciate any advice about texi2dvi.
An update about how to get stuff to work. As ever there is probably
more than one way to do this.
(1) In main maxima_$LANG.texi file, put @documentencoding ISO-8859-15
just after @setfilename maxima_$LANG.info .
(2) In @defvr and @deffn, enclose words with diacritical marks in { }.
E.g., @defvr declaraci@'on --> @defvr {declaraci@'on}.
(3) Run makeinfo with the --enable-encoding option.
(4) If @,{c} (cedilha) appears in @node or @section,
put @set cedilha @,{c} in maxima_$LANG.texi and
write @value{cedilha} in the @node.
E.g., @node Equa@value{cedilha}@~oes
In maxima/doc/info/pt/, I find the following command lines yield
the .info and .html files entirely successfully, and also the .pdf file
but with a lot of complaints from either tex or texi2dvi (not sure which one).
The maxima_pt.pdf looks OK.
makeinfo --enable-encoding maxima_pt.texi
texi2html --lang=pt --split=chapter --output=tmp-html
--css-include=../manual.css maxima_pt.texi
texi2dvi --pdf --batch --enable-encoding --lang=pt maxima_pt.texi
Others should be able to execute "cvs update" in maxima/doc/info/pt/
and get the same results (assuming the same software versions).
In maxima/doc/info/es/, I find the corresponding commands
makeinfo --enable-encoding maxima.es.texi
texi2html --lang=es --split=chapter --output=tmp-html
--css-include=../manual.css maxima.es.texi
texi2dvi --pdf --batch --enable-encoding --lang=es maxima.es.texi
are entirely successful for .info and .html, and produces a .pdf file,
but texi2dvi eventually stops with the message "That makes 100 errors;
please try again".
Software versions:
makeinfo and texi2dvi both from texinfo-4.8 (rpm from Red Hat).
texi2html is texi2html 1.76 from http://texi2html.cvshome.org .
I have posted html output for English, Portuguese, and Spanish:
http://maxima.sf.net/docs/original/maxima_toc.htmlhttp://maxima.sf.net/docs/original/pt/maxima_pt_toc.htmlhttp://maxima.sf.net/docs/original/es/maxima.es_toc.html
Also the pdf output, such as it is:
http://maxima.sf.net/docs/original/maxima.pdfhttp://maxima.sf.net/docs/original/pt/maxima_pt.pdfhttp://maxima.sf.net/docs/original/es/maxima.es.pdf
Many thanks to the translators for their all their hard work.
Robert Dodier