From Fedora Project Wiki

< L10N‎ | Guide

No edit summary
 
(20 intermediate revisions by 4 users not shown)
Line 5: Line 5:
= Введение =
= Введение =


Это руководство содержит быстрые и простые пошаговые инструкции по переводу программного обеспечения и документации в проекте Fedora. Вы можете найти частозадаваемые вопросы в конце страницы.
Это руководство содержит быстрые и простые пошаговые инструкции по переводу программного обеспечения и документации в проекте Fedora. Вы можете найти часто задаваемые вопросы в конце страницы.


{{Admon/note | Нам нужна обратная связь! | Если вы нашли типографическую ошибку в этом руководстве или если у вас есть мысли о том, как улучшить данное руководство, пожалуйста, совершенно спокойно редактируйте эту страницу или отправьте письмо напрямую в рассылку проекта локализации. Если у вас есть предложение по улучшению документации, постарайтесь сформулировать его настолько точно, насколько возможно. Если вы нашли ошибку, пожалуйста, укажите номер главы и процитируйте текст вокруг, чтобы ее было легче найти.}}
{{Admon/note | Нам нужна обратная связь! | Если вы нашли типографическую ошибку в этом руководстве или если у вас есть мысли о том, как улучшить данное руководство, пожалуйста, совершенно спокойно редактируйте эту страницу или отправьте письмо напрямую в рассылку проекта локализации. Если у вас есть предложение по улучшению документации, постарайтесь сформулировать его настолько точно, насколько возможно. Если вы нашли ошибку, пожалуйста, укажите номер главы и процитируйте текст вокруг, чтобы ее было легче найти.}}


 
'''Сайтом проекта локализации Fedora является https://fedora.zanata.org/'''.
'''Сайтом проекта локализации Fedora является https://fedora.transifex.net/'''.


= Получение помощи =
= Получение помощи =


Если у вас ест вопросы, задавайте их в рассылке {{fplist|trans}} или просите помощи в irc.freenode.org на канале #fedora-l10n.
Если у вас есть вопросы, задавайте их в рассылке {{fplist|trans}} или просите помощи на irc.freenode.org на канале #fedora-l10n.


Вы можете найти больше информации на Transifex по адресу: '''http://help.transifex.net/'''.
{{Anchor|Join}}


= Как стать переводчиком Fedora =
= Как стать переводчиком Fedora =
Line 22: Line 21:
Чтобы стать переводчиком, вам необходимо зарегистрироваться и получить доступ к рабочим материалам:
Чтобы стать переводчиком, вам необходимо зарегистрироваться и получить доступ к рабочим материалам:


#[https://fedoraproject.org/wiki/L10N/Guide#Create_a_Transifex_Account Создайте аккаунт на Transifex]
#[https://fedora.zanata.org Создайте аккаунт в Zanata]
#[https://fedoraproject.org/wiki/L10N/Guide#Subscribe_to_the_Mailing_List Подпишитесь на почтовые рассылки]
#[https://fedoraproject.org/wiki/L10N/Guide/ru#mailing_lists Подпишитесь на почтовые рассылки]
#[https://fedoraproject.org/wiki/L10N/Guide#Introduce_Yourself Представьтесь]
#[https://fedoraproject.org/wiki/L10N/Guide/ru#Introduce_Yourself Представьтесь]
#[https://fedoraproject.org/wiki/L10N/Guide#Joining_your_Fedora_translation_team Присоединитесь к команде переводчиков Fedora]
#[https://fedoraproject.org/wiki/L10N/Guide/ru#Joining_translation_team Присоединитесь к команде переводчиков Fedora]


