docbook -> xml Konvertierung

Sebastian Stein kde-i18n-de@mail.kde.org
Sat, 30 Nov 2002 17:53:03 +0100


Stephan Kulow <coolo@kde.org> [021130 17:22]:
> Du wirfst hier einiges durcheinander. Docbook-Dateien _sind_ XML.
> Wenn Du eine index.docbook Datei hast, brauchst Du nur
> KDE_LANG = de
> KDE_DOCS = AUTO
> 
> in das Makefile.am dazu eintragen

Mmmh, ich dachte immer docbook ist sgml und xml ist nur eine strikte
Teilmenge davon. Das ist aber letztendlich auch egal. Sehe ich es richtig,
dass am Ende immer *.docbook Dateien im entsprechenden KDE doc Pfad sein
muessen? Wenn dem so ist, warum steht dann in der Translation HowTo, dass
die docbook Dateien zuerst in XML umgewandelt werden muessen, bevor man sie
in pot Dateien splitten kann?

Ich zitiere mal die entsprechenden Abschnitte, die mich jetzt doch irgendwie
verwirrren:

> Conversion from SGML to XML\231/PO Format The documentation format has
> already seen quite some fundamental changes over the last years. It
> started as HTML, became LinuxDoc SGML for KDE 1.x and was converted to
> DocBook SGML for KDE 2.0....
> ... On top that, the SGML format required the installation of a bunch of
> very complex additional software with lots of dependencies and parameters
> which were not easy to handle. As KDE spread over more and more languages
> the problems with the limited ASCII encoding became also more important
> and a switch to XML and Unicode (in its UTF-8 subformat) seemed advisable.

Wie dem auch sei, richtig ist, dass man die docbook Dateien mittels xml2pot
in pot Dateien umwandeln kann. Das haette ich Esel ja gleich mal probieren
koennen.

Also nehme ich mal an, das Vorgehen lautet (erstmalig):

xml2pot original.docbook > original.pot
cp original.pot ../de/original.po
kbabel ../de/original.po
po2xml original.docbook ../de/original.po > ../de/original.docbook

Ich nehme mal an, der Originalauthor aendert weiterhin nur die
original.docbook Datei?! Wenn diese sich aendert, macht man dann sinngemaess
folgendes:

xml2pot original.docbook > original.pot
split2po original.docbook ../de/original.docbook > ../de/original.po
msgmerge -o ../de/original.po ../de/original.po original.pot
kbabel ../de/original.po
po2xml original.docbook ../de/original.po > ../de/original.docbook

Hab ich es jetzt? Wenn ja, gibt es dafuer schon Skripte bzw. irgendwelche
Unterstuetzung in den Makefiles (admin/Makefile.common)? Legt man
sinnvollerweise nur die docbook Dateien im CVS ab, oder?

Steinchen
-- 
http://www.hpfsc.de/ - die Seite rund um:
Assembler, Bundeswehr, TFT LCDs, Halle/Saale, Fahrradtouren,
Wanderstaat Mauma, Raumschiff USS Nathan, Enemy Room, MLCAD Tutorial