docs: Update deutsch.md (i18n guide) #12500
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -2,100 +2,95 @@ | |||||
|
|
||||||
| Hallo und herzlich willkommen! Wir freuen uns sehr, dass du dich dafür interessierst, bei der deutschen Übersetzung der Astro-Dokumentation mitzuwirken. 😊🚀 | ||||||
|
|
||||||
| ## Zielsetzung dieser Anleitung | ||||||
|
|
||||||
| Wie bei Open Source-Projekten üblich wird unsere Dokumentation von vielen fleißigen Personen auf freiwilliger Basis übersetzt. Die aktuellen Übersetzungen stammen daher von einigen unterschiedlichen Leuten. Zudem ändert sich auch die Besetzung unseres Teams im Laufe der Zeit. | ||||||
|
|
||||||
| Diese Anleitung soll dazu beitragen, dass sich das Ergebnis beim Lesen trotz aller verschiedenen Einflüsse wie ein Gesamtwerk mit gemeinsamem Schreibstil anfühlt. | ||||||
|
|
||||||
| ## Übersetzungs-Glossar | ||||||
|
|
||||||
| | Originalbegriff | Übersetzung | Anmerkungen | ||||||
| |:----------------------------|:-------------------------------------|:------------ | ||||||
| | asset | Asset | Wird nicht übersetzt (gängiger Domänenbegriff). | ||||||
| | branch | der Branch | s.o. | ||||||
| | build process | Erzeugungs- / Erstellungsvorgang | s.o. | ||||||
| | build time | Erzeugungs- / Erstellungszeitpunkt | s.o. | ||||||
| | to build | erzeugen | Da die Alternativen „bauen“ oder gar „builden“ merkwürdig klingen, wird diese Übersetzung vermutlich so bleiben. | ||||||
| | command line | die Kommandozeile | | ||||||
| | commit | Commit | Siehe [Stilrichtlinien](#stilrichtlinien-style-guide) | ||||||
| | content collection | Content-Collection | Beim ersten Vorkommen in einem Abschnitt kann „(Inhaltssammlung)“ ergänzt werden. | ||||||
| | CLI | die Kommandozeilen­schnittstelle | Beim ersten Vorkommen in einem Abschnitt kann „(CLI)“ dahinter ergänzt werden. | ||||||
| | CLI flag | die Kommandozeilen­option | | ||||||
| | configuration option | die Konfigurations­option | Wenn klar ist, dass es um die Konfiguration geht, kann auch nur „Option“ verwendet werden. | ||||||
| | deployment provider | der Hosting-Anbieter | | ||||||
| | to deploy | veröffentlichen | Wir vermeiden „ausliefern“ aufgrund der Zweideutigkeit. | ||||||
| | dev server | der Entwicklungsserver | | ||||||
| | dev toolbar | die Entwicklungs­werkzeugleiste | | ||||||
| | directory | das Verzeichnis | | ||||||
| | domain | die Domäne | | ||||||
| | frontmatter | das Frontmatter | Wird nicht übersetzt (gängiger Domänenbegriff). | ||||||
| | frontmatter prop(erty) | die Frontmatter-Eigenschaft | | ||||||
| | frontmatter value | der Frontmatter-Wert | | ||||||
| | to hydrate (an element) | hydratisieren | Falsch hingegen wäre „hydrieren“. | ||||||
| | island(s) | Island(s) | „Islands“ bleibt unübersetzt. „Astro“ wird davorgesetzt, um den Feature-Charakter zu betonen. Beim ersten Vorkommen: „(Insel(n))“ ergänzen zur Verständlichkeit. | ||||||
| | media query | Media Query | Wird nicht übersetzt (gängiger Domänenbegriff). | ||||||
| | page | die Seite | Eine einzelne (HTML-)Seite. Wir vermeiden die längere Form „Webseite“, um Verwechslungen mit „Website“ zu vermeiden. | ||||||
| | partial hydration | die partielle Hydratation | Falsch hingegen wäre „Hydrierung“. | ||||||
| | project root (directory) | das Projektstamm­verzeichnis | | ||||||
| | recipe | das Beispiel | | ||||||
| | repository | das Repository | Wird nicht übersetzt (gängiger Domänenbegriff). | ||||||
| | request | die Anfrage | | ||||||
| | script | das Skript | | ||||||
| | selective hydration | die selektive Hydratation | Falsch hingegen wäre „Hydrierung“. | ||||||
| | site, website | die Website | Eine vollständige Webpräsenz unter einer gemeinsamen Domain, bestehend aus beliebig vielen (HTML-)Seiten. | ||||||
| | style, styles | Style, Styles | Wird nicht übersetzt (gängiger Domänenbegriff). | ||||||
| | scoped style | Scoped Style | Beim ersten Vorkommen sollte die deutsche Erklärung „(auf Komponenten begrenzte lokale CSS-Stile)“ dahinter ergänzt werden. | ||||||
| | template | die Vorlage | | ||||||
| | UI | die Benutzeroberfläche | | ||||||
| | web | das Internet | | ||||||
|
|
||||||
| ## Stilrichtlinien (Style Guide) | ||||||
|
|
||||||
| - Wir halten uns hinsichtlich Grammatik und Rechtschreibung an die Empfehlungen des Dudens und verwenden die reformierte deutsche Rechtschreibung. | ||||||
| - Wir verwenden eine informelle Ansprache mit kleingeschriebenem „du“ (statt „Du“ oder „Sie“). | ||||||
| - Wir bleiben möglichst nah am englischen Originaltext. | ||||||
| - Falls die Übersetzung sich aber nicht flüssig liest, weil z. B. im Deutschen übliche Überleitungen fehlen oder andere Formulierungen geläufiger sind, kann freier übersetzt werden, so lange die Bedeutung korrekt bleibt. | ||||||
| - Wir übersetzen alle Kommentare in Code-Beispielen. | ||||||
| - Komponenten-, Klassen- und Variablennamen in Code-Beispielen werden nicht übersetzt. | ||||||
| - Wir haben uns gegen das Gendern in unserer Übersetzung entschieden, weil es die Lesbarkeit der Texte verschlechtert und noch keine Duden-Vorgaben dafür existieren. Wir vermeiden lieber geschlechtsspezifische Formulierungen in unseren Übersetzungen und formulieren die Texte so, dass niemand sich ausgeschlossen fühlen muss. | ||||||
| - Wir vermeiden wertende Adjektive wie „einfach“, „simpel“ usw., da es immer Personen geben wird, denen das beschriebene Thema eben nicht „einfach“ oder „simpel“ vorkommt. Wir möchten niemandem den Eindruck vermitteln, fachlich „nicht gut genug“ zu sein. | ||||||
| - Wir übersetzen nicht zwanghaft Begriffe, die aus einem Ökosystem-spezifischen Kontext stammen. Eine Wort für Wort Übersetzung ist meistens nicht möglich, sodass eine ausführliche Erklärung folgen müsste, was wiederum die Lesbarkeit verschlechtert. Ein gutes Beispiel hierfür wären Begriffe, wie „Commit“, „Pull Request“ und „merge“, die teils einen ganzen Prozess im Git-Ökosystem beschreiben. | ||||||
| - Bei Wörtern, die länger als 20 Zeichen sind, fügen wir generell einen weichen Bindestrich (`­`) ein. Um solche Wörter zu finden, kann der folgende reguläre Ausdruck zum Suchen im Code-Editor verwendet werden: `\b[A-Za-zÄäÖöÜüẞß]{20,}\b` | ||||||
| - Wir verwenden untere (`„`) und obere (`“`) Anführungszeichen anstelle von englischen Anführungszeichen (`“”`) (`„Erstelle deinen ersten Astro-Blog“`) | ||||||
|
|
||||||
| ## Häufige Fehler | ||||||
|
|
||||||
| > **🚨 Wichtig:** Bitte sieh dir die nachfolgenden Fehler genau an und vermeide sie in deinen Übersetzungen. Insbesondere der erste Fehler (fehlende Bindestriche) tritt besonders häufig auf und verursacht so vermeidbare Arbeit bei Reviews. | ||||||
| - Fehlende Bindestriche bei zusammengesetzten Wörtern | ||||||
| - Astro Projekt → Astro-Projekt | ||||||
| - `<description>` Feld → `<description>`-Feld | ||||||
| - Readme Datei → Readme-Datei | ||||||
| - Falsche Übersetzung von Infoboxen („Asides“) | ||||||
| - Unsere Dokumentation enthält an manchen Stellen farblich hervorgehobene Boxen mit Hinweisen, Tipps und Warnungen. Diese sind im Markdown-Code mit drei Doppelpunkten abgegrenzt und beginnen mit dem Typnamen der Box (`:::note`, `:::tip`, `:::caution`). Dieser Typname ist **nicht** zu übersetzen, da ansonsten die Infobox nicht mehr funktioniert. | ||||||
| - Falls dem Typnamen eine vom Standard abweichende Überschrift in eckigen Klammern folgt (`:::caution[Here be dragons!]`), darf nur der Teil in eckigen Klammern übersetzt werden. | ||||||
| - Nichtverwendung der vom Duden empfohlenen Schreibweisen | ||||||
| - mit Hilfe → mithilfe | ||||||
| - Falsch geschriebene Markennamen (wir halten uns an die offizielle Schreibweise auf der Hersteller-Website) | ||||||
| - Github → GitHub | ||||||
| - Gitlab → GitLab | ||||||
| - Javascript → JavaScript | ||||||
| - Typescript → TypeScript | ||||||
| - VSCode → VS Code | ||||||
| - NPM → npm | ||||||
| - Markennamen, deren Name sich im Laufe der Zeit geändert hat, werden mit dem aktuellen Namen genannt; der frühere Name steht in Klammern (z. B. X (Twitter)). | ||||||
| - Abkürzungen müssen in der gleichen Zeile stehen. Hierfür wird das [Unicode Symbol "U+00A0 NO-BREAK SPACE"](https://unicode-explorer.com/c/00A0) (` `) verwendet: | ||||||
louisescher marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
| - Abkürzungen müssen in der gleichen Zeile stehen. Hierfür wird das [Unicode Symbol "U+00A0 NO-BREAK SPACE"](https://unicode-explorer.com/c/00A0) (` `) verwendet: | |
| - Abkürzungen müssen in der gleichen Zeile stehen. Hierfür wird das [Unicode Symbol „U+00A0 NO-BREAK SPACE“](https://unicode-explorer.com/c/00A0) (` `) verwendet: |
Just this.
There was a problem hiding this comment.
I still think we should just tell people to use the HTML entity instead, or at least put it there as an option. CC @trueberryless thoughts?
There was a problem hiding this comment.
yeah, definitely mentioning at least or entirely replacing all...
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.