* [kde-russian] docs news
@ 2002-10-15 9:32 mok
2002-10-15 14:56 ` Leon Kanter
0 siblings, 1 reply; 2+ messages in thread
From: mok @ 2002-10-15 9:32 UTC (permalink / raw)
To: kde-russian
Кое-что к FAQ о переводе документации.
Чтобы дока вошла в релиз, нужно собирать docbook-файлы из po-файлов.
Раньше это примерно раз в месяц делал скрипт на сервере. Теперь халява
прикрылась, нужно будет самим это делать (см. текст сообщения ниже).
Делается это так. В онлайн запускаем скрипт из корня kde-i18n/ (чтобы
этот скрипт там появился, не забываем сделать $ cvs up -l kde-i18n).
$ kde-i18n/update_xml ru
Тем самым будет запущена пересборка всех файлов доки из ро-файлов.
Чтобы собрать только один файл, нужно запускать с именем файла:
$ kde-i18n/update_xml ru kword
Файлы, которые собрались без проблем, будут сразу выложены в cvs KDE.
Но часть файлов точно не соберется. По двум причинам.
1. Ошибки в переводе ро-файла. Чаще всего путаница с XML-сущностями,
типа &kword;, где переводчик забывает добавить закрывающую точку с
запятой, или с ROLES_OF_TRANSLATORS и CREDIT_FOR_TRANSLATORS, которые
надо переводить с правильными тегами XML (о чем написано в FAQ):
"Сведения о переводчике в файле документации:
ROLES_OF_TRANSLATORS переводим так:
<othercredit role=\"translator\"><firstname>Василий</firstname><surname>Пупкин</surname>
<affiliation><address><email>pup@pp.ru</email></address></affiliation>
<contrib>Перевод на русский</contrib></othercredit>
а CREDIT_FOR_TRANSLATORS так:
<para>Перевод на русский: Василий Пупкин <email>pup@pp.ru</email></para>
"
2. Устаревший файл ru.xml из kdelibs/kdoctools/docbook/xsl/common/,
который содержит стандартные макросы XML, используемые в переводе. Я
его обновил полгода назад и выслал ведущему проекта docbook на
sourceforge.net Norman Walsh, но он только сейчас озаботился его
обновить. Соответственно, мы войдем в релиз со старым файлом, из-за
чего некоторые доки не соберутся.
Леонид, можно вас попросить запустить этот скрипт и сообщить в
рассылке результаты? Я физически сейчас не могу это сделать.
Гриша
===========================================================================
From: Йric Bischoff <e.bischoff@noos.fr>
To: kde-i18n-doc@kde.org
Subject: [important] No more automatic generation of DocBook files
===8<==============Original message text===============
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
ь
^ permalink raw reply [flat|nested] 2+ messages in thread
* Re: [kde-russian] docs news
2002-10-15 9:32 [kde-russian] docs news mok
@ 2002-10-15 14:56 ` Leon Kanter
0 siblings, 0 replies; 2+ messages in thread
From: Leon Kanter @ 2002-10-15 14:56 UTC (permalink / raw)
To: kde-russian
mok@kde.ru wrote:
>
>Леонид, можно вас попросить запустить этот скрипт и сообщить в
>рассылке результаты? Я физически сейчас не могу это сделать.
>
>Гриша
>
>
>
Я к сожалению только завтра смогу - весь день на работе света не было :(
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2002-10-15 14:56 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2002-10-15 9:32 [kde-russian] docs news mok
2002-10-15 14:56 ` Leon Kanter
рассылка русскоязычной группы пользователей и разработчиков KDE
This inbox may be cloned and mirrored by anyone:
git clone --mirror http://lore.altlinux.org/kde-russian/0 kde-russian/git/0.git
# If you have public-inbox 1.1+ installed, you may
# initialize and index your mirror using the following commands:
public-inbox-init -V2 kde-russian kde-russian/ http://lore.altlinux.org/kde-russian \
kde-russian@lists.kde.ru
public-inbox-index kde-russian
Example config snippet for mirrors.
Newsgroup available over NNTP:
nntp://lore.altlinux.org/org.altlinux.lists.kde-russian
AGPL code for this site: git clone https://public-inbox.org/public-inbox.git