Update documentation on main branch.
This commit is contained in:
@ -1,10 +1,60 @@
|
||||
+++
|
||||
title="Document"
|
||||
description="Documenter the plugin, or translate the documentation."
|
||||
title="Dokumentation"
|
||||
description="Dokumentieren Sie das Plugin, oder übersetzen Sie die Dokumentation."
|
||||
weight=50
|
||||
chapter=false
|
||||
+++
|
||||
|
||||
{{% notice warning %}}
|
||||
This page is not yet translated in your language, please refer to the english version. You can switch to it by using the language selector in the left menu.
|
||||
{{% /notice %}}
|
||||
## 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 `develop`-Zweig. Der `main`-Zweig ist für veröffentlichte Versionen des Plugins reserviert, so dass die Dokumentation immer mit der veröffentlichten Version des Plugins synchronisiert ist.
|
||||
|
||||
Der Quellcode der Dokumentation befindet sich im Ordner `support/documentation/content`.
|
||||
|
||||
Die Dokumentation wird mit [Hugo](https://gohugo.io/) erstellt.
|
||||
Sie müssen es auf Ihrem Computer installieren, wenn Sie eine Vorschau Ihrer Arbeit sehen wollen.
|
||||
|
||||
Das verwendete Thema ist [hugo-theme-learn](https://learn.netlify.app/).
|
||||
Sie sollten dessen Dokumentation lesen, bevor Sie mit der Bearbeitung der Dokumentation beginnen.
|
||||
|
||||
## Übersätzungen
|
||||
|
||||
Die Hauptsprache ist Englisch (Code `en`).
|
||||
|
||||
Die verschiedenen Übersetzungen der gleichen Datei stehen nebeneinander im Verzeichnis und sind durch einen Sprachcode in der Dateinamenerweiterung gekennzeichnet.
|
||||
Beispiel: `_index.fr.md` ist die französische Übersetzung von `_index.en.md`.
|
||||
|
||||
Bitte beachten Sie, dass eine fehlende Übersetzungsdatei nicht in den Menüs der generierten Website erscheint.
|
||||
|
||||
**Stellen Sie sicher, dass Sie immer alle Dateien für die Sprachen erstellen**, auch wenn die Übersetzung noch nicht verfügbar ist.
|
||||
|
||||
Dafür gibt es ein Skript `doc-generate-missing-translations.sh` im Stammverzeichnis des Projektes. Wenn Sie eine neue Datei hinzufügen, müssen Sie nur die englische Version erstellen und dann dieses Skript ausführen. Es erstellt alle fehlenden Übersetzungen und fügt eine Beispielmeldung hinzu, die den Benutzer auffordert, die englische Version zu lesen.
|
||||
|
||||
## Eine neue Sprache hinzufügen
|
||||
|
||||
Kopieren und ändern Sie den Abschnitt `[Languages.fr]` in der Datei `support/documentation/config.toml`.
|
||||
|
||||
Führen Sie dann das Skript `doc-generate-missing-translations.sh` aus.
|
||||
Es wird alle fehlenden Dateien erstellen.
|
||||
|
||||
Dann können Sie sie eine Datei nach der anderen übersetzen.
|
||||
Wenn die Übersetzungen nicht vollständig sind, macht das nichts, die generierten Dateien zeigen eine Meldung an, die vorschlägt, die Sprache zu ändern.
|
||||
|
||||
## Vorschau
|
||||
|
||||
Um eine Vorschau Ihrer Änderungen zu sehen, führen Sie einfach diesen Befehl aus:
|
||||
|
||||
```bash
|
||||
hugo serve -s support/documentation/
|
||||
```
|
||||
|
||||
Öffnen Sie dann Ihren Browser und gehen Sie auf die Adresse
|
||||
[http://localhost:1313/peertube-plugin-livechat/](http://localhost:1313/peertube-plugin-livechat/).
|
||||
Diese Seite wird bei jeder Änderung automatisch aktualisiert.
|
||||
|
||||
## Veröffentlichung
|
||||
|
||||
Die Veröffentlichung der Dokumentation erfolgt automatisch, sobald die Änderungen in den `main` Zweig eingefügt wurden.
|
||||
|
@ -5,7 +5,7 @@ weight=50
|
||||
chapter=false
|
||||
+++
|
||||
|
||||
## General informatiosn
|
||||
## General information
|
||||
|
||||
Always inform the community before working (by creating a new issue, or commenting an existing one). This is to avoid that two persons are
|
||||
working on the same thing, and prevent conflicts.
|
||||
|
Reference in New Issue
Block a user