You are viewing a plain text version of this content. The canonical link for it is here.
Posted to rivet-dev@tcl.apache.org by SmAsH <pa...@freenet.de> on 2003/08/26 16:34:03 UTC
documentation translation
Hello,
if you feel the like I'd translate the Documentation into German, I am just a bit confused about the old and the new one, so could you point me directly to the new english documentation, which includes the changes of the buildscripts etc.?
best regards
Patrick
Re: documentation translation
Posted by "David N. Welton" <da...@dedasys.com>.
Sorry this is taking so long... please do wait on the translations
until I'm done though.
I started adding in the tcl commands, and then realized we had a lot
of commands on one page.
So I decided that page needed an index.
I have been wrestling with the necessary XSL/DocBook issues ever
since... it's been pretty hairy, but I think we may have an answer in
sight. Unfortunately, it will probably mean pretty major
modifications to the commands section:-(
--
David N. Welton
Consulting: http://www.dedasys.com/
Personal: http://www.dedasys.com/davidw/
Free Software: http://www.dedasys.com/freesoftware/
Apache Tcl: http://tcl.apache.org/
---------------------------------------------------------------------
To unsubscribe, e-mail: rivet-dev-unsubscribe@tcl.apache.org
For additional commands, e-mail: rivet-dev-help@tcl.apache.org
Re: documentation translation
Posted by "David N. Welton" <da...@dedasys.com>.
"SmAsH" <pa...@freenet.de> writes:
> So I just need to translate the rivet.xml?
Correct.
> I am just wondering why the rivet.xml has all the text included what
> is the purpose of having files like directives.html.en then? And do
> I need to translate all those also?
rivet.xml is the sources to the documentation. It's done with the
DocBook DTD ( http://docbook.org/tdg/en/html/docbook.html ). Since
all the elements are described for what they are (command, variable,
whatever), it is possible to create 'stylesheets' (not CSS) in XSL
that output a number of different formats, such as the HTML you see in
directives.html.en. You didn't really think I wrote that mess by hand
did you?:-)
That means that all you have to do is translate rivet.xml to
rivet.de.xml. You don't really even have to worry about the markup, I
can help out if there are any doubts... You also want to add yourself
as the translator - see the Italian translation for an example.
--
David N. Welton
Consulting: http://www.dedasys.com/
Personal: http://www.dedasys.com/davidw/
Free Software: http://www.dedasys.com/freesoftware/
Apache Tcl: http://tcl.apache.org/
---------------------------------------------------------------------
To unsubscribe, e-mail: rivet-dev-unsubscribe@tcl.apache.org
For additional commands, e-mail: rivet-dev-help@tcl.apache.org
Re: documentation translation
Posted by SmAsH <pa...@freenet.de>.
So I just need to translate the rivet.xml? I am just wondering why the
rivet.xml has all the text included what is the purpose of having files like
directives.html.en then? And do I need to translate all those also?
best regards
Patrick
----- Original Message -----
From: "David N. Welton" <da...@dedasys.com>
To: <ri...@tcl.apache.org>
Sent: Tuesday, August 26, 2003 4:50 PM
Subject: Re: documentation translation
> "SmAsH" <pa...@freenet.de> writes:
>
> > if you feel the like I'd translate the Documentation into German,
>
> I would really appreciate that! It would be great.
>
> > I am just a bit confused about the old and the new one, so could you
> > point me directly to the new english documentation, which includes
> > the changes of the buildscripts etc.?
>
> What I meant in the previous email was that I had updated the
> documentation in CVS. "THE" documentation is still the rivet.xml
> file.
>
> To do a German translation, you would copy that to rivet.de.xml, and
> then go about replacing the English text with German. You would also
> include that it's based on version 1.30 of the English document (or
> whatever version is current at the time you do the work). That way,
> people will know how the version they are looking at compares with the
> English version, and can decide whether it looks out of date or not
> (for instance, the Russian translation is based on 1.20 of rivet.xml
> and the Italian docs on 1.27).
>
> Thanks,
> --
> David N. Welton
> Consulting: http://www.dedasys.com/
> Personal: http://www.dedasys.com/davidw/
> Free Software: http://www.dedasys.com/freesoftware/
> Apache Tcl: http://tcl.apache.org/
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: rivet-dev-unsubscribe@tcl.apache.org
> For additional commands, e-mail: rivet-dev-help@tcl.apache.org
>
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: rivet-dev-unsubscribe@tcl.apache.org
For additional commands, e-mail: rivet-dev-help@tcl.apache.org
Re: documentation translation
Posted by "David N. Welton" <da...@dedasys.com>.
"SmAsH" <pa...@freenet.de> writes:
> if you feel the like I'd translate the Documentation into German,
I would really appreciate that! It would be great.
> I am just a bit confused about the old and the new one, so could you
> point me directly to the new english documentation, which includes
> the changes of the buildscripts etc.?
What I meant in the previous email was that I had updated the
documentation in CVS. "THE" documentation is still the rivet.xml
file.
To do a German translation, you would copy that to rivet.de.xml, and
then go about replacing the English text with German. You would also
include that it's based on version 1.30 of the English document (or
whatever version is current at the time you do the work). That way,
people will know how the version they are looking at compares with the
English version, and can decide whether it looks out of date or not
(for instance, the Russian translation is based on 1.20 of rivet.xml
and the Italian docs on 1.27).
Thanks,
--
David N. Welton
Consulting: http://www.dedasys.com/
Personal: http://www.dedasys.com/davidw/
Free Software: http://www.dedasys.com/freesoftware/
Apache Tcl: http://tcl.apache.org/
---------------------------------------------------------------------
To unsubscribe, e-mail: rivet-dev-unsubscribe@tcl.apache.org
For additional commands, e-mail: rivet-dev-help@tcl.apache.org