]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
๐ŸŒ Add Korean translation for `/docs/ko/docs/tutorial/cookie-params.md` (#11118)
author๊น€๋ช…๊ธฐ <riroan@naver.com>
Fri, 9 Feb 2024 10:34:57 +0000 (19:34 +0900)
committerGitHub <noreply@github.com>
Fri, 9 Feb 2024 10:34:57 +0000 (05:34 -0500)
docs/ko/docs/tutorial/cookie-params.md [new file with mode: 0644]

diff --git a/docs/ko/docs/tutorial/cookie-params.md b/docs/ko/docs/tutorial/cookie-params.md
new file mode 100644 (file)
index 0000000..d4f3d57
--- /dev/null
@@ -0,0 +1,97 @@
+# ์ฟ ํ‚ค ๋งค๊ฐœ๋ณ€์ˆ˜
+
+์ฟ ํ‚ค ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ `Query`์™€ `Path` ๋งค๊ฐœ๋ณ€์ˆ˜๋“ค๊ณผ ๊ฐ™์€ ๋ฐฉ์‹์œผ๋กœ ์ •์˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
+
+## `Cookie` ์ž„ํฌํŠธ
+
+๋จผ์ € `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.8+"
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ Annotated๊ฐ€ ์—†๋Š” ๊ฒฝ์šฐ"
+
+    !!! tip "ํŒ"
+        ๊ฐ€๋Šฅํ•˜๋‹ค๋ฉด `Annotated`๊ฐ€ ๋‹ฌ๋ฆฐ ๋ฒ„์ „์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค.
+
+    ```Python hl_lines="1"
+    {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ Annotated๊ฐ€ ์—†๋Š” ๊ฒฝ์šฐ"
+
+    !!! tip "ํŒ"
+        ๊ฐ€๋Šฅํ•˜๋‹ค๋ฉด `Annotated`๊ฐ€ ๋‹ฌ๋ฆฐ ๋ฒ„์ „์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค.
+
+    ```Python hl_lines="3"
+    {!> ../../../docs_src/cookie_params/tutorial001.py!}
+    ```
+
+## `Cookie` ๋งค๊ฐœ๋ณ€์ˆ˜ ์„ ์–ธ
+
+๊ทธ๋Ÿฐ ๋‹ค์Œ, `Path`์™€ `Query`์ฒ˜๋Ÿผ ๋™์ผํ•œ ๊ตฌ์กฐ๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ์ฟ ํ‚ค ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ ์„ ์–ธํ•ฉ๋‹ˆ๋‹ค.
+
+์ฒซ ๋ฒˆ์งธ ๊ฐ’์€ ๊ธฐ๋ณธ๊ฐ’์ด๋ฉฐ, ์ถ”๊ฐ€ ๊ฒ€์ฆ์ด๋‚˜ ์–ด๋…ธํ…Œ์ด์…˜ ๋งค๊ฐœ๋ณ€์ˆ˜ ๋ชจ๋‘ ์ „๋‹ฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:
+
+=== "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.8+"
+
+    ```Python hl_lines="10"
+    {!> ../../../docs_src/cookie_params/tutorial001_an.py!}
+    ```
+
+=== "Python 3.10+ Annotated๊ฐ€ ์—†๋Š” ๊ฒฝ์šฐ"
+
+    !!! tip "ํŒ"
+        ๊ฐ€๋Šฅํ•˜๋‹ค๋ฉด `Annotated`๊ฐ€ ๋‹ฌ๋ฆฐ ๋ฒ„์ „์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค.
+
+    ```Python hl_lines="7"
+    {!> ../../../docs_src/cookie_params/tutorial001_py310.py!}
+    ```
+
+=== "Python 3.8+ Annotated๊ฐ€ ์—†๋Š” ๊ฒฝ์šฐ"
+
+    !!! tip "ํŒ"
+        ๊ฐ€๋Šฅํ•˜๋‹ค๋ฉด `Annotated`๊ฐ€ ๋‹ฌ๋ฆฐ ๋ฒ„์ „์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค.
+
+    ```Python hl_lines="9"
+    {!> ../../../docs_src/cookie_params/tutorial001.py!}
+    ```
+
+!!! note "๊ธฐ์ˆ  ์„ธ๋ถ€์‚ฌํ•ญ"
+    `Cookie`๋Š” `Path` ๋ฐ `Query`์˜ "์ž๋งค"ํด๋ž˜์Šค์ž…๋‹ˆ๋‹ค. ์ด ์—ญ์‹œ ๋™์ผํ•œ ๊ณตํ†ต `Param` ํด๋ž˜์Šค๋ฅผ ์ƒ์†ํ•ฉ๋‹ˆ๋‹ค.
+
+    `Query`, `Path`, `Cookie` ๊ทธ๋ฆฌ๊ณ  ๋‹ค๋ฅธ ๊ฒƒ๋“ค์€ `fastapi`์—์„œ ์ž„ํฌํŠธ ํ•  ๋•Œ, ์‹ค์ œ๋กœ๋Š” ํŠน๋ณ„ํ•œ ํด๋ž˜์Šค๋ฅผ ๋ฐ˜ํ™˜ํ•˜๋Š” ํ•จ์ˆ˜์ž„์„ ๊ธฐ์–ตํ•˜์„ธ์š”.
+
+!!! info "์ •๋ณด"
+    ์ฟ ํ‚ค๋ฅผ ์„ ์–ธํ•˜๊ธฐ ์œ„ํ•ด์„œ๋Š” `Cookie`๋ฅผ ์‚ฌ์šฉํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ๊ทธ๋ ‡์ง€ ์•Š์œผ๋ฉด ํ•ด๋‹น ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ ์ฟผ๋ฆฌ ๋งค๊ฐœ๋ณ€์ˆ˜๋กœ ํ•ด์„ํ•˜๊ธฐ ๋•Œ๋ฌธ์ž…๋‹ˆ๋‹ค.
+
+## ์š”์•ฝ
+
+`Cookie`๋Š” `Query`, `Path`์™€ ๋™์ผํ•œ ํŒจํ„ด์„ ์‚ฌ์šฉํ•˜์—ฌ ์„ ์–ธํ•ฉ๋‹ˆ๋‹ค.