Zen

Translation

English type: textblock
It is time to convert your documentation to B<po4a> to solve your documentation maintenance nightmares. You want to update the doc when needed, you want to ease the work of your fellow translators, and you want to ensure that your users never see any outdated and thus misleading documentation.
444/2940 · 294

Sign in to save the translation.

English Russian Actions
The workflow of B<po4a> is asynchronous, as suited to open-source projects. The documentation writers author the master documents at their own pace. The translators review and update the translations in the PO files. The maintainers rerun B<po4a> on need, to reflect any change to the original documentation to the PO files, and to produce updated documentation translations, by injecting the latest translation into the latest document structure.
Работа B<po4a асинхронная и подходит для open-source проектов. Технические писатели создают master-документ в одном месте. Переводчики просматривают и обновляют перевод PO-файлов. Мейнтейнеры при необходимости запускают B<po4a>, для отражения именений из исходной документации в PO-файлах и для получения обновленных переводов документации путем вставки обновленных переводов в обновленную структуру документации.
By default, a given translated document is produced when at least 80% of its content is translated. The untranslated text is kept in the original language. The produced documentation thus mixes languages if the translation is not complete. You can change the 80% threshold with the I<--keep> option described below. Note however that discarding translations as soon as they are not 100% may be discouraging for the translators whose work will almost never be shown to the users, while showing "translations" that are too incomplete may be troubling for the end users.
По умолчанию переведённые документы создаются, когда переведено хотя бы 80% содержимого. Непереведённый текст на исходном языке сохраняется. Таким образом, если перевод не завершён, в созданной документации языки комбинируются. Вы можете изменить пороговое значение 80% при помощи описанного ниже параметра I<--keep>. Следует учесть, что если отбрасывать перевод целиком до его завершения на 100%, это может демотивировать переводчиков, так как пользователи практически никогда не будут видеть их работу. С другой стороны, вы можете вызвать у конечных пользователей затруднения, предоставляя им «переводы», которые слишком далеки от завершения.
Storing the translated documentation files in the version control system is probably a bad idea, since they are automatically generated. The precious files are the PO files, that contain the hard work of your fellow translators. Also, some people find it easier to interact with the translators through an online platform such as S<weblate>, but this is naturally fully optional.
Хранение файлов переведенной документации в системе контроля версий, возможно, не лучшая идея, так как она автоматически генерируется. Наиболее ценными являются PO-файлы, которые содержат кропотливую работу выших соратников-переводчиков. Так, некоторые люди считают более простым взаимодействие с переводчиками посредством онлайнплатформ, таких как S<weblate>, но это естественно необязательно.
Quick start tutorial
Быстрый старт
Let's assume you maintain a program named B<foo> which has a man page F<man/foo.1> written in English (the bridge language in most open-source projects, but B<po4a> can be used from or to any language). Some times ago, someone provided a German translation named F<man/foo.de.1> and disappeared. This is a problem because you just got a bug report saying that your documentation contains a gravely misleading information that must be fixed in all languages, but you don't speak German so you can only modify the original, not the translation. Now, another contributor wants to contribute a translation to Japanese, a language that you don't master either.
Предположим, что вы занимаетесь поддержкой программы B<foo>, у который есть man-страница F<man/foo.1> на Английском (общий язык в большинстве СПО-проектах, хотя, вообще говоря, B<po4a> можно использовать и для переводов с любого языка или на любой другой). Некоторое время назад кто-то сделал перевод на немецкий с именем F<man/foo.de.1>, но затем перестал выходить на связь. Затем вы получаете сообщение об ошибке, в котором говорится, что ваша документация содержит недостоверную информацию. Это срочно нужно поправить, причём в документации на всех языках. Но проблема в том, что вы не знаете немецкого, так что вы можете исправить эту ошибку только в исходном документе, но не в переводе. Теперь другой участник хочет добавить японский перевод; язык, которым вы также овладели пока не в полной мере.
It is time to convert your documentation to B<po4a> to solve your documentation maintenance nightmares. You want to update the doc when needed, you want to ease the work of your fellow translators, and you want to ensure that your users never see any outdated and thus misleading documentation.
Это как раз тот момент, когда пришло время начать использовать B<po4a> в вашем проекте, дабы хоть как-то вырваться из этого ада попыток поддержания документации в актуальном состоянии. Вы хотите обновлять документацию по мере необходимости! Вы хотите облегчить работу своих коллег-переводчиков! Вы хотите быть уверенными в том, что ваши пользователи никогда не увидят ни строчки устаревшей и, следовательно, вводящей в заблуждение документации!
The conversion includes two steps: setup the po4a infrastructure, and convert the previous German translation to salvage the previous work. This latter part is done using S<po4a-gettextize>, as follows. As detailed in the documentation of L<po4a-gettextize(1)>, this process rarely fully automatic, but once it's done, the B<de.po> file containing the German translation can be integrated in your po4a workflow.
Чтобы преобразовать проект для использования po4a необходимо выполнить два шага: собственно настройте инфраструктуру po4a и конвертировать уже существующий немецкий перевод, чтобы не потерять уже проделанную работу. Последнее делается с помощью S<po4a-gettextize>. Как описано в документации L<po4a-gettextize(1)>, этот процесс редко является полностью автоматическим, но как только это будет сделано, полученный файл B<de.po> с немецким переводом, может быть с лёгкостью интегрирован в обычный рабочий процесс, основанный на po4a.
po4a-gettextize --format man --master foo.1 --localized foo.de.1 --po de.po
po4a-gettextize --format man --master foo.1 --localized foo.de.1 --po de.po
Let's now configure po4a. With the appropriate file layout, your configuration file could be as simple as this:
Теперь давайте собственно настроим po4a. При соответствующей структуре файлов, файл настроек может состоять всего из пары строк:
[po_directory] man/po4a/
[po_directory] man/po4a/
[type: man] man/foo.1 $lang:man/translated/foo.$lang.1
[type: man] man/foo.1 $lang:man/translated/foo.$lang.1

Loading…

User avatar Fat-Zer

Translation added

  1. po4a
  2. po4a-doc
  3. Russian
It is time to convert your documentation to B<po4a> to solve your documentation maintenance nightmares. You want to update the doc when needed, you want to ease the work of your fellow translators, and you want to ensure that your users never see any outdated and thus misleading documentation.
Это как раз тот момент, когда пришло время начать использовать B<po4a> в вашем проекте, дабы хоть как-то вырваться из этого ада попыток поддержания документации в актуальном состоянии. Вы хотите обновлять документацию по мере необходимости! Вы хотите облегчить работу своих коллег-переводчиков! Вы хотите быть уверенными в том, что ваши пользователи никогда не увидят ни строчки устаревшей и, следовательно, вводящей в заблуждение документации!
3 months ago
User avatar None

String updated in the repository

  1. po4a
  2. po4a-doc
  3. Russian
It is time to convert your documentation to B<po4a> to solve your documentation maintenance nightmares. You want to update the doc when needed, you want to ease the work of your fellow translators, and you want to ensure that your users never see any outdated and thus misleading documentation.
 
a year ago
Browse all string changes

Things to check

Mismatched exclamation mark

Source and translation do not both end with an exclamation mark

Reset

Mismatched full stop

Source and translation do not both end with a full stop

Reset

Glossary

English Russian
po4a po4a Glossary

Software name

String information

Source string description
type: textblock
Source string location
po4a:15
String age
a year ago
Last updated
11 months ago
Source string age
a year ago
Translation file
po/pod/ru.po, string 48