переклад dtdocs
Переклад документації darktable здійснюється через наш екземпляр Weblate.
Ви можете використовувати веб-інтерфейс Weblate для перекладу документації або завантажити переклад з Weblate на свій комп’ютер, відредагувати його, а потім вивантажити зміни.
Будь ласка, виконуйте всі роботи з перекладу через Weblate. Ми не будемо приймати запити на прийняття змін (pull request) безпосередньо на github для оновлення PO-файлів.
🔗Створення нової гілки в git
- Створіть нову гілку, щоб працювати над нею в git.
Наприклад:
git checkout -b fr-translation-init
🔗Додавання нової мови в Hugo
-
У файлах
config.yaml
таconfig-pdf.yaml
знайдіть рядокlanguages:
. -
Додайте мову, на яку хочете перекласти. Наприклад, англійська виглядає так:
en-us: title: darktable 3.4 user manual weight: 1
-
Збережіть файли.
🔗Створення файлу PO
Виконайте наступні кроки, якщо ви хочете оновити файли POT та PO з джерела markdown.
-
Створіть порожній файл PO для вашої мови в папці
po
з назвою файлуcontent.<мова>.po
. Наприклад:touch po/content.fr-fr.po
-
Запустіть сценарій для заповнення PO-файлу:
cd tools/ && ./generate-translations.sh --no-translations
🔗Створення перекладених файлів
Виконайте наступні кроки для створення файлів веб-сайту із перекладу.
-
Створіть перекладені файли:
cd tools/ && ./generate-translations.sh --no-update
. -
Перевірте переклад, запустивши внутрішній сервер hugo:
hugo server
-
Відкрийте веб-браузер і перевірте зміни. URL-адреса міститься на виході команди
hugo server
. -
Видаліть перекладені файли, оскільки ми ніколи не заносимо їх у git:
cd tools/ && ./generate-translations.sh --rm-translations
.
🔗Переклад рядків веб-сайту та PDF
Існує дві теми для документації darktable: одна для веб-сайту HTML та одна для PDF. Вам потрібно буде перекласти рядки для обох.
-
Перейдіть до
themes/hugo-darktable-docs-themes/i18n
. -
Скопіюйте вміст файлу
en.yaml
та назвіть новий файл<ваша мова>.yaml
. -
Перекладіть вміст нового файлу yaml.
-
Внесіть перекладений файл PO в git, опублікуйте його на github і відкрийте запит на витяг (pull request), щоб ваші зміни були прийняті.
-
Повторіть останні чотири кроки для іншої теми,
themes/hugo-darktable-docs-pdf-theme
.