Skip to content

Commit

Permalink
New Crowdin updates (#195)
Browse files Browse the repository at this point in the history
* New translations updating-fabric.md (Polish)

* New translations updating-fabric.md (German)

* New translations basics.md (Russian)

* New translations events.md (Russian)

* New translations potions.md (Russian)

* New translations basic-concepts.md (Russian)

* New translations draw-context.md (Russian)

* New translations custom-screens.md (Russian)

* New translations custom-widgets.md (Russian)

* New translations hud.md (Russian)

* New translations creating-particles.md (Russian)

* New translations crash-reports.md (Russian)

* New translations updating-fabric.md (Russian)

* New translations damage-types.md (Russian)

* New translations using-sounds.md (Russian)

* New translations creating-a-project.md (Russian)

* New translations custom-armor.md (Russian)

* New translations custom-tools.md (Russian)

* New translations first-item.md (Russian)

* New translations food.md (Russian)

* New translations finding-mods.md (Russian)

* New translations installing-fabric.md (Russian)

* New translations linux.md (Russian)

* New translations installing-mods.md (Russian)

* New translations contributing.md (Russian)

* New translations blockstates.md (Russian)

* New translations first-block.md (Russian)

* New translations ide-tips-and-tricks.md (Russian)

* New translations custom-data-components.md (Russian)

* New translations arguments.md (Russian)

* New translations suggestions.md (Russian)

* New translations custom.md (Russian)

* New translations automatic-testing.md (Russian)

* New translations creating-particles.md (Spanish)

* New translations basics.md (German)

* New translations creating-particles.md (German)

* New translations index.md (German)

* New translations creating-a-project.md (German)

* New translations food.md (German)

* New translations contributing.md (Italian)

* New translations creating-particles.md (Korean)

* New translations basics.md (Chinese Simplified)

* New translations potions.md (Russian)

* New translations draw-context.md (Russian)

* New translations custom-screens.md (Russian)

* New translations custom-widgets.md (Korean)

* New translations hud.md (Russian)

* New translations creating-particles.md (Russian)

* New translations index.md (Korean)

* New translations crash-reports.md (Korean)

* New translations crash-reports.md (Polish)

* New translations updating-fabric.md (Russian)

* New translations sidebar_translations.json (Korean)

* New translations creating-a-project.md (Russian)

* New translations custom-armor.md (Italian)

* New translations custom-item-groups.md (Italian)

* New translations custom-armor.md (Russian)

* New translations first-item.md (Russian)

* New translations finding-mods.md (Russian)

* New translations installing-fabric.md (Russian)

* New translations linux.md (Russian)

* New translations installing-mods.md (Russian)

* New translations contributing.md (Russian)

* New translations blockstates.md (Russian)

* New translations first-block.md (Russian)

* New translations ide-tips-and-tricks.md (Russian)

* New translations custom-data-components.md (Russian)

* New translations automatic-testing.md (Russian)

* New translations updating-fabric.md (German)

* New translations codecs.md (German)

* New translations basics.md (German)

* New translations suggestions.md (German)

* New translations effects.md (German)

* New translations events.md (German)

* New translations basic-concepts.md (German)

* New translations draw-context.md (German)

* New translations custom-widgets.md (German)

* New translations hud.md (German)

* New translations creating-particles.md (German)

* New translations faq.md (German)

* New translations finding-mods.md (German)

* New translations index.md (German)

* New translations installing-fabric.md (German)

* New translations linux.md (German)

* New translations windows.md (German)

* New translations installing-mods.md (German)

* New translations uploading-logs.md (German)

* New translations damage-types.md (German)

* New translations custom.md (German)

* New translations using-sounds.md (German)

* New translations creating-a-project.md (German)

* New translations introduction-to-fabric-and-modding.md (German)

* New translations launching-the-game.md (German)

* New translations project-structure.md (German)

* New translations website_translations.json (Korean)

* New translations effects.md (Russian)

* New translations windows.md (Russian)

* New translations uploading-logs.md (Russian)

* New translations introduction-to-fabric-and-modding.md (Russian)

* New translations text-and-translations.md (Russian)

* New translations codecs.md (Chinese Simplified)

* New translations basics.md (Chinese Simplified)

* New translations faq.md (Chinese Simplified)

* New translations windows.md (Chinese Simplified)

* New translations introduction-to-fabric-and-modding.md (Chinese Simplified)

* New translations custom-item-interactions.md (Chinese Simplified)

* New translations crash-reports.md (German)

* New translations contributing.md (German)

* New translations basics.md (Korean)

* New translations finding-mods.md (Korean)

* New translations uploading-logs.md (Korean)

* New translations creating-a-project.md (Korean)

* New translations index.md (Korean)

* New translations arguments.md (Korean)

* New translations suggestions.md (Korean)

---------

Co-authored-by: Miroma <[email protected]>
  • Loading branch information
FabricMCBot and its-miroma authored Oct 21, 2024
1 parent 599dad3 commit 5e09713
Show file tree
Hide file tree
Showing 91 changed files with 3,185 additions and 504 deletions.
71 changes: 41 additions & 30 deletions translated/de_de/contributing.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Beitragsrichtlinen
description: Richtlinien zur Beitragserstellung für die Fabric-Dokumentation
---

# [Wie man beiträgt](#how-to-contribute)
# Wie man beiträgt {#contributing}

Diese Website nutzt [VitePress](https://vitepress.dev/) um statisches HTML von den verschiedenen Markdown-Dateien zu generrieren. Du solltest dich mit den Markdown-Erweiterungen vertraut machen, die VitePress [hier](https://vitepress.dev/guide/markdown#features) unterstützt.

Expand All @@ -15,21 +15,25 @@ Du hast drei Möglichkeiten, zu dieser Website beizutragen:

Alle Beiträge müssen unseren [Stilrichtlinien](#stilrichtlinien) entsprechen.

## Übersetzen der Dokumentation
## Übersetzen der Dokumentation {#translating-documentation}

Falls du die Dokumentation in deine Sprache übersetzen möchtest, kannst du dies auf der [Fabric Crowdin-Seite](https://crowdin.com/project/fabricmc) tun.

## Inhalte beitragen
<!-- markdownlint-disable-next-line titlecase-rule -->

## <Badge type="tip">new-content</Badge> Inhalt beitragen {#contributing-content}

Inhaltliche Beiträge sind die wichtigste Möglichkeit, zur Fabric-Dokumentation beizutragen.

Alle inhaltlichen Beiträge durchlaufen drei Stufen:
Alle Inhaltsbeiträge durchlaufen die folgenden Stufen, die jeweils mit einem Label versehen sind:

1. Anleitung für Erweiterung (falls möglich)
2. Überprüfung des Inhalts
3. Bereinigung (Grammatik etc.)
1. <Badge type="tip">locally</Badge> Änderungen vorbereiten und einen Pull Request pushen
2. <Badge type="tip">stage:expansion</Badge>: Anleitung zur Erweiterung, falls erforderlich
3. <Badge type="tip">stage:verification</Badge>: Verifikation des Inhalts
4. <Badge type="tip">stage:cleanup</Badge>: Grammatik, Linting...
5. <Badge type="tip">stage:ready</Badge>: Bereit zum mergen!

Alle Inhalte sollten unseren Stilrichtlinien entsprechen.
Alle Inhalte sollten unseren [Stilrichtlinien](#style-guidelines) entsprechen.

### 1. Deine Änderungen vorbereiten {#1-prepare-your-changes}

Expand All @@ -44,7 +48,7 @@ Du kannst [hier](https://docs.github.com/en/get-started/using-github/github-flow

Du kannst entweder Änderungen über die Weboberfläche auf GitHub vornehmen oder die Website lokal entwickeln und in der Vorschau anzeigen.

#### <Badge type="tip">lokal</Badge> Den Fork klonen {#clone-your-fork}
#### Deinen Fork klonen {#clone-your-fork}

Wenn du lokal entwickeln willst, musst du [Git](https://git-scm.com/) installieren.

Expand All @@ -55,7 +59,7 @@ Danach klone deinen Fork des Repository mit:
git clone https://github.com/your-username/fabric-docs.git
```

#### <Badge type="tip">lokal</Badge> Abhängigkeiten installieren {#install-dependencies}
#### Abhängigkeiten installieren {#install-dependencies}

**Wenn du deine Änderungen lokal ansehen möchtest, musst du [Node.js 18+](https://nodejs.org/en/) installieren.**

Expand All @@ -65,7 +69,7 @@ Danach stelle sicher, dass du alle Abhängigkeiten installierst:
npm install
```

#### <Badge type="tip">lokal</Badge> Den Entwicklungsserver ausführen {#run-the-development-server}
#### Den Developmentserver ausführen {#run-the-development-server}

Damit kannst du deine Änderungen lokal auf `localhost:3000` ansehen und die Seite wird automatisch neu geladen, wenn du Änderungen vornimmst.

Expand All @@ -75,23 +79,23 @@ npm run dev

Jetzt kannst du die Website über den Browser öffnen und durchsuchen, indem du `http://localhost:5173` aufrufst.

#### <Badge type="tip">lokal</Badge> Bauen der Website {#building-the-website}
#### Die Website bauen {#building-the-website}

Dies wird alle Markdown-Dateien in statische HTML-Dateien kompilieren und diese in `.vitepress/dist` ablegen

```sh
npm run build
```

#### <Badge type="tip">lokal</Badge> Vorschau der gebauten Website {#previewing-the-built-website}
#### Vorschau der gebauten Website {#previewing-the-built-website}

Dies wird einen lokalen Server auf Port 3000 starten, der den Inhalt in `.vitepress/dist` bereitstellt.

```sh
npm run preview
```

#### <Badge type="tip">lokal</Badge> Öffnen eines Pull Requests {#opening-a-pull-request}
#### Einen Pull Request öffnen {#opening-a-pull-request}

Wenn du mit deinen Änderungen zufrieden bist, kannst du sie \`push´en:

Expand All @@ -103,42 +107,49 @@ git push

Folge dann dem Link in der Ausgabe von `git push`, um einen PR zu öffnen.

### 2. [Anleitung zur Erweiterung](#guidance-for-expansion)
### 2. <Badge type="tip">stage:expansion</Badge> Anleitung zur Erweiterung, falls erforderlich {#2-guidance-for-expansion-if-needed}

Wenn das Dokumentationsteam der Meinung ist, dass du deinen Pull Request erweitern könntest, wird ein Mitglied des Teams das Label <Badge type="tip">stage:expansion</Badge> zu deinem Pull Request hinzufügen, zusammen mit einem Kommentar, der erklärt, was du deren Meinung nach erweitern könnten. Wenn du mit dem Vorschlag einverstanden bist, kannst du deinen Pull-Request erweitern.

Wenn das Dokumentationsteam der Meinung ist, dass du deinen Pull Request erweitern könntest, wird ein Mitglied des Teams den Vermerk `can-expand` zu deinem Pull Request hinzufügen, zusammen mit einem Kommentar, der erklärt, was du ihrer Meinung nach erweitern könntest. Wenn du mit dem Vorschlag einverstanden bist, kannst du deinen Pull-Request erweitern.
Wenn du deinen Pull Request nicht erweitern willst, aber gerne möchtest, dass jemand anderes ihn zu einem späteren Zeitpunkt erweitert, solltest du ein Issue auf der [Issues Seite](https://github.com/FabricMC/fabric-docs/issues) erstellen und erklären, was deiner Meinung nach erweitert werden könnte. Das Dokumentationsteam fügt dann das Label <Badge type="tip">help-wanted</Badge> zu deinem PR hinzu.

Fühle dich nicht unter Druck gesetzt, deinen Pull Request zu erweitern. **Fühl dich nicht unter Druck gesetzt, deine Anfrage zu erweitern** Wenn du deine Anfrage nicht erweitern möchtest, kannst du einfach darum bitten, dass die Kennzeichnung `can-expand` entfernt wird.
### 3. <Badge type="tip">stage:verification</Badge> Verifikation des Inhalts {#3-content-verification}

Wenn du deinen Pull-Request nicht erweitern willst, aber gerne möchtest, dass jemand anderes ihn zu einem späteren Zeitpunkt erweitert, ist es am besten, ein Issue auf der [Issues-Seite](https://github.com/FabricMC/fabric-docs/issues) zu erstellen und zu erklären, was deiner Meinung nach erweitert werden könnte.
Dies ist die wichtigste Phase, da sie sicherstellt, dass der Inhalt korrekt ist und den Stilrichtlinien der Fabric Documentation entspricht.

### 3. [Überprüfung des Inhalts](#content-verification)
In dieser Phase sollten die folgenden Fragen beantwortet werden:

Dies ist die wichtigste Phase, da sie sicherstellt, dass der Inhalt korrekt ist und den Fabric Stilrichtlinien der Dokumentation entspricht.
- Ist der ganze Inhalt korrekt?
- Ist der ganze Inhalt aktuell?
- Deckt der Inhalt alle Fälle ab, z. B. verschiedene Betriebssysteme?

### 4. [Aufräumen](#cleanup)
### 4. <Badge type="tip">stage:cleanup</Badge> Aufräumen {#4-cleanup}

In dieser Phase behebt das Dokumentationsteam Grammatikfehler und nimmt andere Änderungen vor, die es für notwendig hält, bevor es den Pull-Request mergt!
In dieser Phase passiert folgendes:

## Zum Framework beitragen
- Beheben aller Grammatikfehler mit [LanguageTool](https://languagetool.org/)
- Linten alle Markdown-Dateien mit [`markdownlint`](https://github.com/DavidAnson/markdownlint)
- Formatierung des ganzen Java-Code mit [Checkstyle](https://checkstyle.sourceforge.io/)
- Andere verschiedene Korrekturen oder Verbesserungen

Alle Pull-Requests, die das Framework der Website verändern, sollten mit dem Label `framework` gekennzeichnet werden.
## <Badge type="tip">framework</Badge> Zum Framework beitragen {#contributing-framework}

Framework bezieht sich auf die interne Struktur der Website. Alle Pull Requests, die das Framework der Website verändern, werden mit dem Label <Badge type="tip">framework</Badge> gekennzeichnet.

Du solltest wirklich nur Pull-Requests für das Framework eröffnen, nachdem du dich mit dem Dokumentationsteam im [Fabric Discord](https://discord.gg/v6v4pMv) oder über ein Issue beraten hast.

:::info
**Hinweis: Das Ändern von Seitenleistendateien und der Konfiguration der Navigationsleiste zählt nicht als Pull-Request für das Framework.**
:::

## [Stilrichtlinien](#style-guidelines)
## Stilrichtlinien {#style-guidelines}

Wenn du unsicher bist, kannst du im [Fabric Discord](https://discord.gg/v6v4pMv) oder über GitHub Diskussionen nachfragen.

### Schreibe das Original in amerikanischem Englisch {#write-the-original-in-american-english}

Die ganze originale Dokumentation ist in englischer Sprache verfasst und folgt den amerikanischen Grammatikregeln.

Du kannst zwar [LanguageTool](https://languagetool.org/) verwenden, um deine Grammatik während der Eingabe zu überprüfen, aber mache dir nicht zu viele Gedanken darüber. Unser Dokumentationsteam überprüft und korrigiert die Grammatik während der Bereinigungsphase. Wenn man sich jedoch von Anfang an bemüht, es richtig zu machen, können wir Zeit sparen.

### Daten zum Frontmatter hinzufügen {#add-data-to-the-frontmatter}

Alle Seiten müssen einen Titel und eine Beschreibung im Frontmatter haben.
Expand Down Expand Up @@ -180,7 +191,7 @@ Dies wird die Zeilen 15-21 der Datei `FabricDocsReference.java` des Referenz-Mod
<<< @/reference/latest/src/main/java/com/example/docs/FabricDocsReference.java{15-21}
```

[Richtlinien zur Beitragserstellung für die Fabric-Dokumentation](#fabric-documentation-contribution-guidelines)
<<< @/reference/latest/src/main/java/com/example/docs/FabricDocsReference.java{15-21}[java]

:::

Expand All @@ -204,7 +215,7 @@ Wenn du einen neuen Abschnitt erstellst, solltest du eine neue Seitenleiste im O

Wenn du dabei Hilfe benötigst, frage bitte auf dem [Fabric Discord](https://discord.gg/v6v4pMv) im Kanal `#docs` nach.

### Anleitung zur Erweiterung
### Anleitung zur Erweiterung {#add-new-pages-to-the-relevant-sidebars}

Wenn du eine neue Seite erstellst, solltest du sie der entsprechenden Seitenleiste im Ordner `.vitepress/sidebars` hinzufügen.

Expand All @@ -214,7 +225,7 @@ Auch hier gilt: Wenn du Hilfe benötigst, frage auf dem Fabric Discord im Kanal

Alle Bilder sollten an einem geeigneten Ort im Ordner `/assets` abgelegt werden.

### Nutze relative Links! ⚠️ **Wenn du andere Seiten verlinkst, verwende relative Links.** ⚠️
### Nutze relative Links! {#use-relative-links}

Der Grund dafür ist das vorhandene Versionssystem, das die Links verarbeitet, um die Version vorher hinzuzufügen. Wenn du absolute Links verwendest, wird die Versionsnummer nicht zum Link hinzugefügt.

Expand Down
Loading

0 comments on commit 5e09713

Please sign in to comment.