From 73f39c4d5a383e6d2606fd931edb28b9788fbdb8 Mon Sep 17 00:00:00 2001 From: Nils Lindemann Date: Tue, 26 Sep 2023 00:31:10 +0200 Subject: [PATCH 01/10] Add German translation of docs/tutorial/cookie-params.md * Full translation * In sync with current en/docs/tutorial/cookie-params.md * Manually translated (Google translate rarely used) * Checked for errors using LanguageTool * Manually checked --- docs/de/docs/tutorial/cookie-params.md | 97 ++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 docs/de/docs/tutorial/cookie-params.md diff --git a/docs/de/docs/tutorial/cookie-params.md b/docs/de/docs/tutorial/cookie-params.md new file mode 100644 index 0000000000000..8e5b8c07915b9 --- /dev/null +++ b/docs/de/docs/tutorial/cookie-params.md @@ -0,0 +1,97 @@ +# Cookie-Parameter + +So wie `Query`- und `Path`-Parameter können Sie auch Cookie-Parameter definieren. + +## `Cookie` importieren + +Importieren Sie zuerst `Cookie`: + +=== "Python 3.10+" + + ```Python hl_lines="3" + {!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!} + ``` + +=== "Python 3.9+" + + ```Python hl_lines="3" + {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!} + ``` + +=== "Python 3.6+" + + ```Python hl_lines="3" + {!> ../../../docs_src/cookie_params/tutorial001_an.py!} + ``` + +=== "Python 3.10+ nicht annotiert" + + !!! tip + Bevorzugen Sie die `Annotated`-Version, falls möglich. + + ```Python hl_lines="1" + {!> ../../../docs_src/cookie_params/tutorial001_py310.py!} + ``` + +=== "Python 3.6+ nicht annotiert" + + !!! tip + Bevorzugen Sie die `Annotated`-Version, falls möglich. + + ```Python hl_lines="3" + {!> ../../../docs_src/cookie_params/tutorial001.py!} + ``` + +## `Cookie`-Parameter deklarieren + +Dann deklarieren Sie Cookie-Parameter, auf die gleiche Weise, wie Sie auch `Path` und `Query`-Parameter deklarieren. + +Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra-Validierungs- und Beschreibungs-Parameter hinzufügen. Danach können Sie einen Defaultwert vergeben: + +=== "Python 3.10+" + + ```Python hl_lines="9" + {!> ../../../docs_src/cookie_params/tutorial001_an_py310.py!} + ``` + +=== "Python 3.9+" + + ```Python hl_lines="9" + {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!} + ``` + +=== "Python 3.6+" + + ```Python hl_lines="10" + {!> ../../../docs_src/cookie_params/tutorial001_an.py!} + ``` + +=== "Python 3.10+ nicht annotiert" + + !!! tip + Bevorzugen Sie die `Annotated`-Version, falls möglich. + + ```Python hl_lines="7" + {!> ../../../docs_src/cookie_params/tutorial001_py310.py!} + ``` + +=== "Python 3.6+ nicht annotiert" + + !!! tip + Bevorzugen Sie die `Annotated`-Version, falls möglich. + + ```Python hl_lines="9" + {!> ../../../docs_src/cookie_params/tutorial001.py!} + ``` + +!!! Hinweis "Technische Details" + `Cookie` ist eine Schwesterklasse von `Path` und `Query`. Sie erbt von derselben gemeinsamen `Param`-Elternklasse. + + Aber erinnern Sie sich, dass, wenn Sie `Query`, `Path` und `Cookie` von `fastapi` importieren, diese tatsächlich Funktionen sind, welche spezielle Klassen zurückgeben. + +!!! info + Um Cookies zu deklarieren, müssen Sie `Cookie` verwenden, da diese Parameter sonst als Query-Parameter interpretiert werden würden. + +## Rekapitulation + +Deklarieren Sie Cookies mittels `Cookie`, auf die gleiche Weise wie bei `Query` und `Path`. From ca600320ea088a6ea4131e9c8c5f9de6c0fe3a2c Mon Sep 17 00:00:00 2001 From: Nils Lindemann Date: Tue, 26 Sep 2023 01:38:56 +0200 Subject: [PATCH 02/10] Forgot a hyphen --- docs/de/docs/tutorial/cookie-params.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/de/docs/tutorial/cookie-params.md b/docs/de/docs/tutorial/cookie-params.md index 8e5b8c07915b9..f9298b4d91845 100644 --- a/docs/de/docs/tutorial/cookie-params.md +++ b/docs/de/docs/tutorial/cookie-params.md @@ -44,7 +44,7 @@ Importieren Sie zuerst `Cookie`: ## `Cookie`-Parameter deklarieren -Dann deklarieren Sie Cookie-Parameter, auf die gleiche Weise, wie Sie auch `Path` und `Query`-Parameter deklarieren. +Dann deklarieren Sie Cookie-Parameter, auf die gleiche Weise, wie Sie auch `Path`- und `Query`-Parameter deklarieren. Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra-Validierungs- und Beschreibungs-Parameter hinzufügen. Danach können Sie einen Defaultwert vergeben: From 46dfa2594a932fb581f63107b1c10ebc69daa7bc Mon Sep 17 00:00:00 2001 From: Nils Lindemann Date: Tue, 26 Sep 2023 01:50:17 +0200 Subject: [PATCH 03/10] More precise translation --- docs/de/docs/tutorial/cookie-params.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/de/docs/tutorial/cookie-params.md b/docs/de/docs/tutorial/cookie-params.md index f9298b4d91845..fdada23b1cd54 100644 --- a/docs/de/docs/tutorial/cookie-params.md +++ b/docs/de/docs/tutorial/cookie-params.md @@ -87,7 +87,7 @@ Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra-Validierungs !!! Hinweis "Technische Details" `Cookie` ist eine Schwesterklasse von `Path` und `Query`. Sie erbt von derselben gemeinsamen `Param`-Elternklasse. - Aber erinnern Sie sich, dass, wenn Sie `Query`, `Path` und `Cookie` von `fastapi` importieren, diese tatsächlich Funktionen sind, welche spezielle Klassen zurückgeben. + Aber erinnern Sie sich, dass, wenn Sie `Query`, `Path`, `Cookie` und andere von `fastapi` importieren, diese tatsächlich Funktionen sind, welche spezielle Klassen zurückgeben. !!! info Um Cookies zu deklarieren, müssen Sie `Cookie` verwenden, da diese Parameter sonst als Query-Parameter interpretiert werden würden. From fdc0e23e18e2e08743ea35ecaf3b277e216b2ff4 Mon Sep 17 00:00:00 2001 From: Nils Lindemann Date: Tue, 26 Sep 2023 02:49:52 +0200 Subject: [PATCH 04/10] Fix formatting Translating the text would change the icon and coloring of the box --- docs/de/docs/tutorial/cookie-params.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/de/docs/tutorial/cookie-params.md b/docs/de/docs/tutorial/cookie-params.md index fdada23b1cd54..85aa2abb76f4e 100644 --- a/docs/de/docs/tutorial/cookie-params.md +++ b/docs/de/docs/tutorial/cookie-params.md @@ -84,7 +84,7 @@ Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra-Validierungs {!> ../../../docs_src/cookie_params/tutorial001.py!} ``` -!!! Hinweis "Technische Details" +!!! note "Technische Details" `Cookie` ist eine Schwesterklasse von `Path` und `Query`. Sie erbt von derselben gemeinsamen `Param`-Elternklasse. Aber erinnern Sie sich, dass, wenn Sie `Query`, `Path`, `Cookie` und andere von `fastapi` importieren, diese tatsächlich Funktionen sind, welche spezielle Klassen zurückgeben. From 455bfae829a7daced5243cb7639e00bb924f1ff0 Mon Sep 17 00:00:00 2001 From: Nils Lindemann Date: Tue, 26 Sep 2023 03:15:22 +0200 Subject: [PATCH 05/10] Add missing word --- docs/de/docs/tutorial/cookie-params.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/de/docs/tutorial/cookie-params.md b/docs/de/docs/tutorial/cookie-params.md index 85aa2abb76f4e..258dffac03e88 100644 --- a/docs/de/docs/tutorial/cookie-params.md +++ b/docs/de/docs/tutorial/cookie-params.md @@ -44,7 +44,7 @@ Importieren Sie zuerst `Cookie`: ## `Cookie`-Parameter deklarieren -Dann deklarieren Sie Cookie-Parameter, auf die gleiche Weise, wie Sie auch `Path`- und `Query`-Parameter deklarieren. +Dann deklarieren Sie Ihre Cookie-Parameter, auf die gleiche Weise, wie Sie auch `Path`- und `Query`-Parameter deklarieren. Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra-Validierungs- und Beschreibungs-Parameter hinzufügen. Danach können Sie einen Defaultwert vergeben: From 440f3405471ba16dfd4cb378bddf00282e3d0043 Mon Sep 17 00:00:00 2001 From: Nils Lindemann Date: Thu, 5 Oct 2023 04:23:18 +0200 Subject: [PATCH 06/10] "Rekapitulation" -> "Zusammenfassung" --- docs/de/docs/tutorial/cookie-params.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/de/docs/tutorial/cookie-params.md b/docs/de/docs/tutorial/cookie-params.md index 258dffac03e88..f2461e7f3bf3e 100644 --- a/docs/de/docs/tutorial/cookie-params.md +++ b/docs/de/docs/tutorial/cookie-params.md @@ -92,6 +92,6 @@ Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra-Validierungs !!! info Um Cookies zu deklarieren, müssen Sie `Cookie` verwenden, da diese Parameter sonst als Query-Parameter interpretiert werden würden. -## Rekapitulation +## Zusammenfassung Deklarieren Sie Cookies mittels `Cookie`, auf die gleiche Weise wie bei `Query` und `Path`. From d92fc2016acf43fa01b405cbaedbf4476338a7e2 Mon Sep 17 00:00:00 2001 From: Nils Lindemann Date: Tue, 17 Oct 2023 20:23:09 +0200 Subject: [PATCH 07/10] Sync with #10442 --- docs/de/docs/tutorial/cookie-params.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/de/docs/tutorial/cookie-params.md b/docs/de/docs/tutorial/cookie-params.md index f2461e7f3bf3e..f27df7a0122d0 100644 --- a/docs/de/docs/tutorial/cookie-params.md +++ b/docs/de/docs/tutorial/cookie-params.md @@ -18,7 +18,7 @@ Importieren Sie zuerst `Cookie`: {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!} ``` -=== "Python 3.6+" +=== "Python 3.8+" ```Python hl_lines="3" {!> ../../../docs_src/cookie_params/tutorial001_an.py!} @@ -33,7 +33,7 @@ Importieren Sie zuerst `Cookie`: {!> ../../../docs_src/cookie_params/tutorial001_py310.py!} ``` -=== "Python 3.6+ nicht annotiert" +=== "Python 3.8+ nicht annotiert" !!! tip Bevorzugen Sie die `Annotated`-Version, falls möglich. @@ -60,7 +60,7 @@ Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra-Validierungs {!> ../../../docs_src/cookie_params/tutorial001_an_py39.py!} ``` -=== "Python 3.6+" +=== "Python 3.8+" ```Python hl_lines="10" {!> ../../../docs_src/cookie_params/tutorial001_an.py!} @@ -75,7 +75,7 @@ Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra-Validierungs {!> ../../../docs_src/cookie_params/tutorial001_py310.py!} ``` -=== "Python 3.6+ nicht annotiert" +=== "Python 3.8+ nicht annotiert" !!! tip Bevorzugen Sie die `Annotated`-Version, falls möglich. From 52a19682846dd553568b868a791db1a579c74e4a Mon Sep 17 00:00:00 2001 From: Nils Lindemann Date: Sun, 22 Oct 2023 18:22:55 +0200 Subject: [PATCH 08/10] "Tip" -> "Tipp" --- docs/de/docs/tutorial/cookie-params.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/de/docs/tutorial/cookie-params.md b/docs/de/docs/tutorial/cookie-params.md index f27df7a0122d0..d591005473c02 100644 --- a/docs/de/docs/tutorial/cookie-params.md +++ b/docs/de/docs/tutorial/cookie-params.md @@ -26,7 +26,7 @@ Importieren Sie zuerst `Cookie`: === "Python 3.10+ nicht annotiert" - !!! tip + !!! tip "Tipp" Bevorzugen Sie die `Annotated`-Version, falls möglich. ```Python hl_lines="1" @@ -35,7 +35,7 @@ Importieren Sie zuerst `Cookie`: === "Python 3.8+ nicht annotiert" - !!! tip + !!! tip "Tipp" Bevorzugen Sie die `Annotated`-Version, falls möglich. ```Python hl_lines="3" @@ -68,7 +68,7 @@ Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra-Validierungs === "Python 3.10+ nicht annotiert" - !!! tip + !!! tip "Tipp" Bevorzugen Sie die `Annotated`-Version, falls möglich. ```Python hl_lines="7" @@ -77,7 +77,7 @@ Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra-Validierungs === "Python 3.8+ nicht annotiert" - !!! tip + !!! tip "Tipp" Bevorzugen Sie die `Annotated`-Version, falls möglich. ```Python hl_lines="9" From fbe44439dfcaff92171acfe136645c472c37686e Mon Sep 17 00:00:00 2001 From: Nils Lindemann Date: Sun, 29 Oct 2023 04:57:05 +0100 Subject: [PATCH 09/10] Use typographic quotes --- docs/de/docs/tutorial/cookie-params.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/de/docs/tutorial/cookie-params.md b/docs/de/docs/tutorial/cookie-params.md index d591005473c02..168e7b1648b7a 100644 --- a/docs/de/docs/tutorial/cookie-params.md +++ b/docs/de/docs/tutorial/cookie-params.md @@ -1,6 +1,6 @@ # Cookie-Parameter -So wie `Query`- und `Path`-Parameter können Sie auch Cookie-Parameter definieren. +So wie `Query`- und `Path`-Parameter können Sie auch Cookie-Parameter definieren. ## `Cookie` importieren From 547ac66ab71a320bb6f98d1f68a45e65a8ad648d Mon Sep 17 00:00:00 2001 From: Nils Lindemann Date: Thu, 28 Dec 2023 20:55:20 +0100 Subject: [PATCH 10/10] Remove "-" --- docs/de/docs/tutorial/cookie-params.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/de/docs/tutorial/cookie-params.md b/docs/de/docs/tutorial/cookie-params.md index 168e7b1648b7a..c95e28c7dc6d8 100644 --- a/docs/de/docs/tutorial/cookie-params.md +++ b/docs/de/docs/tutorial/cookie-params.md @@ -46,7 +46,7 @@ Importieren Sie zuerst `Cookie`: Dann deklarieren Sie Ihre Cookie-Parameter, auf die gleiche Weise, wie Sie auch `Path`- und `Query`-Parameter deklarieren. -Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra-Validierungs- und Beschreibungs-Parameter hinzufügen. Danach können Sie einen Defaultwert vergeben: +Der erste Wert ist der Typ. Sie können `Cookie` die gehabten Extra Validierungs- und Beschreibungsparameter hinzufügen. Danach können Sie einen Defaultwert vergeben: === "Python 3.10+"