Skip to content
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

Closed

Conversation

0x4Dark
Copy link
Contributor

@0x4Dark 0x4Dark commented Jul 30, 2021

As asked by @tiangolo, I split and updated the first part of the old pull request #3522.
Thanks to @AaronDewes for the reviews.

@codecov
Copy link

codecov bot commented Jul 30, 2021

Codecov Report

Patch and project coverage have no change.

Comparison is base (cf73051) 100.00% compared to head (ef56820) 100.00%.

❗ Current head ef56820 differs from pull request most recent head 6159056. Consider uploading reports for the commit 6159056 to get more accurate results

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     

see 181 files with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

@github-actions
Copy link
Contributor

📝 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:
Copy link
Contributor

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?

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).
Copy link
Contributor

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 [...]

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* **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

Copy link

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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe Webinhalteand Dateninhalte instead of -teile

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:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Starten Sie den Server:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tunis not so nice german, maybe use Aktivieren Sie dies nur während der Entwicklung, another alternative would be Benutzen.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* `--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

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.

@tiangolo
Copy link
Owner

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. 🤓

#3716

@tiangolo tiangolo added awaiting-review lang-all Translations lang-de German translations labels Aug 18, 2021
@github-actions github-actions bot mentioned this pull request Aug 18, 2021
Copy link

@montesilva montesilva left a 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>

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<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).

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* **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:

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:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* `--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.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* 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.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* 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.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* 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.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* Ü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.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* Ü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.

Copy link
Contributor

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>

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>.

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

Copy link
Contributor

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>):

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>):

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.

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.

Copy link
Contributor

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.

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.

Copy link
Contributor

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.

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.

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.

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**.

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

Copy link
Contributor

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.

Copy link

@rogerbrinkmann rogerbrinkmann left a 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.

@tiangolo tiangolo changed the title 🌐 Add german translation for docs/de/index.md 🌐 Add german translation for docs/de/docs/index.md Jun 26, 2023
@tiangolo tiangolo changed the title 🌐 Add german translation for docs/de/docs/index.md 🌐 Add German translation for docs/de/docs/index.md Jun 26, 2023
@tiangolo
Copy link
Owner

📝 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.
Copy link

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).
Copy link

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%. *
Copy link

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. *
Copy link

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. ⌨️ 🚀
Copy link

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

@nilslindemann
Copy link
Contributor

nilslindemann commented Sep 17, 2023

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:

index.md Enthält falsch formatiere Listen. Bitte die Version vom Post unten verwenden.

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

@nilslindemann
Copy link
Contributor

nilslindemann commented Sep 17, 2023

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:

index.md

nilslindemann added a commit to nilslindemann/fastapi that referenced this pull request Sep 20, 2023
* 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
nilslindemann added a commit to nilslindemann/fastapi that referenced this pull request Sep 20, 2023
@tiangolo
Copy link
Owner

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. ☕

@tiangolo tiangolo closed this Jan 15, 2024
@nilslindemann
Copy link
Contributor

Thanks, @tiangolo, and thanks @0x4Dark, your work is surviving in that PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
awaiting-review lang-all Translations lang-de German translations
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

7 participants