Глава 8. Переводы

i18n означает интернационализацию, а l10n — локализацию. Это просто удобные сокращения.

i18n можно прочитать как «i», за которым следует 18 букв, а затем «n». Аналогично, l10n — это «l», за которым следует 10 букв, а затем «n».

Да. Различные группы переводчиков имеют свои собственные списки рассылки. В списке проектов перевода есть дополнительная информация о списках рассылки и веб-сайтах, которые поддерживаются каждым проектом перевода. Кроме того, существует freebsd-translators@freebsd.org для общих обсуждений, связанных с переводом.

Да. Чем больше людей работает над переводом, тем быстрее он будет завершен, и тем быстрее изменения в англоязычной документации отразятся в переведенных документах.

Вам не нужно быть профессиональным переводчиком, чтобы помочь.

В идеале вы должны хорошо знать письменный английский и, разумеется, свободно владеть языком, на который переводите.

Английский язык не является строго обязательным. Например, можно сделать венгерский перевод FAQ из испанского перевода.

Настоятельно рекомендуется поддерживать локальную копию репозитория FreeBSD Git (по крайней мере, документации). Это можно сделать, выполнив:

git.FreeBSD.org — это публичный git сервер.

Вы должны уверенно пользоваться git. Это позволит вам видеть, какие изменения были внесены между разными версиями файлов, из которых состоит документация.

Например, чтобы посмотреть различия между ревизиями abff932fe8 и 2191c44469 файла documentation/content/en/articles/committers-guide/_index.adoc, выполните:

Пожалуйста, ознакомьтесь с полным объяснением использования Git в FreeBSD в Руководстве FreeBSD.

Страница переводов проекта документации содержит список известных на данный момент переводческих инициатив. Если кто-то уже работает над переводом документации на ваш язык, пожалуйста, не дублируйте их усилия. Вместо этого свяжитесь с ними, чтобы узнать, как вы можете помочь.

Если на этой странице не указан переводчик для вашего языка, отправьте сообщение в список рассылки Список рассылки Проекта Документации FreeBSD, возможно, кто-то уже планирует сделать перевод, но еще не объявил об этом.

Поздравляем, вы только что запустили "Проект перевода документации FreeBSD на ваш язык". Добро пожаловать на борт.

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

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

Если в вашей стране уже есть кто-то, предоставляющий услуги зеркалирования FreeBSD, вам следует связаться с ними и спросить, можете ли вы получить место для вашего проекта на их веб-сервере, а также, возможно, электронный адрес или услуги рассылки.

Затем выберите документ и начните перевод. Лучше всего начать с чего-то относительно небольшого — например, с FAQ или одного из руководств.

Это зависит от обстоятельств. Если вы уже работаете с командой переводчиков (например, с японской или немецкой командой), то у них есть свои процедуры обработки представленной документации, которые описаны на их веб-страницах.

Если вы единственный, кто работает над конкретным языком (или вы отвечаете за проект перевода и хотите отправить свои изменения обратно в проект FreeBSD), то вам следует отправить свой перевод в проект FreeBSD (см. следующий вопрос).

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

Каталоги ниже этого уровня именуются в соответствии с языковыми кодами, на которых они написаны, как определено в ISO639 (/usr/share/misc/iso639 в версии FreeBSD новее 20 января 1999 года).

В настоящее время документация FreeBSD хранится в корневом каталоге с названием documentation/. Каталоги ниже него именуются согласно языковым кодам, на которых они написаны, как определено в ISO639 (/usr/share/misc/iso639 в версии FreeBSD новее 20 января 1999 года).

Если ваш язык может быть закодирован различными способами (например, китайский), то ниже должны находиться каталоги для каждого из предоставленных форматов кодировки.

Наконец, у вас должны быть каталоги для каждого документа.

Например, гипотетический перевод на шведский язык может выглядеть так:

sv — это название перевода в форме lang. Обратите внимание на два Makefile, которые будут использоваться для сборки документации.

Используйте команду git diff для создания diff и отправьте его в систему рецензирования.

Вы должны использовать Bugzilla, чтобы отправить отчёт, указав, что вы предоставили документацию. Было бы очень полезно, если бы другие люди проверили ваш перевод перед отправкой, так как маловероятно, что человек, который будет его применять, свободно владеет языком.

Кто-то (скорее всего, руководитель проекта документации, в настоящее время Группа Менеджеров Дерева Документации <doceng@FreeBSD.org>) проверит ваш перевод и убедится, что он собирается. В частности, будут проверены следующие моменты:

Если возникнут проблемы, тот, кто будет рассматривать вашу заявку, свяжется с вами для их решения.

Если проблем не возникнет, ваш перевод будет включён как можно скорее.

Мы бы предпочли, чтобы вы этого не делали.

Например, предположим, что вы переводите Handbook на корейский язык и хотите добавить раздел о розничных продавцах в Корее в ваш Handbook.

Нет никаких реальных причин, по которым эта информация не должна быть в английской (или немецкой, или испанской, или японской, или…​) версиях также. Вполне возможно, что англоговорящий человек в Корее попытается приобрести копию FreeBSD, находясь там. Это также помогает усилить воспринимаемое присутствие FreeBSD по всему миру, что не так уж и плохо.

Если у вас есть информация, специфичная для вашей страны, пожалуйста, отправьте её в виде изменения в англоязычное Руководство (через Bugzilla), а затем переведите это изменение обратно на ваш язык в локализованной версии Руководства.

Спасибо.