Ваше письмо о себе очень важно. Оно увеличивает ваши шансы получить одобрение для доступа к материалам. Вам так же может понадобиться  [https://fedoraproject.org/wiki/L10N/Guide#Creating_a_Bugzilla_Account создать аккаунт в Bugzilla], чтобы работать над ошибками, о которых сообщают пользователи.
Ваше письмо о себе очень важно. Оно увеличивает ваши шансы получить одобрение для доступа к материалам. Вам так же может понадобиться  [https://fedoraproject.org/wiki/L10N/Guide/ru#Creating_a_Bugzilla_Account создать аккаунт в Bugzilla], чтобы работать над ошибками, о которых сообщают пользователи.


== Знакомство с Transifex ==
== Знакомство с Transifex ==


Fedora использует Transifex для управления процессами по локализации. Следующие шаги помогут вам в создании аккаунта на Transifex и присоединении к команде.
Fedora использует <s>Transifex</s> Zanata для управления процессами по локализации. Следующие шаги помогут вам в создании аккаунта на Transifex и присоединении к команде.


http://fedora.transifex.net/
http://fedora.transifex.net/


{{Anchor|Tx_account}}
=== Создание аккаунта в Transifex ===
=== Создание аккаунта в Transifex ===


Line 42: Line 42:
# Теперь вы можете зайти на Transifex под вашей учетной записью.
# Теперь вы можете зайти на Transifex под вашей учетной записью.


{{Anchor|Joining_translation_team}}
=== Вступление в группу переводчиков Fedora ===
=== Вступление в группу переводчиков Fedora ===


# Зайдите на страницу Fedora Teams https://www.transifex.net/projects/p/fedora/teams/.
# Зайдите на страницу [https://translate.zanata.org/language/list?dswid=5344 Languages] в Zanata.
# Выберите русский язык и нажмите на него.
# Выберите русский язык и нажмите на него.
# Вы увидите список участников и координатора. Нажмите "Join this team", чтобы отправить запрос на присоединение.
# Вы увидите список участников и координатора. Нажмите "Join this team", чтобы отправить запрос на присоединение.
Line 52: Line 53:
Это может занять несколько часов или дней. Если прошло больше, нажмите на имя координатора в Transifex и отправьте ему личное сообщение для получения информации.
Это может занять несколько часов или дней. Если прошло больше, нажмите на имя координатора в Transifex и отправьте ему личное сообщение для получения информации.


== Subscribe to the Mailing List ==
{{Anchor|mailing_lists}}


# Visit {{fplist|trans}} and subscribe to the main translation mailing list.
== Подпишитесь на почтовую рассылку ==
# Wait for the confirmation email which contains a link to confirm your subscription. Click the link to confirm your subscription.


Check https://fedoraproject.org/wiki/L10N/Teams to see if there is a special mailing list for your language. If so, subscribe to that list too.
# Зайдите на {{fplist|trans}} и подпишитесь в основной рассылке переводчиков.
# Дождитесь письма со ссылкой для подтверждения вашей подписки. Перейдите по ссылке для подтверждения.
# Аналогично подпишитесь на русскоязычную рассылку {{fplist|trans-ru}}.


== Introduce Yourself ==
{{Anchor|Introduce_Yourself}}
== Представьтесь ==


# Create a personal page at https://fedoraproject.org/wiki/User:Username. This is very useful for Fedora contributors to get to know and contact each other. You'll need to [https://fedoraproject.org/wiki/L10N/Guide#Create_a_Fedora_Account create a Fedora account] for that.
# Создайте личную страницу, следуя [[Template:Userpage_ru|руководству]]. Это очень полезно, т.к. другим участникам Fedora будет легче найти информацию о вас и связаться с вами. Для этого вам необходимо [https://fedoraproject.org/wiki/L10N/Guide#Create_a_Fedora_Account создать аккаунт Fedora].
# Post a short self introduction to the trans mailing list and to the list of your local team with instructions from https://fedoraproject.org/wiki/L10N_Self_introduction. Please remember to include your FAS user name and your language. With this information, your language leader can identify you and approve you as a translator on his team.
# Отправьте короткое письмо с информацией о себе в основную и русскоязычную рассылки, следуя [[L10N_Self_introduction/ru|инструкции]]. Пожалуйста, помните, что нужно указать ваше имя в FAS и ваш язык. По этой информации координатор вашей команды сможет отследить вас и одобрить ваш запрос на присоединение к команде.


== Creating a Bugzilla Account ==
== Создание аккаунта в Bugzilla ==


If you are asked to use Bugzilla, create an account by visiting https://bugzilla.redhat.com/bugzilla/createaccount.cgi.
Если вас попросят использовать Bugzilla, создайте аккаунт, перейдя по ссылке https://bugzilla.redhat.com/bugzilla/createaccount.cgi.


== Create a Fedora Account ==
== Создание аккаунта Fedora ==


The steps below guide you through the creation of a Fedora Account.
Шаги данного руководства помогут вам создать учетную запись в Fedora.


=== Applying for an Account ===
=== Получение аккаунта ===


# To sign up for a Fedora account, first visit https://admin.fedoraproject.org/accounts and select New Account.
# Чтобы получить аккаунт Fedora, для начала зайдите на https://admin.fedoraproject.org/accounts и нажмите New Account.
# Fill in Username, Full Name and Email, and click Sign up!. Your password will be emailed to you.
# Заполните поля Username, Full Name и Email и нажмите Sign up!. Ваш пароль будет выслан вам по почте.
# Go back to https://admin.fedoraproject.org/accounts and log in with your password. The welcome page will be displayed, and it reminds you that CLA is not completed.<!-- and that an SSH key is not submitted.
# Возвращайтесь на https://admin.fedoraproject.org/accounts и войдите, используя ваш пароль. Вы увидите приветственную страницу и напоминание о том, что вам нужно выполнить CLA.<!-- and that an SSH key is not submitted.
# To submit public SSH key and GPG key ID, click My Account or go to https://admin.fedoraproject.org/accounts/user/edit.
# Чтобы загрузить публичный SSH-ключ и ID GPG-ключа, выберите в меню пунтк My Account или перейдите по ссылке https://admin.fedoraproject.org/accounts/user/edit.
# In the Edit Account (user_name) page, enter your GPG key ID in GPG Key ID: field. For the public SSH key, click Browse... button located next to Public SSH Key: field and specify your public SSH key.-->
# На странице редактирования учетной записи (user_name), введите ID вашего GPG-ключа в соответствующем поле. Для публичного SSH-ключа нажмите кнопку Browse..., расположенную рядом с полем Public SSH Key: и выберите ваш SSH-ключ.-->
# Telephone Number and Postal Address fields are also required to fill in for signing the CLA. These information is NOT accessible by others except admin groups. Please refer to Fedora Privacy Policy at https://fedoraproject.org/wiki/Legal:PrivacyPolicy.
# Поля с номером телефона и почтовым адресом являются обязательными для подписания CLA. Эта информация НЕ является публичной и доступна только администраторам. Пожалуйста, ознакомьтесь с Порядком работы с конфиденциальной информацией в Fedora по адресу https://fedoraproject.org/wiki/Legal:PrivacyPolicy.
# Other fields will be displayed by any other member by visiting the user's view page.
# Другие поля не будут отображаться для других пользователей, зашедших на вашу страницу.
# Now click Save! located at the bottom of this page to save your information.
# Нажмите кнопку Save!, расположенную внизу страницы, чтобы сохранить информацию.


=== Signing the CLA ===
=== Подписание CLA ===


You must complete the Contributors License Agreement, or CLA.
Вы должны выполнить Лицензионное соглашение участника (Contributors License Agreement или CLA).


# Visit https://admin.fedoraproject.org/accounts and login your account using your user name and password obtained from the previous process.
# Зайдите на https://admin.fedoraproject.org/accounts и войдите под своим логином, который вы получили ранее.
# In the Welcome page, click complete the CLA or go to https://admin.fedoraproject.org/accounts/user/edit.
# На приветственной странице  нажмите "complete the CLA" или перейдите по ссылке https://admin.fedoraproject.org/accounts/user/edit.
# If the information of telephone number and postal address have not been provided yet, the Edit Account (user_name) page will be appeared. Otherwise Fedora Contributor License Agreement page will be displayed. Read through the agreement carefully and click I agree if you are happy to do so.
# Если вы еще не предоставили информацию о вашем телефоне или почтовом индексе, то появится страница Edit Account (user_name). Иначе, появится страница Fedora Contributor License Agreement. Внимательно прочитайте соглашение и нажмите "I agree", если согласны.
# The user-view page is appeared and shows the CLA: field as CLA Done.
# Появится страница user-view поле CLA: будет выглядеть как "CLA Done".


= Translating =
=== Перевод ===


The translatable part of a software package is available in one or more PO files. Some projects might use other file formats as well, such as QT TS ones. These files may be maintained in any of a number of version control systems (VCSs) depending on the project, such as Subversion, Mercurial, and git. They may be hosted on either fedorahosted.org or other systems.
Переводимая часть менеджера пакетов доступна в одном илли нескольких PO-файлах. Некоторые проекты могут использовать и другие форматы файлов, также хорошо как QT TS. Эти файлы могут храниться в любой из нескольких систем контроля версий (VCS) в зависимости от проектов, таких как Subversion, Mercurial, или git. Они могут быть размещены либо на fedorahosted.org, либо в других системах.


This chapter explains how to translate the projects which use Transifex to manage their L10n workflow. Translators can work on the web interface or the command-line to obtain and submit files. Before you start, you must first prepare the directories which hold your po files.
В этой главе объясняется, как переводить проекты, использующие Transifex для управления рабочим процессом L10n. Переводчики могут работать через веб-интерфейс или командную строку для получения и отправки файлов. Прежде чем начать, вы должны сначала подготовить каталоги, в которых хранятся ваши PO-файлы.


{{Admon/note | Fedora and Upstream projects | Using Transifex, you can contribute to both Fedora and Upstream projects. Fedora ones are those which Fedora is upstream for, ie. maintaining and handling. These are usually only used by Fedora.}}
{{Admon/note | Fedora and Upstream projects | Using Transifex, you can contribute to both Fedora and Upstream projects. Fedora ones are those which Fedora is upstream for, ie. maintaining and handling. These are usually only used by Fedora.}}
Line 202: Line 205:


  LANG=ja_JP.UTF-8 system-config-printer
  LANG=ja_JP.UTF-8 system-config-printer


= Translating Documentation =
= Translating Documentation =
Line 295: Line 296:
** These '''do not include''' missing Fedora projects, Fedora team creation requests, Fedora coordinators etc.
** These '''do not include''' missing Fedora projects, Fedora team creation requests, Fedora coordinators etc.


* Issues '''specific to Fedora L10n''' should be first reported on IRC channel {{fpchat|#fedora-l10n}} and then on the trans-XX mailing list.(Replace trans-XX with your L10N team's maillist name.Seek your team's name at: [[L10N_Teams|L10N Teams]] page.)
* Issues '''specific to Fedora L10n''' should be first reported on Matrix channel {{matrix|#l10n:fedoraproject.org}} and then on the trans-XX mailing list.(Replace trans-XX with your L10N team's maillist name.Seek your team's name at: [[L10N_Teams|L10N Teams]] page.)
** These include team questions, releases, projects, Fedora maintainers, developers etc.
** These include team questions, releases, projects, Fedora maintainers, developers etc.
** These do NOT include questions Transifex bugs, feature requests, problems you are having with the site, such as a slow webpage, login issues, or wrong statistics because a project is missing from the release.
** These do NOT include questions Transifex bugs, feature requests, problems you are having with the site, such as a slow webpage, login issues, or wrong statistics because a project is missing from the release.

Latest revision as of 21:03, 30 July 2024

Руководство по локализации Fedora (UNDER CONSTRUCTION)

Введение

Это руководство содержит быстрые и простые пошаговые инструкции по переводу программного обеспечения и документации в проекте Fedora. Вы можете найти часто задаваемые вопросы в конце страницы.

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

Сайтом проекта локализации Fedora является https://fedora.zanata.org/.

Получение помощи

Если у вас есть вопросы, задавайте их в рассылке trans или просите помощи на irc.freenode.org на канале #fedora-l10n.

Как стать переводчиком Fedora

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

  1. Создайте аккаунт в Zanata
  2. Подпишитесь на почтовые рассылки
  3. Представьтесь
  4. Присоединитесь к команде переводчиков Fedora

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

Знакомство с Transifex

Fedora использует Transifex Zanata для управления процессами по локализации. Следующие шаги помогут вам в создании аккаунта на Transifex и присоединении к команде.

http://fedora.transifex.net/

Создание аккаунта в Transifex

  1. Зайдите на страницу https://fedora.transifex.net/ и нажмите в верхнем правом углу "Register"
  2. Заполните форму и нажмите Register! Вы можете использвать свой Fedora email или тот же email, который вы использовали при создании аккаунта Fedora. Выберите хороший пароль (как описано выше). Помните, что этот пароль может быть восстановлен, если вы его забудите.
  3. Проверьте вашу почту. Вскоре после регистрации должно прийти письмо для подтверждения вашего email-адреса. В нем будет ссылка — перейдите по ней!
  4. Теперь вы можете зайти на Transifex под вашей учетной записью.

Вступление в группу переводчиков Fedora

  1. Зайдите на страницу Languages в Zanata.
  2. Выберите русский язык и нажмите на него.
  3. Вы увидите список участников и координатора. Нажмите "Join this team", чтобы отправить запрос на присоединение.
  4. Координатор получит письмо с уведомлением о вашем запросе. Он проверит вашу информацию и представились ли вы в рассылке.
  5. Если все в порялке, координатор одобрит ваш запрос на вступление и вы получите уведомление.

Это может занять несколько часов или дней. Если прошло больше, нажмите на имя координатора в Transifex и отправьте ему личное сообщение для получения информации.

Подпишитесь на почтовую рассылку

  1. Зайдите на trans и подпишитесь в основной рассылке переводчиков.
  2. Дождитесь письма со ссылкой для подтверждения вашей подписки. Перейдите по ссылке для подтверждения.
  3. Аналогично подпишитесь на русскоязычную рассылку trans-ru.

Представьтесь

  1. Создайте личную страницу, следуя руководству. Это очень полезно, т.к. другим участникам Fedora будет легче найти информацию о вас и связаться с вами. Для этого вам необходимо создать аккаунт Fedora.
  2. Отправьте короткое письмо с информацией о себе в основную и русскоязычную рассылки, следуя инструкции. Пожалуйста, помните, что нужно указать ваше имя в FAS и ваш язык. По этой информации координатор вашей команды сможет отследить вас и одобрить ваш запрос на присоединение к команде.

Создание аккаунта в Bugzilla

Если вас попросят использовать Bugzilla, создайте аккаунт, перейдя по ссылке https://bugzilla.redhat.com/bugzilla/createaccount.cgi.

Создание аккаунта Fedora

Шаги данного руководства помогут вам создать учетную запись в Fedora.

Получение аккаунта

  1. Чтобы получить аккаунт Fedora, для начала зайдите на https://admin.fedoraproject.org/accounts и нажмите New Account.
  2. Заполните поля Username, Full Name и Email и нажмите Sign up!. Ваш пароль будет выслан вам по почте.
  3. Возвращайтесь на https://admin.fedoraproject.org/accounts и войдите, используя ваш пароль. Вы увидите приветственную страницу и напоминание о том, что вам нужно выполнить CLA.
  4. Поля с номером телефона и почтовым адресом являются обязательными для подписания CLA. Эта информация НЕ является публичной и доступна только администраторам. Пожалуйста, ознакомьтесь с Порядком работы с конфиденциальной информацией в Fedora по адресу https://fedoraproject.org/wiki/Legal:PrivacyPolicy.
  5. Другие поля не будут отображаться для других пользователей, зашедших на вашу страницу.
  6. Нажмите кнопку Save!, расположенную внизу страницы, чтобы сохранить информацию.

Подписание CLA

Вы должны выполнить Лицензионное соглашение участника (Contributors License Agreement или CLA).

  1. Зайдите на https://admin.fedoraproject.org/accounts и войдите под своим логином, который вы получили ранее.
  2. На приветственной странице нажмите "complete the CLA" или перейдите по ссылке https://admin.fedoraproject.org/accounts/user/edit.
  3. Если вы еще не предоставили информацию о вашем телефоне или почтовом индексе, то появится страница Edit Account (user_name). Иначе, появится страница Fedora Contributor License Agreement. Внимательно прочитайте соглашение и нажмите "I agree", если согласны.
  4. Появится страница user-view поле CLA: будет выглядеть как "CLA Done".

Перевод

Переводимая часть менеджера пакетов доступна в одном илли нескольких PO-файлах. Некоторые проекты могут использовать и другие форматы файлов, также хорошо как QT TS. Эти файлы могут храниться в любой из нескольких систем контроля версий (VCS) в зависимости от проектов, таких как Subversion, Mercurial, или git. Они могут быть размещены либо на fedorahosted.org, либо в других системах.

В этой главе объясняется, как переводить проекты, использующие Transifex для управления рабочим процессом L10n. Переводчики могут работать через веб-интерфейс или командную строку для получения и отправки файлов. Прежде чем начать, вы должны сначала подготовить каталоги, в которых хранятся ваши PO-файлы.

Fedora and Upstream projects
Using Transifex, you can contribute to both Fedora and Upstream projects. Fedora ones are those which Fedora is upstream for, ie. maintaining and handling. These are usually only used by Fedora.

Listing Translatable Fedora Projects

Not all projects are there
A cleaning is on the way, you could help. Some projects are not there, some other in any release, some dead…. We should sort them and explain the difference between sourcing the Fedora Project teams and the others
  1. Visit https://www.transifex.net/projects/p/fedora/.
  2. Choose the type of Fedora Projects you want to translate by choosing the appropriate Release. You should see Fedora itself, Fedora Documentation and other upstream projects. Click on the release you choose to contribute to. For example, click on the link pointing to https://www.transifex.net/projects/p/fedora/r/fedora-15/l/ja/.
  3. The new page shows the full statistics for this release per language. Choose your language.
  4. This page shows all translatable resources (ie. files) for this release. Click on one of the table rows to get information on the resource you're interested in.

You can bookmark this page for future reference. We'll call it the "Language-Release" page from now on. Here's an example URL:

https://www.transifex.net/projects/p/fedora/r/fedora-15/l/ja/


image


image

Translate Online

The easiest way to translate is by using the Transifex Web Editor. It's an intuitive interface which does not require you to download files on your system and re-upload them back.

  1. Follow the instructions above to locate the resource which interests you.
  2. On the popup, you should see a "Translate Now" button. If you are logged-in on Transifex and a member of the language team, it should be clickable. Click it!
  3. You should now be in the Transifex Web editor (codenamed Lotte). Go on and translate as much as you want, and at the end, click "Save and Exit".


Note: When you translate online, the file is automatically "Locked" and other people are notified about your work. Never translate something that another translator has already locked -- you might be overwriting his own work!


image


Translating Offline

If you prefer to translate offline, you can simply download & upload a translation file.

Before you download any files, we suggest you prepare a directory to hold your files. The described structure below is an example only, and your structure can be formed differently.

mkdir -p ~/fedora-translations/

Obtaining and Translating Projects

You can download a file to translate. You may need to communicate with other translators in your language team to avoid conflict. If you are not sure, please contact your language coordinator. Also locking a file will avoid potential conflicts.

  1. On your Release-Language page find the resource (table row) you want to translate and click on it for the popup to appear.
  2. Click on "Download for translation" button to download the file as the name of your choice to the directory you created in the previous section (e.g. abrt.po).
  3. Now the file is on your local workstation and ready for translation. Translate the file into your language eg. with a POeditor of your choice such as Lokalize or gtranslator.
  4. Check the integrity of your file before commit using msgfmt -cvo /dev/null abrt.po. If any error messages appear, correct it before commit.

Please note that all files offered from Transifex are already merged (msgmerged) with the POT files. This happens both when you download and when you upload files.


Committing Projects

Once you finish translation work, commit the file using the same interface.

  1. Make sure you are logged in on Transifex.
  2. Navigate back to your Release-Language page and click on the resource you want to upload to. Be careful not to upload on a different resource.
  3. Click on the "Upload" button and locate your translated file on your local system, and Submit it. The interface might take some time (for large files up to one minute) and finally notify you that the file was submitted successfully. If you receive an error or some other message, please post it to the Fedora Localization Project mailing list so it can be addressed.

Adding New files

If one of the resources in the release is missing your translation, you should see it missing from the release page, and see a separate list at the bottom of the page as follows:

The following resources don't have any translations in Japanese:
1) python-fedora → python-fedora.pot
  1. Click on it -- it will take you to that resource's main page.
  2. Click "Add Translation"
  3. Choose your language and click "Translate Online".
  4. Go ahead and translate online a few or all the strings, and then "Save and Exit".


Proofreading Software Translations

Since Fedora 12, the composed live image has been available to download for reviewing and correcting software translation in user interface. This live image is composed around a week before Fedora Software Translation Deadline and made available by deadline date. This image should include all latest translation submitted at this point.

To proofread your translation as part of the software, follow these steps:

1. Change directory to the package you want to proofread. For example:

 cd ~/myproject/system-config-printer/

2. Convert the po file to a mo file using msgfmt with -o option:

msgfmt -o system-config-printer.mo ja.po

3. Back up the existing file and overwrite old one.

su -
cp /usr/share/locale/ja/LC_MESSAGES/system-config-printer.mo system-config-printer.mo-backup
mv system-config-printer.mo /usr/share/locale/ja/LC_MESSAGES/
exit

4. Proofread the package with the translated strings as part of the application. The application related to the translated package runs with the translated strings.

LANG=ja_JP.UTF-8 system-config-printer

Translating Documentation

Translating Fedora docs is exactly the same as translating software, so just follow the same instructions as above. Make sure you select the "Fedora Documentation" Release, which will lead you to a separate Release-Language page, specialized in Docs.

Example:

https://fedora.transifex.net/projects/p/fedora/r/fedora-docs/

Understanding the Multiple Files Structure

Fedora Docs mostly use Publican. Unlike software, a guide has multiple po files structure. Each file corresponds to each chapter in that guide. The file name usually consists of the chapter name. This structure is very useful as more than one translator can work on certain guide same time.

New languages: Creating docbook-locales File

If you are creating the first-ever translation for a locale, you must first translate docbook-locales file used in all documents for your locale.

  1. Navigate to the docbook-locales Transifex project: https://www.transifex.net/projects/p/fedora-docbook-locales/resource/locale/
  2. If your language is not there, just add it.
  3. File a bug in Bugzilla against Product "Fedora Documentation" with Component "docs-requests". You may leave the details blank, or name the guide name(s) which you like to translate. Attach Files if Necessary. If you have any problems submitting po files using above instructions, you can attach it to the bug.
  4. Use the following Summary on the bug: "[ja]: New language support request."

Publishing Docs

When your doc translation is ready to be published on the Fedora Documentation website, make a formal request for publishing the translation by following these steps:

  1. File a bug against the publishing-requests component of the Fedora Documentation product in Bugzilla. In the description field, remember to mention the document name and language version you want to publish. If you wish to publish multiple documents at once, file a separate bug for each of the documents.
  2. Members of the docs-publishers FAS group will be notified of your request and will get your translation published. Once the translation gets published, they will close the bug for you.
Alternative way to publish translations
The steps mentioned above don't affect the translation teams that are used to publish their docs translations. Only the translation teams that lack necessary manpower or knowledge to publish docs on the Fedora Documentation website are required to file bugs in Bugzilla to publish their docs translations.
Become a member of the docs-publishers FAS group
If you would like to help out with the publishing process and become a member of the docs-publishers FAS group, contact the Docs Project. To make the whole process faster, translation teams are advised to have at least one member in the docs-publishers FAS group to take care of the team's publishing requests.

What Docs to Translate

The most important documentation for each release of Fedora are the following:

  • docbook-locales
  • Common Content for Publican
  • Publican branding for Fedora
  • Documentation website
  • Release Notes
  • Burning ISOs
  • Live Image

For a full list of Fedora docs available for translation, refer to the Docs Project guides table.

Translating Websites

Fedora Websites are also translatable via Transifex. You can find all projects related to Fedora websites in the Fedora Websites Release:

https://www.transifex.net/projects/p/fedora/r/fedora-websites/

Translate website projects the same way as for software projects. Please note that new translations are actually pulled hourly in order to rebuild all websites. But POTs are updated manually. If you've your file 100% translated but still see some English strings on the website, please report to the Websites team by opening a Trac ticket.

Adding New po Files

Add new po files the same as for software projects. If you are creating the first-ever translation for a locale, you must notify the Fedora Websites team to add the new language to the website. Post the request to the websites mailing list or using the Trac instance, so that the Websites team can add the language to the Apache configuration for the site.

Proofreading

Generally the Websites team provides test sites that you can use to proofread your work.

Translating Wiki Pages

Please refer to Translating page to see the details of translating the wiki pages.

FAQ (Frequently Asked Questions)

Here are some FAQs about the Localization Project.

Should I translate legal notices?

No. You must never do that. The exact wording of the legal notices is very important and a translation not approved by lawyers is very risky. Red Hat is the legal representative and primary sponsor of the Fedora Project and does not have the resources to cross check every single translation. Just leave the original English notice in tact when it covers legal matters.

How do I report issues?

Before reporting (either opening a new ticket or the list), please search to see if there's an existing report opened. It sometimes help to ask in #fedora-l10n if there's a known issue at that exact moment. If not, please open a ticket describing what's wrong with the service in clarity. Include the nature of the problem, the project/resource, the time (in UTC) it happened and your Fedora username. If you suspect it might be a problem with the particular file you are uploading or the target file, include that information as well.


Where do I report issues?

  • Issues specific to Transifex should be reported using the "Feedback" button on the right-side of the website.
    • These include: Questions related to Transifex, possible bugs, feature requests, problems you are having with the site, such as a slow webpage, login issues.
    • These do not include missing Fedora projects, Fedora team creation requests, Fedora coordinators etc.
  • Issues specific to Fedora L10n should be first reported on Matrix channel #l10n:fedoraproject.org(other clients|?) and then on the trans-XX mailing list.(Replace trans-XX with your L10N team's maillist name.Seek your team's name at: L10N Teams page.)
    • These include team questions, releases, projects, Fedora maintainers, developers etc.
    • These do NOT include questions Transifex bugs, feature requests, problems you are having with the site, such as a slow webpage, login issues, or wrong statistics because a project is missing from the release.

Where do I report feature requests?

Please see above section, 'issues specific to Transifex'.


How do I create a new team? (#new-team)

See L10N Maintainer on how to become a maintainer of a new language.


My file is 100% but when I test the application I still see English strings! (#missing-strings)

This wasn't a question, by the way. Nevermind. The following might have gone wrong:

  • The strings in question have not been marked for translation by the developer, hence they haven't been included in the POT file, and thus not in the PO file. He needs to use gettext on them.
  • The source files of these strings have not been marked for inclusion, in the intltool case.
  • The POT file of Transifex is not up to date. The component page includes the date when the POT file has been produced. If this is more than a few hours in the past, please notify the admins, otherwise it should be OK.

Are the statistics live? How often are they updated? (#update-frequency)

The statistics on Transifex are always live on the project pages. The Release pages are updated once per day.


How do I add a module to Transifex? (#add-transifex)

  1. Navigate to https://www.transifex.net/projects/add/
  2. Follow the instructions from http://help.transifex.net/intro/projects.html

If you want the Fedora Localization Project to handle your translations (i.e. you are NOT an upstream project):

  1. Click 'Access Control' on your Project Details Page
  2. Outsource team control to "The Fedora Project"
  3. Send an email to fedora-trans-list and let the contributors know about the change. One of the Fedora L10n Editors will add your project to one of the Fedora releases.

http://fedora.transifex.net/


Here are two more pages you might want to read:


I'm a developer, how can I make .desktop files translatable?

Transifex will natively support .desktop files soon.

I can't find "About this Computer" string. Where is it?

It can be found at AboutThisComputer.

Is the section of export regulations shown at the bottom of the fedoraproject.org/get-fedora page translatable?

No. This is purposely set up as non-translatable. Please refer to Non-translatable export regulations?.

If some strings change past string freeze, how do I request a string freeze breakage?

Email the trans mailing list!

What if I overwrite a wrong file?

If you have overwritten a wrong file in your own locale, try to find the old file on the developer's git repo (http://git.fedorahosted.org/git/) and replace the wrongly updated file with this file.

Even though these are measures to correct mistake, we strongly advice you to take extra care while submitting the translations via Transifex and make sure that you are uploading file in proper location under proper locale because some projects don't keep translation files under their CVS tree (do I say "Anaconda" ? oO)

I'm from the Docs Project. How do I make my Guide / Release Notes / other document available for translation?

If you keep you document in a git repository, see Setting up a document with Transifex to find out how to make it available to translators on Transifex.net.

Guide information

The following people have contributed to this guide:

  • Manuel Ospina
  • Paul W. Frields
  • Noriko Mizumoto
  • Dimitris Glezos
  • Diego Búrigo Zacarão
  • Piotr Drąg
  • Misha Shnurapet
  • Petr Kovar