From 1693a44d58ab368ce167a95aedce1a3f400f494c Mon Sep 17 00:00:00 2001 From: Hemmho <69148585+Hemmho@users.noreply.github.com> Date: Tue, 4 May 2021 23:43:12 +0200 Subject: [PATCH 1/7] Create write_documentation.de.md --- .../write_documentation.de.md | 148 ++++++++++++++++++ 1 file changed, 148 insertions(+) create mode 100644 pages/04.contribute/02.write_documentation/write_documentation.de.md diff --git a/pages/04.contribute/02.write_documentation/write_documentation.de.md b/pages/04.contribute/02.write_documentation/write_documentation.de.md new file mode 100644 index 00000000..2b7386be --- /dev/null +++ b/pages/04.contribute/02.write_documentation/write_documentation.de.md @@ -0,0 +1,148 @@ +--- +title: Write documentation +template: docs +taxonomy: + category: docs +routes: + default: '/write_documentation' +--- + +## Über GitHub + +Die YunoHost-Dokumentation wird über ein [Git-Repository](https://github.com/YunoHost/doc) verwaltet. + +Wenn Sie mit GitHub nicht vertraut sind, befindet sich oben auf jeder Seite eine Schaltfläche "Edit", mit der Sie zum GitHub-Online-Editor weitergeleitet werden, mit dem Sie Änderungsvorschläge machen können (Pull Requests, PR). + +Wenn Sie sich jedoch in einer Bearbeitungsphase befinden, sollten Sie das Repository forken. Sie können dann alle gewünschten Commits (Änderungen) in Ihrem Fork vornehmen und alle gleichzeitig in dem selben Pull-Requests senden. Die Etikette von GitHub empfiehlt Ihnen, alle damit verbundenen Commits in derselben PR zusammenzufassen. + +Da der Online-Editor das Hochladen von Dateien nicht unterstützt, ist die Verwendung von Git die bevorzugte Methode, wenn Sie Medien (z. B. Bilder) hochladen müssen. + +## Grav + +Unter der Haube wird die Dokumentation vom [Grav CMS](https://getgrav.org/?target=_blank) bereitgestellt. + +Die Struktur des Repositorys wird nachfolgend beschrieben: + +```bash ++ -- config + + -- site.yaml + + -- system.yaml + + -- themes + + -- yunohost-docs.yaml + # Einige Einstellungen für das Dokumentationstheme ++ -- Bilder + # Enthält die auf den Dokumentationsseiten verwendeten Bilder. ++ -- Seiten + # Das Verzeichnis mit den Dokumentationsseiten. + # Die Seitenhierarchie spiegelt sich in der Verzeichnishierarchie wider. + + -- 00.home + + -- 01.administrate + + -- 02.applications + + -- 03.community + + -- 04.contribute ++ -- themes + + -- learn4 + + -- yunohost-docs + # Enthält den Code des Themes, dies erweitert den Code des Learn4-Themes ++ -- .gitignore + # Enthält die Anweisungen, keine sensiblen + # oder nutzlosen Dateien an das Git-Repository zu senden ++ -- README.md +``` + +!!!! Weitere Informationen zu den Funktionen von Grav finden Sie in der [Dokumentation](https://learn.getgrav.org?target=_blank). Der Rest dieser Seite zeigt Ihnen einige spezifische Anweisungen, die Sie zur Dokumentation von YunoHost beachten sollten.. + +## Grav-Header + +Jede Seite beginnt mit einem Header, der Grav Anweisungen zur Verarbeitung gibt. Werfen wir einen Blick in die Kopfzeile dieser Seite: + +``` +--- +Titel: Dokumentation schreiben +template: docs +taxonomie: + Kategorie: docs +routes: + default: '/write_documentation' +--- +``` +1. Die Kopfzeile beginnt und endet mit einer Zeile, die `---` enthält +2. Der "Titel:" verwaltet die erste Titel-Überschrift der Seite, ihren Namen im Navigationsmenü links und den Namen des Browser-Tab's +3. Die Punkte "template" und "taxonomie" sollten immer unverändert bleiben. Sie weisen Grav an, das richtige Theme zu verwenden und die Seiten richtig auf zu bauen. +4. Die Schlüssel "routes" und "default" machen die Seite standardmäßig unter "https: //yunohost.org/docs/write_documentation" verfügbar, um sie nicht unter "https://yunohost.org/docs/contribute/write_documentation" aufrufen zu müssen, wo sie in der Verzeichnishierarchie gespeichert ist. + +## Syntax + +Sie können die Markdown-Syntax verwenden. Weitere Informationen finden Sie in der [Dokumentation](/ doc_markdown_guide). + +! Beachten Sie, dass Sprachcodes nicht am Anfang der Links zu anderen Dokumentationsseiten stehen dürfen: `/en`,` /fr` usw. sind überflüssig. + +Um die Markdown-Funktionen zu verbessern, werden zusätzliche Plugins in Grav installiert. In der eigenen Dokumentation zu GitHub erfahren Sie, wie Sie sie verwenden. +``` +Textanker +external_links +flex-Objekte +Highlight +Bildbeschriftungen +Abschlags-Mitteilungen +Präsentation +Präsentations deckset +Shortcode -Kern +``` + +## Sonderseiten + +Einige Seiten der Dokumentation werden automatisch oder dynamisch generiert. + +| Seite | Pfad | Anmerkungen | +| --------------- | ------- | ------- | +| Apps-Katalog | `/pages/02.applications/01.catalog/apps.md` | Ruft [app.json] ab und verarbeitet sie (https://github.com/YunoHost/apps/blob/master/apps.json?target=_blank) | +| Apps-Helfer | `pages/04.contribute/04.packaging_apps/11.helpers/package_apps_helpers.md` | Erstellt von diesem [Skript] (https://github.com/YunoHost/yunohost/blob/dev/doc/generate_helper_doc.py?target=_blank) aus dieser [Vorlage](https://github.com/YunoHost/). yunohost/blob/dev/doc/helper_doc_template.md?target=_blank) | +| Pro-App-Dokumentation | `pages/02.applications/02.docs/docs.md` | Listet die Unterseiten im selben Verzeichnis auf, deren Header "taxonomy.category: docs, apps" enthält + +## Hosten Sie Ihre eigene Testdokumentation + +! Diese Anweisungen müssen noch vollständig getestet werden. Bitte helfen Sie uns, indem Sie Probleme melden, die Sie möglicherweise mit ihnen haben. + +0. Fork YunoHost Dokumentation Repository +1. YunoHost Pakets Grav installieren: `yunohost App installieren grav` +2. Installieren Sie die folgenden Plugins durch Grav des Admin-Panel oder CLI: +``` +anchors +breadcrumbs +external_links +feed +flex-objects +git-sync +highlight +image-captions +langswitcher +markdown-notices +presentation +presentation-deckset +shortcode-core +tntsearch +``` +3. Git Sync Plugin einrichten . + 1. Wählen Sie GitHub und Ihre Anmeldeinformationen auf GitHub + 2. Legen Sie das Repo fest, z. B. "https://github.com/username/doc". + 3. Kopieren Sie die URL des Webhooks, z. B. "https://grav.example/_git-sync-ca25c111f0de". + 4. Grundeinstellungen> Ordner in Synchronisieren: `Seiten`` Bilder` `Themen` + 5. Git Repo-Einstellungen> Benutzer nicht erforderlich: Aktiviert + 6. Git Repo-Einstellungen> Web Hooks-Geheimnis: Aktiviert + 7. Erweiterte Einstellungen> Lokaler Zweig:` Master` + 8. Erweiterte Einstellungen> Remote Zweig: `master` +(Sie können` master` ändern, wenn Sie an einem anderen Zweig arbeiten möchten, aber vergessen Sie nicht, ihn zuerst auf GitHub zu erstellen.) + 9. Erweiterte Einstellungen> Committer-Name: Ihr GitHub-Benutzername + 10. Erweiterte Einstellungen> Committer-E-Mail : Ihre E-Mail auf GitHub + 11 gespeichert. Lokale Kopie speichern und zurücksetzen + 12. Setzen Sie die Schlüssel "Commits" und "Tree" in "config / theme / yunohost-docs.yaml", um auf das Repository Ihrer Gabel zu verweisen. +4. Stellen Sie sicher, dass "user / pages / 01.home" und "user / pages / 02". Typografie-Verzeichnisse werden gelöscht. +5. Konfiguration> System: + 1. Sprache> Unterstützt: `en`` fr` `de`` es` `ar` + 2. Sprache> Standardsprache überschreiben:` en` + 3. Sprache> Sprache vom Browser einstellen: `Ja` + 4. HTTP-Header> Etag: `Ja` + 5. Erweitert> Blueprint-Kompatibilität:` Ja` + 6. Erweitert> YAML-Kompatibilität: `Ja` + 7. Erweitert> Zweigkompatibilität:` Ja` From b1a3c96d62b8ca30960daaecdadd8fc0dc57a3d2 Mon Sep 17 00:00:00 2001 From: Hemmho <69148585+Hemmho@users.noreply.github.com> Date: Wed, 5 May 2021 11:34:31 +0200 Subject: [PATCH 2/7] Update write_documentation.de.md --- .../write_documentation.de.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/pages/04.contribute/02.write_documentation/write_documentation.de.md b/pages/04.contribute/02.write_documentation/write_documentation.de.md index 2b7386be..caf13919 100644 --- a/pages/04.contribute/02.write_documentation/write_documentation.de.md +++ b/pages/04.contribute/02.write_documentation/write_documentation.de.md @@ -11,9 +11,9 @@ routes: Die YunoHost-Dokumentation wird über ein [Git-Repository](https://github.com/YunoHost/doc) verwaltet. -Wenn Sie mit GitHub nicht vertraut sind, befindet sich oben auf jeder Seite eine Schaltfläche "Edit", mit der Sie zum GitHub-Online-Editor weitergeleitet werden, mit dem Sie Änderungsvorschläge machen können (Pull Requests, PR). +Wenn Sie mit GitHub nicht vertraut sind, oben auf jeder Seite befindet sich die Schaltfläche "Edit", mit der Sie zum GitHub-Online-Editor weitergeleitet werden, mit dem Sie Änderungsvorschläge machen können (Pull Requests, PR). -Wenn Sie sich jedoch in einer Bearbeitungsphase befinden, sollten Sie das Repository forken. Sie können dann alle gewünschten Commits (Änderungen) in Ihrem Fork vornehmen und alle gleichzeitig in dem selben Pull-Requests senden. Die Etikette von GitHub empfiehlt Ihnen, alle damit verbundenen Commits in derselben PR zusammenzufassen. +Wenn Sie sich jedoch mehrere Bearbeitungen vornehmen oder aktiv mitarbeiten wollen, sollten Sie das Repository forken. Sie können dann alle gewünschten Commits (Änderungen) in Ihrem Fork vornehmen und alle gleichzeitig in dem selben Pull-Requests senden. Die Etikette von GitHub empfiehlt Ihnen, alle damit verbundenen Commits in derselben PR zusammenzufassen. Da der Online-Editor das Hochladen von Dateien nicht unterstützt, ist die Verwendung von Git die bevorzugte Methode, wenn Sie Medien (z. B. Bilder) hochladen müssen. @@ -30,9 +30,9 @@ Die Struktur des Repositorys wird nachfolgend beschrieben: + -- themes + -- yunohost-docs.yaml # Einige Einstellungen für das Dokumentationstheme -+ -- Bilder ++ -- images # Enthält die auf den Dokumentationsseiten verwendeten Bilder. -+ -- Seiten ++ -- pages # Das Verzeichnis mit den Dokumentationsseiten. # Die Seitenhierarchie spiegelt sich in der Verzeichnishierarchie wider. + -- 00.home @@ -58,36 +58,36 @@ Jede Seite beginnt mit einem Header, der Grav Anweisungen zur Verarbeitung gibt. ``` --- -Titel: Dokumentation schreiben +title: Dokumentation schreiben template: docs taxonomie: - Kategorie: docs + category: docs routes: default: '/write_documentation' --- ``` 1. Die Kopfzeile beginnt und endet mit einer Zeile, die `---` enthält -2. Der "Titel:" verwaltet die erste Titel-Überschrift der Seite, ihren Namen im Navigationsmenü links und den Namen des Browser-Tab's -3. Die Punkte "template" und "taxonomie" sollten immer unverändert bleiben. Sie weisen Grav an, das richtige Theme zu verwenden und die Seiten richtig auf zu bauen. -4. Die Schlüssel "routes" und "default" machen die Seite standardmäßig unter "https: //yunohost.org/docs/write_documentation" verfügbar, um sie nicht unter "https://yunohost.org/docs/contribute/write_documentation" aufrufen zu müssen, wo sie in der Verzeichnishierarchie gespeichert ist. +2. Der 'title:' verwaltet die erste Titel-Überschrift der Seite, ihren Namen im Navigationsmenü links und den Namen des Browser-Tab's +3. Die Punkte 'template' und 'taxonomie' sollten immer unverändert bleiben. Sie weisen Grav an, das richtige Theme zu verwenden und die Seiten richtig auf zu bauen. +4. Die Schlüssel 'routes' und 'default' machen die Seite standardmäßig unter "https://yunohost.org/docs/write_documentation" verfügbar, um sie nicht unter "https://yunohost.org/docs/contribute/write_documentation" aufrufen zu müssen, wo sie in der Verzeichnishierarchie gespeichert ist. ## Syntax -Sie können die Markdown-Syntax verwenden. Weitere Informationen finden Sie in der [Dokumentation](/ doc_markdown_guide). +Sie können die Markdown-Syntax verwenden. Weitere Informationen finden Sie in der [Dokumentation](/doc_markdown_guide). ! Beachten Sie, dass Sprachcodes nicht am Anfang der Links zu anderen Dokumentationsseiten stehen dürfen: `/en`,` /fr` usw. sind überflüssig. Um die Markdown-Funktionen zu verbessern, werden zusätzliche Plugins in Grav installiert. In der eigenen Dokumentation zu GitHub erfahren Sie, wie Sie sie verwenden. ``` -Textanker -external_links -flex-Objekte -Highlight -Bildbeschriftungen -Abschlags-Mitteilungen -Präsentation -Präsentations deckset -Shortcode -Kern +anchors +external_links +flex-objects +highlight +image-captions +markdown-notices +presentation +presentation-deckset +shortcode-core ``` ## Sonderseiten From 1291f14b5ea4189023d1542c3f5b0fadab73ecf5 Mon Sep 17 00:00:00 2001 From: Hemmho <69148585+Hemmho@users.noreply.github.com> Date: Wed, 5 May 2021 12:06:56 +0200 Subject: [PATCH 3/7] Update write_documentation.de.md --- .../write_documentation.de.md | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/pages/04.contribute/02.write_documentation/write_documentation.de.md b/pages/04.contribute/02.write_documentation/write_documentation.de.md index caf13919..c7d92dd4 100644 --- a/pages/04.contribute/02.write_documentation/write_documentation.de.md +++ b/pages/04.contribute/02.write_documentation/write_documentation.de.md @@ -1,5 +1,5 @@ --- -title: Write documentation +title: Dokumentation schreiben template: docs taxonomy: category: docs @@ -77,7 +77,7 @@ Sie können die Markdown-Syntax verwenden. Weitere Informationen finden Sie in d ! Beachten Sie, dass Sprachcodes nicht am Anfang der Links zu anderen Dokumentationsseiten stehen dürfen: `/en`,` /fr` usw. sind überflüssig. -Um die Markdown-Funktionen zu verbessern, werden zusätzliche Plugins in Grav installiert. In der eigenen Dokumentation zu GitHub erfahren Sie, wie Sie sie verwenden. +Um die Markdown-Funktionen zu verbessern, werden zusätzliche Plugins in Grav installiert. In der eigenen Dokumentation auf GitHub erfahren Sie, wie Sie sie verwenden. ``` anchors external_links @@ -96,8 +96,8 @@ Einige Seiten der Dokumentation werden automatisch oder dynamisch generiert. | Seite | Pfad | Anmerkungen | | --------------- | ------- | ------- | -| Apps-Katalog | `/pages/02.applications/01.catalog/apps.md` | Ruft [app.json] ab und verarbeitet sie (https://github.com/YunoHost/apps/blob/master/apps.json?target=_blank) | -| Apps-Helfer | `pages/04.contribute/04.packaging_apps/11.helpers/package_apps_helpers.md` | Erstellt von diesem [Skript] (https://github.com/YunoHost/yunohost/blob/dev/doc/generate_helper_doc.py?target=_blank) aus dieser [Vorlage](https://github.com/YunoHost/). yunohost/blob/dev/doc/helper_doc_template.md?target=_blank) | +| Apps-Katalog | `/pages/02.applications/01.catalog/apps.md` | Ruft [app.json](https://github.com/YunoHost/apps/blob/master/apps.json?target=_blank) ab und verarbeitet sie | +| Apps-Helfer | `pages/04.contribute/04.packaging_apps/11.helpers/package_apps_helpers.md` | Erstellt von diesem [Skript](https://github.com/YunoHost/yunohost/blob/dev/doc/generate_helper_doc.py?target=_blank) aus dieser [Vorlage](https://github.com/YunoHost/yunohost/blob/dev/doc/helper_doc_template.md?target=_blank) | | Pro-App-Dokumentation | `pages/02.applications/02.docs/docs.md` | Listet die Unterseiten im selben Verzeichnis auf, deren Header "taxonomy.category: docs, apps" enthält ## Hosten Sie Ihre eigene Testdokumentation @@ -105,8 +105,8 @@ Einige Seiten der Dokumentation werden automatisch oder dynamisch generiert. ! Diese Anweisungen müssen noch vollständig getestet werden. Bitte helfen Sie uns, indem Sie Probleme melden, die Sie möglicherweise mit ihnen haben. 0. Fork YunoHost Dokumentation Repository -1. YunoHost Pakets Grav installieren: `yunohost App installieren grav` -2. Installieren Sie die folgenden Plugins durch Grav des Admin-Panel oder CLI: +1. YunoHost Pakets Grav installieren: `yunohost app install grav` +2. Installieren Sie die folgenden Plugins durch das Grav Admin-Panel oder CLI: ``` anchors breadcrumbs @@ -123,26 +123,26 @@ presentation-deckset shortcode-core tntsearch ``` -3. Git Sync Plugin einrichten . - 1. Wählen Sie GitHub und Ihre Anmeldeinformationen auf GitHub +3. Git Sync Plugin einrichten. + 1. Melden Sie sich mit Ihren Anmeldeinformationen auf GitHub an 2. Legen Sie das Repo fest, z. B. "https://github.com/username/doc". 3. Kopieren Sie die URL des Webhooks, z. B. "https://grav.example/_git-sync-ca25c111f0de". - 4. Grundeinstellungen> Ordner in Synchronisieren: `Seiten`` Bilder` `Themen` + 4. Grundeinstellungen> Ordner im Sync: `pages`` images` `themes` 5. Git Repo-Einstellungen> Benutzer nicht erforderlich: Aktiviert 6. Git Repo-Einstellungen> Web Hooks-Geheimnis: Aktiviert - 7. Erweiterte Einstellungen> Lokaler Zweig:` Master` + 7. Erweiterte Einstellungen> Lokaler Zweig:`master` 8. Erweiterte Einstellungen> Remote Zweig: `master` (Sie können` master` ändern, wenn Sie an einem anderen Zweig arbeiten möchten, aber vergessen Sie nicht, ihn zuerst auf GitHub zu erstellen.) 9. Erweiterte Einstellungen> Committer-Name: Ihr GitHub-Benutzername 10. Erweiterte Einstellungen> Committer-E-Mail : Ihre E-Mail auf GitHub - 11 gespeichert. Lokale Kopie speichern und zurücksetzen - 12. Setzen Sie die Schlüssel "Commits" und "Tree" in "config / theme / yunohost-docs.yaml", um auf das Repository Ihrer Gabel zu verweisen. -4. Stellen Sie sicher, dass "user / pages / 01.home" und "user / pages / 02". Typografie-Verzeichnisse werden gelöscht. -5. Konfiguration> System: +4. Lokale Kopie speichern und zurücksetzen +5. Konfigurieren Sie "commits" und "tree" in "config/theme/yunohost-docs.yaml", so das sie auf Ihren Fork des Repositorys verweisen. +6. Stellen Sie sicher, dass die Verzeichnisse "user/pages/01.home" und "user/pages/02.typography" gelöscht werden. +7. Konfiguration> System: 1. Sprache> Unterstützt: `en`` fr` `de`` es` `ar` 2. Sprache> Standardsprache überschreiben:` en` 3. Sprache> Sprache vom Browser einstellen: `Ja` 4. HTTP-Header> Etag: `Ja` 5. Erweitert> Blueprint-Kompatibilität:` Ja` 6. Erweitert> YAML-Kompatibilität: `Ja` - 7. Erweitert> Zweigkompatibilität:` Ja` + 7. Erweitert> Twig-Kompatibilität:` Ja` From 2d1f18a3e4611712990d8da893dd497383eed956 Mon Sep 17 00:00:00 2001 From: Hemmho <69148585+Hemmho@users.noreply.github.com> Date: Wed, 5 May 2021 12:15:31 +0200 Subject: [PATCH 4/7] Update write_documentation.de.md --- .../02.write_documentation/write_documentation.de.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/pages/04.contribute/02.write_documentation/write_documentation.de.md b/pages/04.contribute/02.write_documentation/write_documentation.de.md index c7d92dd4..7295eb01 100644 --- a/pages/04.contribute/02.write_documentation/write_documentation.de.md +++ b/pages/04.contribute/02.write_documentation/write_documentation.de.md @@ -63,13 +63,13 @@ template: docs taxonomie: category: docs routes: - default: '/write_documentation' + default: `/write_documentation` --- ``` 1. Die Kopfzeile beginnt und endet mit einer Zeile, die `---` enthält -2. Der 'title:' verwaltet die erste Titel-Überschrift der Seite, ihren Namen im Navigationsmenü links und den Namen des Browser-Tab's -3. Die Punkte 'template' und 'taxonomie' sollten immer unverändert bleiben. Sie weisen Grav an, das richtige Theme zu verwenden und die Seiten richtig auf zu bauen. -4. Die Schlüssel 'routes' und 'default' machen die Seite standardmäßig unter "https://yunohost.org/docs/write_documentation" verfügbar, um sie nicht unter "https://yunohost.org/docs/contribute/write_documentation" aufrufen zu müssen, wo sie in der Verzeichnishierarchie gespeichert ist. +2. Der `title:` verwaltet die erste Titel-Überschrift der Seite, ihren Namen im Navigationsmenü links und den Namen des Browser-Tab`s +3. Die Punkte `template` und `taxonomie` sollten immer unverändert bleiben. Sie weisen Grav an, das richtige Theme zu verwenden und die Seiten richtig auf zu bauen. +4. Die Schlüssel `routes` und `default` machen die Seite standardmäßig unter `https://yunohost.org/docs/write_documentation` verfügbar, um sie nicht unter `https://yunohost.org/docs/contribute/write_documentation` aufrufen zu müssen, wo sie in der Verzeichnishierarchie gespeichert ist. ## Syntax From 7f8ad5cb433db23dff8e38e47fc82fe49993ba8c Mon Sep 17 00:00:00 2001 From: Hemmho <69148585+Hemmho@users.noreply.github.com> Date: Wed, 5 May 2021 12:23:37 +0200 Subject: [PATCH 5/7] Create write_documentation.de.md --- .../write_documentation.de.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/pages/04.contribute/02.write_documentation/write_documentation.de.md b/pages/04.contribute/02.write_documentation/write_documentation.de.md index 7295eb01..86837d3d 100644 --- a/pages/04.contribute/02.write_documentation/write_documentation.de.md +++ b/pages/04.contribute/02.write_documentation/write_documentation.de.md @@ -63,7 +63,7 @@ template: docs taxonomie: category: docs routes: - default: `/write_documentation` + default: '/write_documentation' --- ``` 1. Die Kopfzeile beginnt und endet mit einer Zeile, die `---` enthält @@ -98,7 +98,7 @@ Einige Seiten der Dokumentation werden automatisch oder dynamisch generiert. | --------------- | ------- | ------- | | Apps-Katalog | `/pages/02.applications/01.catalog/apps.md` | Ruft [app.json](https://github.com/YunoHost/apps/blob/master/apps.json?target=_blank) ab und verarbeitet sie | | Apps-Helfer | `pages/04.contribute/04.packaging_apps/11.helpers/package_apps_helpers.md` | Erstellt von diesem [Skript](https://github.com/YunoHost/yunohost/blob/dev/doc/generate_helper_doc.py?target=_blank) aus dieser [Vorlage](https://github.com/YunoHost/yunohost/blob/dev/doc/helper_doc_template.md?target=_blank) | -| Pro-App-Dokumentation | `pages/02.applications/02.docs/docs.md` | Listet die Unterseiten im selben Verzeichnis auf, deren Header "taxonomy.category: docs, apps" enthält +| Pro-App-Dokumentation | `pages/02.applications/02.docs/docs.md` | Listet die Unterseiten im selben Verzeichnis auf, deren Header `taxonomy.category: docs, apps` enthält ## Hosten Sie Ihre eigene Testdokumentation @@ -125,8 +125,8 @@ tntsearch ``` 3. Git Sync Plugin einrichten. 1. Melden Sie sich mit Ihren Anmeldeinformationen auf GitHub an - 2. Legen Sie das Repo fest, z. B. "https://github.com/username/doc". - 3. Kopieren Sie die URL des Webhooks, z. B. "https://grav.example/_git-sync-ca25c111f0de". + 2. Legen Sie das Repo fest, z. B. `https://github.com/username/doc`. + 3. Kopieren Sie die URL des Webhooks, z. B. `https://grav.example/_git-sync-ca25c111f0de`. 4. Grundeinstellungen> Ordner im Sync: `pages`` images` `themes` 5. Git Repo-Einstellungen> Benutzer nicht erforderlich: Aktiviert 6. Git Repo-Einstellungen> Web Hooks-Geheimnis: Aktiviert @@ -136,10 +136,10 @@ tntsearch 9. Erweiterte Einstellungen> Committer-Name: Ihr GitHub-Benutzername 10. Erweiterte Einstellungen> Committer-E-Mail : Ihre E-Mail auf GitHub 4. Lokale Kopie speichern und zurücksetzen -5. Konfigurieren Sie "commits" und "tree" in "config/theme/yunohost-docs.yaml", so das sie auf Ihren Fork des Repositorys verweisen. -6. Stellen Sie sicher, dass die Verzeichnisse "user/pages/01.home" und "user/pages/02.typography" gelöscht werden. +5. Konfigurieren Sie `commits` und `tree` in `config/theme/yunohost-docs.yaml`, so das sie auf Ihren Fork des Repositorys verweisen. +6. Stellen Sie sicher, dass die Verzeichnisse `user/pages/01.home` und `user/pages/02.typography` gelöscht werden. 7. Konfiguration> System: - 1. Sprache> Unterstützt: `en`` fr` `de`` es` `ar` + 1. Sprache> Unterstützt: `en` `fr` `de` `es` `ar` 2. Sprache> Standardsprache überschreiben:` en` 3. Sprache> Sprache vom Browser einstellen: `Ja` 4. HTTP-Header> Etag: `Ja` From 2fcac8072a441735cc52d2f26075ce88dc4ec43b Mon Sep 17 00:00:00 2001 From: Hemmho <69148585+Hemmho@users.noreply.github.com> Date: Wed, 5 May 2021 12:26:27 +0200 Subject: [PATCH 6/7] Update write_documentation.de.md --- .../02.write_documentation/write_documentation.de.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/pages/04.contribute/02.write_documentation/write_documentation.de.md b/pages/04.contribute/02.write_documentation/write_documentation.de.md index 86837d3d..a3d11664 100644 --- a/pages/04.contribute/02.write_documentation/write_documentation.de.md +++ b/pages/04.contribute/02.write_documentation/write_documentation.de.md @@ -130,11 +130,11 @@ tntsearch 4. Grundeinstellungen> Ordner im Sync: `pages`` images` `themes` 5. Git Repo-Einstellungen> Benutzer nicht erforderlich: Aktiviert 6. Git Repo-Einstellungen> Web Hooks-Geheimnis: Aktiviert - 7. Erweiterte Einstellungen> Lokaler Zweig:`master` - 8. Erweiterte Einstellungen> Remote Zweig: `master` -(Sie können` master` ändern, wenn Sie an einem anderen Zweig arbeiten möchten, aber vergessen Sie nicht, ihn zuerst auf GitHub zu erstellen.) - 9. Erweiterte Einstellungen> Committer-Name: Ihr GitHub-Benutzername - 10. Erweiterte Einstellungen> Committer-E-Mail : Ihre E-Mail auf GitHub + 7. Erweiterte Einstellungen> Lokaler Branch:`master` + 8. Erweiterte Einstellungen> Remote Branch: `master` + (Sie können` master` ändern, wenn Sie an einem anderen Zweig arbeiten möchten, aber vergessen Sie nicht, ihn zuerst auf GitHub zu erstellen.) + 9. Erweiterte Einstellungen> Committer-Name: Ihr GitHub-Benutzername + 10. Erweiterte Einstellungen> Committer-E-Mail : Ihre E-Mail auf GitHub 4. Lokale Kopie speichern und zurücksetzen 5. Konfigurieren Sie `commits` und `tree` in `config/theme/yunohost-docs.yaml`, so das sie auf Ihren Fork des Repositorys verweisen. 6. Stellen Sie sicher, dass die Verzeichnisse `user/pages/01.home` und `user/pages/02.typography` gelöscht werden. From b62a5aab76ee85b303116c641249c4e2883bf3ac Mon Sep 17 00:00:00 2001 From: Hemmho <69148585+Hemmho@users.noreply.github.com> Date: Wed, 5 May 2021 12:30:08 +0200 Subject: [PATCH 7/7] Update write_documentation.de.md --- .../02.write_documentation/write_documentation.de.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pages/04.contribute/02.write_documentation/write_documentation.de.md b/pages/04.contribute/02.write_documentation/write_documentation.de.md index a3d11664..0777c10c 100644 --- a/pages/04.contribute/02.write_documentation/write_documentation.de.md +++ b/pages/04.contribute/02.write_documentation/write_documentation.de.md @@ -104,8 +104,8 @@ Einige Seiten der Dokumentation werden automatisch oder dynamisch generiert. ! Diese Anweisungen müssen noch vollständig getestet werden. Bitte helfen Sie uns, indem Sie Probleme melden, die Sie möglicherweise mit ihnen haben. -0. Fork YunoHost Dokumentation Repository -1. YunoHost Pakets Grav installieren: `yunohost app install grav` +0. Forken Sie das YunoHost Dokumentations Repository +1. Installieren Sie das YunoHost-Paket Grav : `yunohost app install grav` 2. Installieren Sie die folgenden Plugins durch das Grav Admin-Panel oder CLI: ``` anchors