|
2 | 2 |
|
3 | 3 | Hallo und herzlich willkommen! Wir freuen uns sehr, dass du dich dafür interessierst, bei der deutschen Übersetzung der Astro-Dokumentation mitzuwirken. 😊🚀 |
4 | 4 |
|
5 | | - |
6 | 5 | ## Zielsetzung dieser Anleitung |
7 | 6 |
|
8 | | -Wie bei Open Source-Projekten üblich wird unsere Dokumentation von vielen fleißigen Personen auf freiwilliger Basis übersetzt. Die aktuellen Übersetzungen stammen daher aus vielen unterschiedlichen Federn. Zudem ändert sich auch die Besetzung unseres Teams im Laufe der Zeit. |
| 7 | +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. |
9 | 8 |
|
10 | 9 | Diese Anleitung soll dazu beitragen, dass sich das Ergebnis beim Lesen trotz aller verschiedenen Einflüsse wie ein Gesamtwerk mit gemeinsamem Schreibstil anfühlt. |
11 | 10 |
|
12 | | - |
13 | | - |
14 | | - |
15 | 11 | ## Übersetzungs-Glossar |
16 | 12 |
|
17 | 13 | | Originalbegriff | Übersetzung | Anmerkungen |
18 | 14 | |:----------------------------|:-------------------------------------|:------------ |
19 | 15 | | asset | Asset | Wird nicht übersetzt (gängiger Domänenbegriff). |
20 | | -| branch | der Branch | Wird nicht übersetzt (gängiger Domänenbegriff). |
| 16 | +| branch | der Branch | s.o. |
21 | 17 | | build process | Erzeugungs- / Erstellungsvorgang | s.o. |
22 | 18 | | build time | Erzeugungs- / Erstellungszeitpunkt | s.o. |
23 | | -| to build | erzeugen | Da die Alternativen "bauen" oder gar "builden" merkwürdig klingen, wird diese Übersetzung vermutlich so bleiben. |
| 19 | +| to build | erzeugen | Da die Alternativen „bauen“ oder gar „builden“ merkwürdig klingen, wird diese Übersetzung vermutlich so bleiben. |
24 | 20 | | command line | die Kommandozeile | |
25 | | -| Commit | Commit | Siehe **Stilrichtlinien** |
26 | | -| CLI | die Kommandozeilen­schnittstelle | Beim ersten Vorkommen in einem Abschnitt kann `(CLI)` dahinter ergänzt werden. Aufgrund der Wortlänge wird die Aufnahme eines weichen Bindestrichs empfohlen: `Kommandozeilen­schnittstelle` |
27 | | -| CLI flag | die Kommandozeilen­option | Aufgrund der Wortlänge wird die Aufnahme eines weichen Bindestrichs empfohlen: `Kommandozeilen­option` |
28 | | -| configuration option | die Konfigurations­option | Wenn klar ist, dass es um die Konfiguration geht, kann auch nur "Option" verwendet werden. Bei der Langversion wird die Aufnahme eines weichen Bindestrichs empfohlen: `Konfigurations­option` |
| 21 | +| commit | Commit | Siehe [Stilrichtlinien](#stilrichtlinien-style-guide) |
| 22 | +| content collection | Content-Collection | Beim ersten Vorkommen in einem Abschnitt kann „(Inhaltssammlung)“ ergänzt werden. |
| 23 | +| CLI | die Kommandozeilen­schnittstelle | Beim ersten Vorkommen in einem Abschnitt kann „(CLI)“ dahinter ergänzt werden. |
| 24 | +| CLI flag | die Kommandozeilen­option | |
| 25 | +| configuration option | die Konfigurations­option | Wenn klar ist, dass es um die Konfiguration geht, kann auch nur „Option“ verwendet werden. |
29 | 26 | | deployment provider | der Hosting-Anbieter | |
30 | | -| to deploy | veröffentlichen | Wir vermeiden "ausliefern" aufgrund der Zweideutigkeit. |
31 | | -| dev toolbar | die Entwicklungswerkzeugleiste | Aufgrund der Wortlänge wird die Aufnahme eines weichen Bindestrichs empfohlen: `Entwicklungs­werkzeugleiste` |
| 27 | +| to deploy | veröffentlichen | Wir vermeiden „ausliefern“ aufgrund der Zweideutigkeit. |
| 28 | +| dev server | der Entwicklungsserver | |
| 29 | +| dev toolbar | die Entwicklungs­werkzeugleiste | |
32 | 30 | | directory | das Verzeichnis | |
33 | 31 | | domain | die Domäne | |
34 | 32 | | frontmatter | das Frontmatter | Wird nicht übersetzt (gängiger Domänenbegriff). |
35 | 33 | | frontmatter prop(erty) | die Frontmatter-Eigenschaft | |
36 | 34 | | frontmatter value | der Frontmatter-Wert | |
37 | | -| to hydrate (an element) | hydratisieren | Falsch hingegen wäre "hydrieren". |
38 | | -| island(s) | die Astro-Insel(n) | Der Präfix "Astro-" wird davorgesetzt, sofern wir über Astros Umsetzung der Inselarchitektur sprechen. |
| 35 | +| to hydrate (an element) | hydratisieren | Falsch hingegen wäre „hydrieren“. |
| 36 | +| 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. |
39 | 37 | | media query | Media Query | Wird nicht übersetzt (gängiger Domänenbegriff). |
40 | | -| page | die Seite | Eine einzelne (HTML-)Seite. Wir vermeiden die längere Form "Webseite", um Verwechslungen mit "Website" zu vermeiden. |
41 | | -| partial hydration | die partielle Hydratation | Falsch hingegen wäre "Hydrierung". |
42 | | -| project root (directory) | das Projektstamm­verzeichnis | Aufgrund der Wortlänge wird die Aufnahme eines weichen Bindestrichs empfohlen: `Projektstamm­verzeichnis` |
| 38 | +| page | die Seite | Eine einzelne (HTML-)Seite. Wir vermeiden die längere Form „Webseite“, um Verwechslungen mit „Website“ zu vermeiden. |
| 39 | +| partial hydration | die partielle Hydratation | Falsch hingegen wäre „Hydrierung“. |
| 40 | +| project root (directory) | das Projektstamm­verzeichnis | |
43 | 41 | | recipe | das Beispiel | |
44 | 42 | | repository | das Repository | Wird nicht übersetzt (gängiger Domänenbegriff). |
45 | 43 | | request | die Anfrage | |
46 | 44 | | script | das Skript | |
47 | | -| selective hydration | die selektive Hydratation | Falsch hingegen wäre "Hydrierung". |
| 45 | +| selective hydration | die selektive Hydratation | Falsch hingegen wäre „Hydrierung“. |
48 | 46 | | site, website | die Website | Eine vollständige Webpräsenz unter einer gemeinsamen Domain, bestehend aus beliebig vielen (HTML-)Seiten. |
49 | 47 | | style, styles | Style, Styles | Wird nicht übersetzt (gängiger Domänenbegriff). |
50 | | -| scoped style | Scoped Style | Beim ersten Vorkommen sollte die deutsche Erklärung `(auf Komponenten begrenzte lokale CSS-Stile)` dahinter ergänzt werden. |
| 48 | +| scoped style | Scoped Style | Beim ersten Vorkommen sollte die deutsche Erklärung „(auf Komponenten begrenzte lokale CSS-Stile)“ dahinter ergänzt werden. |
51 | 49 | | template | die Vorlage | |
52 | | -| ui | die Benutzeroberfläche | |
| 50 | +| UI | die Benutzeroberfläche | |
53 | 51 | | web | das Internet | |
54 | 52 |
|
55 | | - |
56 | | - |
57 | | - |
58 | 53 | ## Stilrichtlinien (Style Guide) |
59 | 54 |
|
60 | | -- Wir halten uns hinsichtlich Grammatik und Rechtschreibung an die Empfehlungen des Dudens und verwenden die neue deutsche Rechtschreibung. |
61 | | -- Wir verwenden eine informelle Ansprache mit kleingeschriebenem "du" (statt "Du" oder "Sie"). |
| 55 | +- Wir halten uns hinsichtlich Grammatik und Rechtschreibung an die Empfehlungen des Dudens und verwenden die reformierte deutsche Rechtschreibung. |
| 56 | +- Wir verwenden eine informelle Ansprache mit kleingeschriebenem „du“ (statt „Du“ oder „Sie“). |
62 | 57 | - Wir bleiben möglichst nah am englischen Originaltext. |
63 | | - - 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. |
| 58 | + - 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. |
64 | 59 | - Wir übersetzen alle Kommentare in Code-Beispielen. |
65 | | -- Wir übersetzen gerne auch Komponenten-, Klassen- und Variablennamen in Code-Beispielen. So signalisieren wir, dass diese Namen frei definierbar sind und keine "magischen Keywords" von Astro darstellen. |
| 60 | +- Komponenten-, Klassen- und Variablennamen in Code-Beispielen werden nicht übersetzt. |
66 | 61 | - 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. |
67 | | -- 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. |
68 | | -- 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. |
69 | | - |
70 | | - |
71 | | - |
| 62 | +- 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. |
| 63 | +- 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. |
| 64 | +- 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` |
| 65 | +- Wir verwenden untere (`„`) und obere (`“`) Anführungszeichen anstelle von englischen Anführungszeichen (`“”`) (`„Erstelle deinen ersten Astro-Blog“`) |
| 66 | +- Abkürzungen müssen in der gleichen Zeile stehen. Hierfür wird die HTML-Entität ` ` oder das [Unicode Symbol "U+00A0 NO-BREAK SPACE"](https://unicode-explorer.com/c/00A0) (` `) verwendet. |
72 | 67 |
|
73 | 68 | ## Häufige Fehler |
74 | 69 |
|
75 | 70 | > **🚨 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. |
76 | 71 |
|
77 | 72 | - Fehlende Bindestriche bei zusammengesetzten Wörtern |
78 | | - - Astro Projekt --> Astro-Projekt |
79 | | - - `<description>` Feld --> `<description>`-Feld |
80 | | - - Readme Datei --> Readme-Datei |
81 | | -- Falsche Übersetzung von Infoboxen ("Asides") |
| 73 | + - Astro Projekt → Astro-Projekt |
| 74 | + - `<description>` Feld → `<description>`-Feld |
| 75 | + - Readme Datei → Readme-Datei |
| 76 | +- Falsche Übersetzung von Infoboxen („Asides“) |
82 | 77 | - 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. |
83 | 78 | - 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. |
84 | 79 | - Nichtverwendung der vom Duden empfohlenen Schreibweisen |
85 | | - - mit Hilfe --> mithilfe |
| 80 | + - mit Hilfe → mithilfe |
86 | 81 | - Falsch geschriebene Markennamen (wir halten uns an die offizielle Schreibweise auf der Hersteller-Website) |
87 | | - - Github --> GitHub |
88 | | - - Javascript --> JavaScript |
89 | | - - Typescript --> TypeScript |
90 | | - - VSCode --> VS Code |
91 | | - |
92 | | - |
93 | | - |
| 82 | + - Github → GitHub |
| 83 | + - Gitlab → GitLab |
| 84 | + - Javascript → JavaScript |
| 85 | + - Typescript → TypeScript |
| 86 | + - VSCode → VS Code |
| 87 | + - NPM → npm |
| 88 | +- 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)). |
| 89 | +- Verwendung der falschen Anführungszeichen ("" statt „“) |
| 90 | +- Abkürzungen sind nicht mit non-breaking space versehen |
| 91 | + - `z. B.` → `z. B.` (Unicode-Zeichen) oder `z. B.` (HTML-Entität) |
94 | 92 |
|
95 | 93 | ## Hast du Ergänzungen oder Anregungen zu dieser Anleitung? |
96 | 94 |
|
97 | | -Das ist super! Die Inhalte dieses Dokuments sind nämlich nicht als in Stein gemeißelte "Regeln von oben" zu verstehen, sondern bilden lediglich den aktuellen Konsens unseres deutschen Übersetzungsteams ab. |
| 95 | +Das ist super! Die Inhalte dieses Dokuments sind nämlich nicht als in Stein gemeißelte „Regeln von oben“ zu verstehen, sondern bilden lediglich den aktuellen Konsens unseres deutschen Übersetzungsteams ab. |
98 | 96 |
|
99 | 97 | Solltest du Verbesserungsideen oder Änderungswünsche zu diesem Dokument haben, besuch uns gerne auf Discord und sprich mit uns darüber. Wir sind stets offen für neue Anregungen! |
100 | | - |
101 | | - |
0 commit comments