[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-i18n-doc
Subject:    [important] No more automatic generation of DocBook files
From:       Éric Bischoff <e.bischoff () noos ! fr>
Date:       2002-10-04 17:58:23
[Download RAW message or body]

Hi all,

There is an important change:

	The DocBook files will not be regenerated automatically
	out of the translated po files anymore.

This means that, if you want to see your translated documentation in KDE 3.1, 
you need to run update_xml yourself each time you commit a po file.

To convert a po file into docbook, place yourself in kde-i18n directory, and 
type:
	./update_xml <language code> <doc name>
For example:
	./update_xml pt_BR kcontrol

If there are warning or errors, you need to fix them in the po file, until it 
compiles fine. I can help you out through private mail if you experience 
problems fixing the problem.

After the conversion, you need to commit the resulting docbook file. For 
example:
	cvs commit pt_BR/docs/kdebase/kcontrol

To know which files need being converted to docbook, look at the yellow 
entries in:
	http://i18n.kde.org/stats/doc/test/

Currently, the top five teams that most need to regenerate their docs are:
	French team: 20 docs to regenerate
	Catalan team: 16 docs to regenerate
	German team: 14 docs to regenerate
	Hungarian team: 10 docs to regenerate
	Spanish team: 9 docs to regenerate

REMIND. NOW YOU ARE ON YOUR OWN. IF YOU DO NOT REGENERATE THE DOCBOOK FILES, 
NOBODY ELSE WILL DO IT FOR YOU ANYMORE.

Thanks for your understanding.

-- 
Éric Bischoff
KDE : ad expugnandum tabulam scriptoriam suam
[prev in list] [next in list] [prev in thread] [next in thread]