Внесение своего вклада
На этой странице французский язык (fr) используется для примера, однако вы можете заменить его другой код языка. Убедитесь, что сменили /fr суффиксы в вашем гайде на суффиксы того языка, на котором вы осуществляете перевод!
Чтобы узнать, какие языки доступны в настоящий момент, вы можете просмотреть хранилище: https://developer.blender.org/diffusion/BMT/browse/trunk/blender_docs/locale
Примечание
В описании ниже предполагается, что вы уже собрали руководство. Если это не так, вернитесь к разделу С чего начать.
Установка
Языковые файлы
Из каталога, содержащего извлечённую рабочую копию руководства, запустите следующую команду:
svn checkout https://svn.blender.org/svnroot/bf-manual-translations/trunk/blender_docs/locale/fr locale/fr
Команда создаст подкаталог locale/fr.
Вы должны получить структуру каталогов, аналогичную следующей:
blender_docs
|- locale/
| |- fr/
| | |- LC_MESSAGES/
|- manual/
Примечание
При запуске Subversion из командной строки (например, при обновлении или фиксации) вам сначала нужно изменить каталог на locale/fr.
В противном случае вы увидите предупреждение: 'locale' is not under version control
Редактор po-файлов
Чтобы иметь возможность редактировать po-файлы, необходимо установить редактор po-файлов. Мы рекомендуем Poedit, однако подойдёт любой редактор po-файлов.
Примечание
Для пользователей Linux, вам нужно будет проверить наличие Poedit в центре программного обеспечения вашего дистрибутива. Этот редактор носит рекомендательный характер. Есть и другие, такие как Kate и Kwrite, которые могут предлагать подсветку синтаксиса и базовые инструменты для редактирования текста, например, транспонирование буквенного регистра. Другие платформы могут использовать некоторые текстовые редакторы, поддерживающие подсветку синтаксиса для файлов PO или позволяющие создавать собственные (например, Notepad ++ в Windows).
Сборка с переводами
Now you can build the manual with the translation applied:
On Linux and macOS run:
make -e BF_LANG=fr
On Windows run:
set BF_LANG=fr
make html
Теперь у вас есть собранное руководство с применённым переводом.
Редактирование файлов перевода
Now you can edit the PO translation files, in the LC_MESSAGES folder you have two files:
blender_manual.po– This is the main translation file that you will be editing.sphinx.po– This translation file is much smaller and contains translations for the website theme.
To edit these files open them up in your translation editor, i.e. Poedit. Once in your editor you will see a list of texts, each of these items represent some part of the user manual. You may need to adjust your editor to sort the list in a way that makes sense for example «by source».
You can now select an untranslated string and your editor will have an input box to add the translation.
The modified .po files can now submitted as a patch or committed back to SVN.
Совет
Make sure that you Building with Translations to catch any syntax errors you may make while translating. These errors will be displayed as warnings while building the manual.
Фиксация файлов перевода
Смотрите Отправить патчи.
Сопровождение
Отслеживание «нечётких» строк
Когда руководство обновляется, переводы, ставшие неактуальными, помечаются как «нечёткие». Для отслеживания таких строк вы можете использовать инструмент, который мы создали специально для этой задачи.
Вы можете сделать это, выполнив команду:
make report_po_progress
Вывод этой команды содержит лишь краткую сводку по состоянию перевода, для получения же дополнительной информации запустите команду:
python tools_report/report_translation_progress.py locale/fr/
Вы получите список всех файлов с информацией о количестве пустых или «нечётких» строк. Для просмотра дополнительных параметров команды введите:
python tools_report/report_translation_progress.py --help
Обновление файлов PO
При изменениях в оригинальном руководстве необходимо изменять и шаблоны для перевода. Обратите внимание, что это делать не обязательно, поскольку администратор обычно сам обновляет сразу все языки. Таким образом все языки отражают одну и ту же версию руководства. Однако, если вам нужно самостоятельно обновить файлы, вы можете это сделать при помощи следующей команды:
make update_po
Обновлённые шаблоны затем могут быть зафиксированы обратно в svn.
См.также
Руководство по добавлению нового языка можно найти в Adding a Language.