New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
🌐 Add German translation for docs/de/docs/index.md
#3631
Conversation
Codecov ReportPatch and project coverage have no change.
Additional details and impacted files@@ Coverage Diff @@
## master #3631 +/- ##
===========================================
Coverage 100.00% 100.00%
===========================================
Files 540 408 -132
Lines 13969 10229 -3740
===========================================
- Hits 13969 10229 -3740 ☔ View full report in Codecov by Sentry. |
📝 Docs preview for commit ef56820 at: https://6103bf3e2ff7b421a0981749--fastapi.netlify.app |
|
||
--- | ||
|
||
FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.6+ based on standard Python type hints. | ||
FastAPI ist ein modernes, schnelles (High-Performance) Web-Framework zur Erstellung von APIs mit Python 3.6+ auf Basis von Python type hints. | ||
Die Haupteigenschaften sind: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe Hauptmerkmale
instead of Haupteigenschaften
?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I aggree, sounds better to me
|
||
The key features are: | ||
* **Schnell**: Sehr hohe Leistung, auf dem Niveau von **NodeJS** und **Go** (Dank an Starlette und Pydantic) [Eines der schnellsten verfügbaren Python-Frameworks](#performance). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would translate thanks to [...]
only with dank [...]
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* **Schnell**: Sehr hohe Leistung, auf dem Niveau von **NodeJS** und **Go** (Dank an Starlette und Pydantic) [Eines der schnellsten verfügbaren Python-Frameworks](#performance). | |
* **Schnell**: Sehr hohe Leistung, auf dem Niveau von **NodeJS** und **Go** (Dank Starlette und Pydantic) [Eines der schnellsten verfügbaren Python-Frameworks](#performance). |
I aggree with mawassk
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes would remove the "an"
|
||
* <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a> for the web parts. | ||
* <a href="https://pydantic-docs.helpmanual.io/" class="external-link" target="_blank">Pydantic</a> for the data parts. | ||
* <a href="https://www.starlette.io/" class="external-link" target="_blank">Starlette</a> für die Webteile. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe Webinhalte
and Dateninhalte
instead of -teile
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Or: Webanteile, Datenanteile
|
||
Run the server with: | ||
Führen Sie den Server mit aus: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Starten Sie den Server:
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Führen Sie den Server mit aus: | |
Starten Sie den Server: |
Here I also aggree with mawassk
* `--reload`: make the server restart after code changes. Only do this for development. | ||
* `main`: die Datei `main.py` (das Python-"Modul"). | ||
* `app`: das Objekt, das innerhalb von `main.py` mit der Zeile `app = FastAPI()` erzeugt wurde. | ||
* `--reload`: lässt den Server nach Codeänderungen neu starten. Tun Sie dies nur während der Entwicklung. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Tun
is not so nice german, maybe use Aktivieren Sie dies nur während der Entwicklung
, another alternative would be Benutzen
.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* `--reload`: lässt den Server nach Codeänderungen neu starten. Tun Sie dies nur während der Entwicklung. | |
* `--reload`: lässt den Server nach Codeänderungen neu starten. Aktivieren Sie dies nur während der Entwicklung. |
"Aktivieren" is the better choice
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Or: Aktivieren Sie diese Option nur während der Entwicklung.
Awesome! Thanks for your contribution. 🚀 These translations depend mainly on having more people that speak the language review them, once I have two reviews approving a translation PR I can merge it. I just created a new issue to track these translations, you can comment there and subscribe, and probably also check if there are other PRs by others you could review. 🤓 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I aggree with all suggestions kawassk made.
I also reviewed the whole file and added some more suggestions.
@@ -59,9 +54,9 @@ The key features are: | |||
|
|||
<!-- /sponsors --> | |||
|
|||
<a href="https://fastapi.tiangolo.com/fastapi-people/#sponsors" class="external-link" target="_blank">Other sponsors</a> | |||
<a href="https://fastapi.tiangolo.com/fastapi-people/#sponsors" class="external-link" target="_blank">Andere Sponsors</a> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
<a href="https://fastapi.tiangolo.com/fastapi-people/#sponsors" class="external-link" target="_blank">Andere Sponsors</a> | |
<a href="https://fastapi.tiangolo.com/fastapi-people/#sponsors" class="external-link" target="_blank">Andere Sponsoren</a> |
|
||
The key features are: | ||
* **Schnell**: Sehr hohe Leistung, auf dem Niveau von **NodeJS** und **Go** (Dank an Starlette und Pydantic) [Eines der schnellsten verfügbaren Python-Frameworks](#performance). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* **Schnell**: Sehr hohe Leistung, auf dem Niveau von **NodeJS** und **Go** (Dank an Starlette und Pydantic) [Eines der schnellsten verfügbaren Python-Frameworks](#performance). | |
* **Schnell**: Sehr hohe Leistung, auf dem Niveau von **NodeJS** und **Go** (Dank Starlette und Pydantic) [Eines der schnellsten verfügbaren Python-Frameworks](#performance). |
I aggree with mawassk
|
||
--- | ||
|
||
FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.6+ based on standard Python type hints. | ||
FastAPI ist ein modernes, schnelles (High-Performance) Web-Framework zur Erstellung von APIs mit Python 3.6+ auf Basis von Python type hints. | ||
Die Haupteigenschaften sind: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I aggree, sounds better to me
|
||
Run the server with: | ||
Führen Sie den Server mit aus: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Führen Sie den Server mit aus: | |
Starten Sie den Server: |
Here I also aggree with mawassk
* `--reload`: make the server restart after code changes. Only do this for development. | ||
* `main`: die Datei `main.py` (das Python-"Modul"). | ||
* `app`: das Objekt, das innerhalb von `main.py` mit der Zeile `app = FastAPI()` erzeugt wurde. | ||
* `--reload`: lässt den Server nach Codeänderungen neu starten. Tun Sie dies nur während der Entwicklung. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* `--reload`: lässt den Server nach Codeänderungen neu starten. Tun Sie dies nur während der Entwicklung. | |
* `--reload`: lässt den Server nach Codeänderungen neu starten. Aktivieren Sie dies nur während der Entwicklung. |
"Aktivieren" is the better choice
* Bei `PUT`-Anfragen an `/items/{item_id}` wird der Body als JSON gelesen: | ||
* Prüfen Sie, ob er ein erforderliches Attribut `name` hat, das ein `str` sein sollte. | ||
* Prüfen Sie, ob er ein erforderliches Attribut `price` hat, das ein `float` sein muss. | ||
* Prüfen Sie, ob es ein optionales Attribut `is_offer` hat, das ein `bool` sein sollte, falls vorhanden. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* Prüfen Sie, ob es ein optionales Attribut `is_offer` hat, das ein `bool` sein sollte, falls vorhanden. | |
* Prüfen, ob es ein optionales Attribut `is_offer` hat, das ein `bool` sein sollte, falls vorhanden. |
* Da der `q`-Parameter mit `= None` deklariert ist, ist er optional. | ||
* Ohne das `None` wäre er erforderlich (wie der Body im Fall von `PUT`). | ||
* Bei `PUT`-Anfragen an `/items/{item_id}` wird der Body als JSON gelesen: | ||
* Prüfen Sie, ob er ein erforderliches Attribut `name` hat, das ein `str` sein sollte. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* Prüfen Sie, ob er ein erforderliches Attribut `name` hat, das ein `str` sein sollte. | |
* Prüfen, ob er ein erforderliches Attribut `name` hat, das ein `str` sein sollte. |
* Überprüfen Sie, dass es eine `item_id` im Pfad für `GET`- und `PUT`-Anfragen gibt. | ||
* Überprüfen Sie, ob die `item_id` vom Typ `int` für `GET`- und `PUT`-Anfragen ist. | ||
* Ist dies nicht der Fall, wird dem Client ein nützlicher, eindeutiger Fehler angezeigt. | ||
* Prüfen Sie, ob es einen optionalen Abfrageparameter namens `q` (wie in `http://127.0.0.1:8000/items/foo?q=somequery`) für `GET`-Anfragen gibt. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* Prüfen Sie, ob es einen optionalen Abfrageparameter namens `q` (wie in `http://127.0.0.1:8000/items/foo?q=somequery`) für `GET`-Anfragen gibt. | |
* Prüfen, ob es einen optionalen Abfrageparameter namens `q` (wie in `http://127.0.0.1:8000/items/foo?q=somequery`) für `GET`-Anfragen gibt. |
Um auf das vorherige Codebeispiel zurückzukommen, **FastAPI** wird: | ||
|
||
* Überprüfen Sie, dass es eine `item_id` im Pfad für `GET`- und `PUT`-Anfragen gibt. | ||
* Überprüfen Sie, ob die `item_id` vom Typ `int` für `GET`- und `PUT`-Anfragen ist. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* Überprüfen Sie, ob die `item_id` vom Typ `int` für `GET`- und `PUT`-Anfragen ist. | |
* Überprüfen, ob die `item_id` vom Typ `int` für `GET`- und `PUT`-Anfragen ist. |
* Provide 2 interactive documentation web interfaces directly. | ||
Um auf das vorherige Codebeispiel zurückzukommen, **FastAPI** wird: | ||
|
||
* Überprüfen Sie, dass es eine `item_id` im Pfad für `GET`- und `PUT`-Anfragen gibt. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
* Überprüfen Sie, dass es eine `item_id` im Pfad für `GET`- und `PUT`-Anfragen gibt. | |
* Überprüfen, dass es eine `item_id` im Pfad für `GET`- und `PUT`-Anfragen gibt. |
"Überprüfen Sie" would mean that you validate the requests and not FastAPI. Same for the rest of this enumeration.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ja, alle diese Sie
's werden von Google Translate fälschlich eingefügt, ich habe sie in meinem Edit unten alle herausgenommen.
@@ -167,9 +162,9 @@ def read_item(item_id: int, q: Optional[str] = None): | |||
``` | |||
|
|||
<details markdown="1"> | |||
<summary>Or use <code>async def</code>...</summary> | |||
<summary>Oder verwende <code>async def</code>...</summary> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If we stick to the formal 'Sie', it should be used here as well:
Oder verwenden Sie
|
||
Wenn Sie es nicht wissen, lesen Sie den Abschnitt _"In a hurry?"_ über <a href="https://fastapi.tiangolo.com/async/#in-a-hurry" target="_blank">`async` und `await` in der Dokumentation</a>. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Or:
Falls Sie es nicht kennen, lesen Sie den Abschnitt _"In a hurry?"_ über
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ich habe in meinem Edit geschrieben: "Wenn Sie das nicht verstehen, schauen Sie sich den Abschnitt "In Eile?" über async und await in der Dokumentation an."
Edit: wobei ich mittlerweile "Wenn Sie das nicht kennen" besser finde.
|
||
You will see the automatic interactive API documentation (provided by <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>): | ||
Sie sehen dann die automatische interaktive API-Dokumentation (bereitgestellt von <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a>): |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
missing comma: automatische, interaktive
|
||
You will see the alternative automatic documentation (provided by <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>): | ||
Sie sehen dann die alternative automatische Dokumentation (bereitgestellt von <a href="https://github.com/Rebilly/ReDoc" class="external-link" target="_blank">ReDoc</a>): |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
missing comma: alternative, automatische
|
||
Now modify the file `main.py` to receive a body from a `PUT` request. | ||
Ändern Sie nun die Datei `main.py`, um einen Body von einer `PUT`-Anfrage zu erhalten. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I wonder if the english wording is correct as there is only one body in a request.
Ändern Sie nun die Datei
main.py, um den Body einer
PUT`-Anfrage zu erhalten.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
In my edit, I first changed that to "Körper", but then I was not sure and changed it back to "body". Difficult to translate.
|
||
You don't have to learn a new syntax, the methods or classes of a specific library, etc. | ||
Sie müssen keine neue Syntax, die Methoden oder Klassen einer bestimmten Bibliothek usw. lernen. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Better remove 'die':
Sie müssen keine neue Syntax, Methoden oder Klassen einer bestimmten Bibliothek usw. lernen.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Stimme zu, ist in meinem Edit nicht enthalten.
* Validierung auch für tief verschachtelte JSON-Objekte. | ||
* <abbr title="auch bekannt als: serialization, parsing, marshalling">Konvertierung</abbr> von Eingabedaten: aus dem Netzwerk kommend in Python-Daten und -Typen. Lesen von: | ||
* JSON. | ||
* Pfad-Parameter. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
plural as in the english original:
Pfad-Parametern
* <abbr title="auch bekannt als: serialization, parsing, marshalling">Konvertierung</abbr> von Eingabedaten: aus dem Netzwerk kommend in Python-Daten und -Typen. Lesen von: | ||
* JSON. | ||
* Pfad-Parameter. | ||
* Abfrage-Parameter. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Abfrage-Parametern
* Abfrage-Parameter. | ||
* Cookies. | ||
* Kopfzeilen. | ||
* Formulare. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Formularen
* **CORS** | ||
* **Cookie Sessions** | ||
* ...and more. | ||
* Deklaration von **Parametern** von anderen verschiedenen Stellen wie: **Kopfzeilen**, **Cookies**, **Formularfelder** und **Dateien**. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"Kopfzeilen" could be ambiguous. Even in german I would stick to the english Headers
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"Header-Felder" würde ich nehmen, dann ist auch das RFC und die Wikipedia glücklich. Hab ich auch so in meinem unten erwähnten Edit verwendet.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would only suggest a few changes. Otherwise it's a pretty good translation.
docs/de/index.md
docs/de/docs/index.md
docs/de/docs/index.md
docs/de/docs/index.md
📝 Docs preview for commit 6159056 at: https://6499fb1121995400cb357f65--fastapi.netlify.app |
|
||
--- | ||
|
||
FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.6+ based on standard Python type hints. | ||
FastAPI ist ein modernes, schnelles (High-Performance) Web-Framework zur Erstellung von APIs mit Python 3.6+ auf Basis von Python type hints. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe "Typisierung" sounds better than the english type hints in german text?
|
||
The key features are: | ||
* **Schnell**: Sehr hohe Leistung, auf dem Niveau von **NodeJS** und **Go** (Dank an Starlette und Pydantic) [Eines der schnellsten verfügbaren Python-Frameworks](#performance). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes would remove the "an"
|
||
* **Fast**: Very high performance, on par with **NodeJS** and **Go** (thanks to Starlette and Pydantic). [One of the fastest Python frameworks available](#performance). | ||
* **Schnell zu programmieren**: Erhöhen Sie die Geschwindigkeit bei der Entwicklung von Funktionen um etwa 200% bis 300%. * |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"Erhöhen Sie die Entwicklungsgeschwindigkeit von neuen Funktionen um etwa 200% bis 300%." I would add the "neuen" here to not confuse this Funktionen with simple functions in Python (def).
|
||
* **Fast**: Very high performance, on par with **NodeJS** and **Go** (thanks to Starlette and Pydantic). [One of the fastest Python frameworks available](#performance). | ||
* **Schnell zu programmieren**: Erhöhen Sie die Geschwindigkeit bei der Entwicklung von Funktionen um etwa 200% bis 300%. * | ||
* **Weniger Bugs**: Reduzieren Sie etwa 40% der von Menschen (Entwicklern) verursachten Fehler. * |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"Vermeiden Sie etwa 40% der von Entwicklern verursachten Fehler."
@@ -107,16 +102,16 @@ The key features are: | |||
|
|||
If you are building a <abbr title="Command Line Interface">CLI</abbr> app to be used in the terminal instead of a web API, check out <a href="https://typer.tiangolo.com/" class="external-link" target="_blank">**Typer**</a>. | |||
|
|||
**Typer** is FastAPI's little sibling. And it's intended to be the **FastAPI of CLIs**. ⌨️ 🚀 | |||
**Typer** ist das kleine Schwesterchen von FastAPI. Und es soll die **FastAPI der CLIs** sein. ⌨️ 🚀 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would suggest "Typer ist FastAPIs kleine Schwester." as I believe it sounds better
Hallo Leute, Ich habe den PR mal "reviewed", wobei ich einiges editiert habe. Viele Änderungen wurden bereits von den anderen Reviewern oben vorgeschlagen, ich habe allerdings auch die Zitate ins Deutsche übersetzt. Außerdem habe ich mich am aktuellen englischen .md orientiert, welches ein paar Änderungen hat, etwa ein hinzugefügtes Zitat und geänderte Abhängigkeiten. Ich kann besser arbeiten, wenn ich die Dokumente (englisches .md, deutsches .md) und meinen Editor Seite an Seite habe. Darum habe ich alle Änderungen einfach in das Dokument geschrieben. Hier das geänderte Dokument als Anhang:
Wenn der Autor (@0x4Dark) oder die Reviewer das mal diffen mag und die Änderungen "committed" (falls es keine Einwände gibt), dann "approve" ich das ebenfalls. Gruß, Nils |
Ugh, mein Editor hat versehentlich die Einrückung von verschachtelten Listen zerschossen. Hier die gefixte Version, welche auch ein paar weitere kleine Korrekturen enthält: |
* Full translation * Based on tiangolo#3631 * In sync with current en/docs/index.md * Hand-translated (Google translate rarely used) * Checked for errors using LanguageTool * Manually checked
Based on tiangolo#3631 and tiangolo#3048
As this has been pending for a long time, let's continue @nilslindemann's work on this PR: #10283 That one is waiting for reviews. 🤓 For now, I'll close this one. ☕ |
As asked by @tiangolo, I split and updated the first part of the old pull request #3522.
Thanks to @AaronDewes for the reviews.