переклад dtdocs

Переклад документації darktable здійснюється через наш екземпляр Weblate.

Ви можете використовувати веб-інтерфейс Weblate для перекладу документації або завантажити переклад з Weblate на свій комп’ютер, відредагувати його, а потім вивантажити зміни.

Будь ласка, виконуйте всі роботи з перекладу через Weblate. Ми не будемо приймати запити на прийняття змін (pull request) безпосередньо на github для оновлення PO-файлів.

🔗Створення нової гілки в git

  1. Створіть нову гілку, щоб працювати над нею в git. Наприклад: git checkout -b fr-translation-init

🔗Додавання нової мови в Hugo

  1. У файлах config.yaml та config-pdf.yaml знайдіть рядок languages:.

  2. Додайте мову, на яку хочете перекласти. Наприклад, англійська виглядає так:

      en-us:
        title: darktable 3.4 user manual
        weight: 1
    
  3. Збережіть файли.

🔗Створення файлу PO

Виконайте наступні кроки, якщо ви хочете оновити файли POT та PO з джерела markdown.

  1. Створіть порожній файл PO для вашої мови в папці po з назвою файлу content.<мова>.po. Наприклад: touch po/content.fr-fr.po

  2. Запустіть сценарій для заповнення PO-файлу: cd tools/ && ./generate-translations.sh --no-translations

🔗Створення перекладених файлів

Виконайте наступні кроки для створення файлів веб-сайту із перекладу.

  1. Створіть перекладені файли: cd tools/ && ./generate-translations.sh --no-update.

  2. Перевірте переклад, запустивши внутрішній сервер hugo: hugo server

  3. Відкрийте веб-браузер і перевірте зміни. URL-адреса міститься на виході команди hugo server.

  4. Видаліть перекладені файли, оскільки ми ніколи не заносимо їх у git: cd tools/ && ./generate-translations.sh --rm-translations.

🔗Переклад рядків веб-сайту та PDF

Існує дві теми для документації darktable: одна для веб-сайту HTML та одна для PDF. Вам потрібно буде перекласти рядки для обох.

  1. Перейдіть до themes/hugo-darktable-docs-themes/i18n.

  2. Скопіюйте вміст файлу en.yaml та назвіть новий файл<ваша мова>.yaml.

  3. Перекладіть вміст нового файлу yaml.

  4. Внесіть перекладений файл PO в git, опублікуйте його на github і відкрийте запит на витяг (pull request), щоб ваші зміни були прийняті.

  5. Повторіть останні чотири кроки для іншої теми, themes/hugo-darktable-docs-pdf-theme.

translations