On 9/23/06, Marco Ciampa <ciampix at libero.it> wrote:
> Now is time of the manual. I've contacted a high school professor that has
> the intention of make her students translate the entire manual in italian
> (with some error checking and help) and use this job as a lesson/test for
> this year school program. I'll do the glue that will apply
> the translations to the source code and create the patches (and commit those
> patches to cvs, if you like to let me do it by myself).
> I've contacted a university professor for the math consulting.
Marco, this is tremendous. Thanks a lot for organizing this effort.
I will enable developer privileges for you (ciampix at SF) so that you
can commit files to CVS.
> - in witch format are the help source texts (docbook, latex, ...)
The Maxima documentation is written in Texinfo format.
>From .texi files we generate .html, .pdf, and .info.
The interactive help system for command-line Maxima gets
the text from the .info files.
We will put the Italian translation files into a new directory doc/info/it/.
We'll need to create some Makefile stuff to process those files.
> - witch instrument do you suggest (I already use emacs for everyday use..)
> for writing
Emacs or any plain text editor is OK.
> - witch tools do I need to compile the help file(s)
You need to have a texinfo package installed. I have texinfo-4.8 rpm
on my desktop box.
The texinfo package supplies makeinfo (.texi --> .info) and texi2dvi
(.texi --> .pdf).
Maxima has its own copy of texi2html (.texi --> .html).
I'm sure there will be additional questions, but I'll let that be
enough for now.
Thanks for your interest in Maxima!
Robert Dodier