dtdocs übersetzen

Die Übersetzung der Dokumentation von darktable wird mit unserer Weblate Instanz ausgeführt.

Du kannst die Übersetzungsarbeiten der Dokumentation entweder über das Web von Weblate machen, oder die Übersetzung herunterladen, diese editieren und die Änderungen wieder hochladen.

Bitte führe alle Übersetzung-Arbeiten über Weblate. Wir werden keinen Arbeitsablauf direkt auf dem Github für ein direktes Update von PO Dateien akzeptieren.

🔗Erstellen eins neuen Zweiges in git

  1. Erstelle einen neuen Zweig, um daran zu arbeiten, in git. Zum Beispiel: git checkout -b fr-translation-init

🔗Eine neue Sprache zu Hugo hinzufügen

  1. In den Dateien config.yaml und config-pdf.yaml, lokalisiere die languages: Linie.

  2. Füge die Sprache, die du übersetzen willst hinzu, das Englische sieht so aus:

      en-us:

title: darktable 3.4 user manual weight: 1


3. Sichere die Dateien.


# Eine PO Datei generieren

Führe die folgenden Schritte aus, falls du das POT und PO von der Markdown Quelle aufdatieren willst.

1. Kreiere eine leere PO Datei für deine Sprache im Ordner `po` mit dem Datei-Namen `content.<language>.po`.
Zum Beispiel:
`touch po/content.fr-fr.po`

2. Lasse das Script laufen, um die PO Datei zu füllen:
`cd tools/ && ./generate-translations.sh --no-translations`


# Generieren von übersetzten Dateien

Führe die folgenden Schritte aus, um die Wegseiten Dateien einer Übersetzung zu generieren.

1. Generiere die übersetzten Dateien:
`cd tools/ && ./generate-translations.sh --no-update`.

2. Überprüfe die Übersetzung durch Starten des internen Servers von Hugo:
`hugo server`

3. Öffne einen Web-Browser und überprüfe die Änderungen. Die URL ist im Output des `hugo server` Befehls.

4. Entferne die übersetzten Dateien, da wir sie nie prüfen in git:
`cd tools/ && ./generate-translations.sh --rm-translations`.


# Übersetzungs Webseite und PDF Strings

Es gibt zwei Themen-Seiten für die darktable Dokumentation: Eine für die HTML-Webseite und eine für das PDF. Du musst die Strings für beide übersetzen.

1. Gehe zu `themes/hugo-darktable-docs-themes/i18n`.

2. Kopiere den Inhalt der Datei `en.yaml` und benenne die neue Datei `<your language>.yaml`.

3. Übersetze den Inhalt der neuen yaml Datei.

4. Überprüfe die übersetzte PO Datei in git, verschiebe sie in github, und öffne einen Pull Request damit deine Änderungen angenommen werden.

5. Wiederhole die letzten vier Schritte für das andere Theme, `themes/hugo-darktable-docs-pdf-theme`.

translations