Перевод документации выполняется немного иначе, чем перевод программ. Эта страница содержит инструкции для переводчиков и объяснение последовательности команд, используемых для преобразования документации в шаблоны перевода и обратно.

Для перевода документации Ubuntu, как и для перевода программ, используется портал Launchpad Translation (Rosetta).

Документацию можно найти в следующих пакетах : 'ubuntu-docs', 'kubuntu-docs', 'edubuntu-docs' и 'xubuntu-docs'.

Имеется несколько особенностей, которые надо учитывать при переводе документации.

Несоблюдение этих инструкций приведёт к повреждению переводимого документа.

1. Не следует переводить теги. Если вам встретился в тексте тег (например: «'<xref linkend=«free-software»/>'»), то этот тег и всё, что находится внутри самого тега, переводить не следует. Очень важно копировать и вставлять теги точно так, как они выглядят в английском тексте. Исключением является тег, содержащий URL, если имеется URL русскоязычного ресурса. В этом случае переводчик должен сам выбрать, какой URL указывать.
2. Не следует переводить специальные комбинации символов. Если вы видите выражение типа «'&gt;'», не переводите его.
3. Не меняйте исходный порядок тегов. Если вы видите теги, вложенные один в другой (например: «'<menuchoice><guimenu>System</guimenu><guimenuitem>Administration</guimenuitem><guimenuitem>Users and Groups</guimenuitem></menuchoice>'»), не следует менять этот порядок — копирование и вставка из английского сообщения будет лучшим способом убедиться, что вы его не нарушили. Переведите только слова между тегами.
4. Чтобы увидеть, в каком контексте используются те или иные сообщения в англоязычной справочной документации, щёлкните Система → Справка и поддержка в Ubuntu или Khelpcenter в Kubuntu. Вся эта документация также доступна на http://doc.ubuntu.com
5. Документы не импортируются в Ubuntu автоматически (как при переводе программ). Их нужно экспортировать и вручную загрузить в пакеты. Об этом должна позаботиться команда документации.

Если у вас возникли вопросы, задайте их в списке рассылки ubuntu-translators или в списке рассылки ubuntu-doc.

: Пример явно устарел (Interpid!) и он для французского языка. Надо бы обновить.
: Обновлять незачем, нужно написать универсально, чтобы не обновлять статью каждые полгода.
как пример:

bzr checkout --lightweight lp:ubuntu-doc/***** ubuntu-docs-*****

Вместо звездочек нужно указать точное имя дистрибутива Ubuntu

Теперь вы можете проверить перевод, сделанный вами перевод в Rosetta, вставив его в наш репозиторий и просмотрев его в Yelp.

1. Скачайте файл LANG.po для нужного вам документа из Rosetta. Например, шаблоны для Intrepid можно найти здесь. Эти инструкции приводятся для французского (fr) перевода документа 'internet'.
2. Скачайте ветку Intrepid нашего репозитория:

sudo apt-get install bzr xmlto gettext gnome-doc-utils
bzr checkout --lightweight lp:ubuntu-doc/intrepid ubuntu-docs-intrepid

1. Перейдите в каталог документации

cd ubuntu-docs-intrepid

1. Вставьте новый po-файл в подкаталог 'po' соответствующего каталога документов, используя следующую схему наименования: LANG.po:

mv ~/Desktop/internet-fr.po internet/po/fr.po

1. Запустите сценарий translate, указав в качестве параметров соответствующий документ и язык:

./scripts/translate.sh -d internet -l fr

1. Сценарий обновит docbook xml для вашего документа и языка, а также проверит созданный файл на наличие ошибок и, в случае их наличия, покажет их вам.
2. Откройте файл в приложении для просмотра справки GNOME, которое называется yelp:

yelp file://${PWD}/internet/fr/internet.xml

Yelp всегда требует указания полного пути к документу xml.

Чтобы скомпилировать все документы с новыми переводами, выполните:

for doc in $(cat libs/shipped-docs); do ./scripts/translate.sh -d $doc -l LANG; done

Html-версию можно создать, выполнив следующие команды:

mkdir -p build/html
for doc in $(cat libs/shipped-docs); do find ${doc}/LANG -name "*.xml" -exec xmlto -o build/html html-nochunks {} \;; done

Хорошо сформатированную html-версию (подобную help.ubuntu.com) можно создать, выполнив:

for doc in $(cat libs/shipped-docs); do
     xsltproc --xinclude -o build/html/$doc/$lang/index.html \
	libs/ubuntu-html-chunk-cust.xsl $doc/$lang/$doc.xml 
done

Создайте копию libs/ubuntu-html-chunk-cust.xsl в libs/ubuntu-html-chunk-cust-$lang.xsl, чтобы изменить/локализовать её содержимое. Также проверьте ubuntu-banner.xsl.

Вместо LANG нужно указать код вашего языка.

ПРИМЕЧАНИЕ: если вы хотите внести какие-либо изменения в перевод, это нужно делать в Rosetta.

The rest of this page is a description of how the Documentation Team work gets translated and inserted into Ubuntu. It is primarily intended for reference of the Documentation Team: translators do not need to know all this information.

Для установки всех пакетов, необходимых для создания ubuntu-docs, включая переводы, выполните:

apt-get build-dep ubuntu-docs

There are three steps to getting documentation translated:

1. generating a translation template
2. letting the translators work their magic
3. importing the translations back into our repository

These are taken in turn below.

• When an English XML document is ready for translation, we make a POT file, which is the template that translators use. To make this, we use the command:

xml2po -e -o output.pot input.xml

• For documents spread over more than one file, these can be included as follows:

xml2po -e -o output.pot chapter1.xml chapter2.xml

• ВАЖНО: For documents which have an omf file, these should also be included in the pot file.
• As a result, generally the appropriate command is:

xml2po -e -o output.pot C/*.xml C/*.omf

ПРИМЕЧАНИЕ: We have an automatic script to generate POT files, called 'get-pot.sh'. Running this script refreshes the POT files for all documents.

• The pot file should then be uploaded to rosetta. This is done automatically if the pot is in a source deb package uploaded into the current version of Ubuntu, if not, it must be done manually at the relevant template page in Rosetta.
• Translators then do the rest!

• Automatic exporting from Rosetta into the docteam tree is not implemented. So here is what happens.
• When a good time comes to import the translations, the translations can be downloaded from rosetta (for example, the «Download Translations link here). You can either download translations for all documents or for documents individually.
• The translations from the tarball are placed in the relevant document's directory.
• The translation script (translate.sh) is then used to convert the translations back to xml in the appropriate directory.
• The script also checks the resulting xml for validity, and there are generally errors that must be corrected which are displayed onscreen. This must be done manually.

That's it!

На главную страницу переводчиков