[kde-russian] работа с докой

[kde-russian] работа с докой

[Gregory Mokhin]

Просьба к тем, кто обновляет и выкладывает ро-файлы для документации в 
cvs, придерживаться следующей процедуры:

1. Перед тем, как выложить ро-файл (например, app.po)  в cvs, запустить 
скрипт update-xml в корне kde-i18n со следующими параметрами:

$ update_xml ru app.po

Этот скрипт собирает файл docbook  из русского ро и английского docbook, 
а также проверяет, компилируется ли получившийся русский docbook.

2. Если скрипт отрабатывает с ошибками, то это ошибки связаны скорее 
всего с ошибками в тегах в po-файле. Их надо исправить и вернуться к 
пункту 1.

3. Если скрипт отрабатывает без ошибок, то никаких сообщений не 
выдается, и в каталоге ru/docs/имя_пакета/app появляется обновленный 
файл index.docbook. Если при этом app.po - это новый перевод, то при 
наличии подключения к сети в cvs KDE будут автоматически добавлен новый 
каталог и файлы Makefile.am и .cvsignore.

Таким способом будет обеспечена синтаксическая корректность пакета 
kde-i18n-ru (я получил два баг-репорта на 3.3.2 из-за того, что один 
файл у гентушников не собрался) и синхронность po-файлов и docbook.

Григорий