Re: [Gretl-users] Translation of gretl documentation
On Thu, 12 Feb 2004, Cristian Rigamonti wrote:
The idea would be to have a single xml file (for each language)
containing all the information about gretl commands, organized in
fields such as: name, category (currently used in .hlp files), short
description (currently used in gretl.hlp file), synopsis (currently
used as "Usage:" in gretlcli.hlp and as "Arguments:" in cmdref.xml),
examples, description.
Yes, I think this is the way to go.
The main drawback: it all makes sense if the entries (particularly
the "description" field) for each command have to be uniform across
the three files (as they are at the moment); if one would prefer
e.g. a longer description in the pdf/html manual and a shorter one
in the online help, this approach would not be that convenient.
We could have alternate paragraphs if needed, with "role=whatever".
The main implementation problems:
- Design the new xml repository and write a script to import existing
information into it (in the the most accurate and automated way)
- Write a script to generate the output files from the xml file
Let me know if that sounds worth to try out...
Yes! It sounds very good to me. XSL is probably the best way to get
the various output formats. I'll think about that.
Allin