Dokumentation

Allgemeine Informationen

Informieren Sie die Community immer vor der Arbeit (indem Sie ein neues Problem erstellen oder ein bestehendes kommentieren). Damit soll vermieden werden, dass zwei Personen an der gleichen Sache arbeiten, und Konflikte zu verhindern.

Bitte benutzen Sie den main-Zweig.

Der Quellcode der Dokumentation befindet sich im Ordner support/documentation/content.

Die Dokumentation wird mit Hugo erstellt. Sie müssen es auf Ihrem Computer installieren, wenn Sie eine Vorschau Ihrer Arbeit sehen wollen.

Die erforderliche Mindestversion für Hugo ist 0.121.0. Es wurde mit Version 0.132.2 getestet.

Das verwendete Thema ist hugo-theme-learn. Sie sollten dessen Dokumentation lesen, bevor Sie mit der Bearbeitung der Dokumentation beginnen.

Wenn eine neue Pluginversion veröffentlicht oder die Dokumentation aktualisiert wird, führen die Plugin Verwalter den main-Zweig mit dem documentation-Zweig zusammen. Dadurch werden Github- und Gitlab-Pipelines ausgelöst und die veröffentlichte Dokumentation aktualisiert.

Übersätzungen

Die Hauptsprache ist Englisch (Code en).

Der Ordner support/documentation/content/en enthält nur englische Dokumentationsdateien.

Die Dokumentation wird mit Weblate übersetzt (siehe die Übersetzungsdokumentation). Um dies zu tun, verwenden wir das po4a tool, wie wir später auf dieser Seite sehen werden.

Eine neue Sprache hinzufügen

Kopieren und ändern Sie den Abschnitt [Languages.fr] in der Datei support/documentation/config.toml.

Wenn die Übersetzungen nicht vollständig sind, macht das nichts, die fehlenden Zeichenfolgen werden auf Englisch angezeigt.

Vorschau

Um eine Vorschau Ihrer Änderungen zu sehen, führen Sie einfach diesen Befehl aus:

hugo serve -s support/documentation/

Öffnen Sie dann Ihren Browser und gehen Sie auf die Adresse http://localhost:1313/peertube-plugin-livechat/. Diese Seite wird bei jeder Änderung automatisch aktualisiert.

Aktualisierung von Lokalisierungsdateien und Erstellung von Dokumentationsübersetzungen

Im Moment haben Sie nur die englische Version. Um die Dokumentationszeichenketten zu aktualisieren und Übersetzungen zu erstellen, müssen Sie das Skript doc-translate.sh ausführen.

Stellen Sie dazu sicher, dass Sie po4a (Version >= 0.69) auf Ihrem Computer installiert haben.

Warnung

Einige Linux-Distributionen (wie Debian Bullseye zum Beispiel) haben eine zu alte Version von po4a. Bitte stellen Sie sicher, dass Sie eine kompatible Version installieren. Wenn Sie zum Beispiel Debian Bullseye benutzen, können Sie die Bookworm po4a.deb Datei von https://packages.debian.org herunterladen und manuell installieren.

Um Übersetzungen zu bearbeiten, machen Sie einfach dies:

npm run doc:translate

Sie können dann eine Vorschau des Ergebnisses mit hugo serve -s support/documentation/ und unter Verwendung der Sprachauswahl anzeigen.

Dokumentation schreiben

Bearbeiten Sie einfach die englischen Dateien in support/documentation/content/en.

Führen Sie dann vor dem Commit immer npm run doc:translate aus, so dass Änderungen in den englischen Dateien in die Datei support/documentation/po/livechat.en.pot übertragen werden können.

Du kannst den Shortcode livechat_label verwenden, um Anwendungsstrings zu verwenden. Siehe hier: Dokumentation übersetzen.

Es ist möglich zu verhindern, dass eine Datei übersetzt wird, indem man livechatnotranslation: true in der Yaml Font Matter Sektion benutzt. Siehe hier: Dokumentation übersetzen.

Bitte verwenden Sie die Option livechatnotranslation für technische Dokumentation. Wir möchten nicht, dass die technische Dokumentation übersetzt wird, um Probleme aufgrund einer falschen Übersetzung zu vermeiden.

Um den Übersetzern die Arbeit zu erleichtern, sollten Sie zu lange Absätze vermeiden.

Im Moment ist es nicht möglich, Markdown-Tabellen zu verwenden: Die Übersetzungswerkzeuge würden sie nicht korrekt darstellen.

Warnung

There may be links to this documentation elsewhere on the web. Try not to change the urls of the documentation pages. Or at the very least, put links to the new location on the previous url.

When a new feature is released, you can use the livechat_version_notice short code to display an infobox with the version with which the features is available. This short code takes the version number as parameter. Here is an example:

Info

Diese Funktion wird mit dem Livechatplugin Version 12.0.0 verfügbar sein.

Was ist, wenn ich hugo und/oder po4a nicht verwenden kann?

Bearbeiten Sie einfach die englischen Markdown-Dateien und geben Sie an, dass Sie keine Übersetzungen erstellen können, wenn Sie Ihren Pull Request stellen.

Veröffentlichung

Die Veröffentlichung der Dokumentation erfolgt automatisch, sobald die Änderungen in den documentation Zweig eingefügt wurden.