tłumaczenie dtdocs

Tłumaczenie darktable tworzone jest przez naszą instancję Weblate.

Możesz użyć interfejsu internetowego Weblate do przetłumaczenia dokumentacji lub pobrać tłumaczenie z Weblate na swój komputer, edytować je, a następnie przesłać zmiany.

Prosimy o tworzenie wszystkich tłumaczeń w Weblate. Nie będziemy akceptować pull requestów na githubie dla poprawek plików PO.

🔗Tworzenie nowej gałęzi gita

  1. Utwórz nową gałąź do pracy z git. Na przykład: git checkout -b pl-translation-init

🔗Dodawanie nowego języka do Hugo

  1. W plikach config.yaml oraz config-pdf.yaml znajdź linie languages:.

  2. Dodaj język, który chcesz tłumaczyć. Przykładowy wpis dla języka angielskiego wygląda tak:

      en-us:

title: darktable 3.4 user manual weight: 1


3. Zapisz pliki.


# Tworzenie pliku PO

Wykonaj następujące kroki, jeśli chcesz zaktualizować pliki POT i PO ze źródła markdown.

1. Utwórz pusty plik PO dla swojego języka w folderze `po` o nazwie `content.<język>.po`.
Na przykład:
`touch po/content.fr-fr.po`

2. Uruchom skrypt, aby wypełnić plik PO:
`cd tools/ && ./generate-translations.sh --no-translations`


# Generowanie przetłumaczonych plików

Wykonaj następujące kroki, aby wygenerować pliki serwisu z tłumaczenia.

1. Wygeneruj przetłumaczone pliki:
`cd tools/ && ./generate-translations.sh --no-update`.

2. Sprawdź tłumaczenie, uruchamiając wewnętrzny serwer hugo:
`hugo server`

3. Otwórz przeglądarkę internetową i sprawdź zmiany. Adres URL znajduje się w danych wyjściowych polecenia `hugo server`.

4. Usuń przetłumaczone pliki, ponieważ nigdy nie sprawdzamy ich w git:
`cd tools/ && ./generate-translations.sh --rm-translations`.


# Tłumaczenie strony internetowej, epub oraz łańcuchów PDF

Istnieją dwa motywy dokumentacji darktable: jeden dla strony HTML i jeden dla pliku PDF. Będziesz musiał przetłumaczyć ciągi dla obu.

1. Przejdź do `themes/hugo-darktable-docs-themes/i18n`.

2. Skopiuj zawartość pliku `en.yaml` i nazwij nowy plik `<twój język>.yaml`.

3. Przetłumacz zawartość nowego pliku yaml.

4. Sprawdź przetłumaczony plik PO w git, wypchnij go na github i otwórz pull request, aby zmiany zostały zaakceptowane.

5. Powtórz ostatnie cztery kroki dla innych tematów, `themes/hugo-darktable-docs-epub-theme` oraz `themes/hugo-darktable-docs-pdf-theme`.


# Integracja nowych tłumaczeń z Weblate

Poniżej założono, że katalog roboczy git jest czysty, że masz dostęp API do instancji Weblate, że skonfigurowałeś repozytorium git Weblate jako zdalne w lokalnym repozytorium git `dtdocs` i że `wlc`, klient wiersza poleceń Weblate jest skonfigurowany.

1. Zatwierdź wszelkie zmiany w Weblate: `wlc commit darktable/dtdocs`

2. Zablokuj projekt Weblate, aby zapobiec dalszym zmianom: `wlc lock darktable/dtdocs`

3. W lokalnym repozytorium git `dtdocs` utwórz nową gałąź: `git checkout -b po-updates`

4. Zaktualizuj zdalny Weblate: `git remote update weblate`

5. Połącz zmiany Weblate z lokalnie stworzoną gałęzią: `git merge weblate/master`

6. Wykonaj squash wszystkich commitów Weblate, ponieważ jest ich tak wiele: `git reset $(git merge-base master $(git rev-parse --abbrev-ref HEAD))`

7. Dodaj zmienione pliki PO: `git add -A`

8. Zatwierdź pliki `PO`: `git commit -m "Updated with the PO files from weblate."`

9. Zaktualizuj pliki `POT` i `PO`: `cd tools/ && ./generate-translations.sh --no-translations && cd ..`

10. Przygotuj pliki `POT` i `PO`: `git add -A`

11. Zatwierdź pliki `POT` i `PO`: `git commit -m "Updated POT and PO files."`

12. Utwórz pull request w serwisie Github.

13. Po zaakceptowaniu pull requesta zresetuj repozytorium Weblate tak, aby odpowiadało repozytorium `dtdocs`: `wlc reset darktable/dtdocs`

translations