]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Add Korean translation for `docs/ko/docs/tutorial/static-files.md` (#2957)
authorJeesang Kim <jeenowden@gmail.com>
Mon, 22 Jan 2024 19:42:37 +0000 (04:42 +0900)
committerGitHub <noreply@github.com>
Mon, 22 Jan 2024 19:42:37 +0000 (14:42 -0500)
docs/ko/docs/tutorial/static-files.md [new file with mode: 0644]

diff --git a/docs/ko/docs/tutorial/static-files.md b/docs/ko/docs/tutorial/static-files.md
new file mode 100644 (file)
index 0000000..fe1aa4e
--- /dev/null
@@ -0,0 +1,40 @@
+# μ •적 νŒŒμΌ
+
+'StaticFiles'λ₯Ό μ‚¬μš©ν•˜μ—¬ λ””λ ‰ν† λ¦¬μ—μ„œ μ •적 νŒŒμΌμ„ μžλ™μœΌλ‘œ μ œκ³΅ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+## `StaticFiles` μ‚¬μš©
+
+* `StaticFiles` μž„ν¬νŠΈν•©λ‹ˆλ‹€.
+* νŠΉμ • κ²½λ‘œμ— `StaticFiles()` μΈμŠ€ν„΄μŠ€λ₯Ό "마운트" ν•©λ‹ˆλ‹€.
+
+```Python hl_lines="2  6"
+{!../../../docs_src/static_files/tutorial001.py!}
+```
+
+!!! note "기술적 μ„ΈλΆ€μ‚¬ν•­"
+    `from starlette.staticfiles import StaticFiles` λ₯Ό μ‚¬μš©ν•  μˆ˜λ„ μžˆμŠ΅λ‹ˆλ‹€\1c.
+
+    **FastAPI**λŠ” λ‹¨μ§€ κ°œλ°œμžμΈ, λ‹Ήμ‹ μ—κ²Œ νŽΈμ˜λ₯Ό μ œκ³΅ν•˜κΈ° μœ„ν•΄ `fastapi.static files` μ™€ λ™μΌν•œ `starlett.static files`λ₯Ό μ œκ³΅ν•©λ‹ˆλ‹€. ν•˜μ§€λ§Œ μ‚¬μ‹€ μ΄κ²ƒμ€ Starlettμ—μ„œ μ§μ ‘ μ˜¨ κ²ƒμž…λ‹ˆλ‹€.
+
+### "λ§ˆμš΄νŒ…" μ΄λž€
+
+"λ§ˆμš΄νŒ…"은 νŠΉμ • κ²½λ‘œμ— μ™„μ „νžˆ "독립적인" μ• ν”Œλ¦¬μΌ€μ΄μ…˜μ„ μΆ”κ°€ν•˜λŠ” κ²ƒμ„ μ˜λ―Έν•˜λŠ”λ°, κ·Έ ν›„ λͺ¨λ“  ν•˜μœ„ κ²½λ‘œμ— λŒ€ν•΄μ„œλ„ μ μš©λ©λ‹ˆλ‹€.
+
+마운트된 μ‘μš© ν”„λ‘œκ·Έλž¨μ€ μ™„μ „νžˆ λ…립적이기 λ•Œλ¬Έμ— `APIRouter`λ₯Ό μ‚¬μš©ν•˜λŠ” κ²ƒκ³ΌλŠ” λ‹€λ¦…λ‹ˆλ‹€. OpenAPI λ° μ‘μš© ν”„λ‘œκ·Έλž¨μ˜ λ¬Έμ„œλŠ” λ§ˆμš΄νŠΈλœ μ‘μš© ν”„λ‘œκ·Έλž¨ λ“±μ—μ„œ μ–΄λ–€ κ²ƒλ„ ν¬ν•¨ν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.
+
+μžμ„Έν•œ λ‚΄μš©μ€ **μˆ™λ ¨λœ μ‚¬μš©μž μ•ˆλ‚΄μ„œ**μ—μ„œ ν™•인할 μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+## μ„ΈλΆ€μ‚¬ν•­
+
+첫 λ²ˆμ§Έ `"/static"`은 μ΄ "ν•˜μœ„ μ‘μš© ν”„λ‘œκ·Έλž¨"이 "마운트"될 ν•˜μœ„ κ²½λ‘œλ₯Ό κ°€λ¦¬ν‚΅λ‹ˆλ‹€. λ”°λΌμ„œ `"/static"`으둜 μ‹œμž‘ν•˜λŠ” λͺ¨λ“  κ²½λ‘œλŠ” `"/static"`으둜 μ²˜λ¦¬λ©λ‹ˆλ‹€.
+
+`'directory="static"`은 μ •적 νŒŒμΌμ΄ λ“€μ–΄ μžˆλŠ” λ””λ ‰ν† λ¦¬μ˜ μ΄λ¦„을 λ‚˜νƒ€λƒ…λ‹ˆλ‹€.
+
+`name="static"`은 **FastAPI**μ—μ„œ λ‚΄λΆ€μ μœΌλ‘œ μ‚¬μš©ν•  μˆ˜ μžˆλŠ” μ΄λ¦„을 μ œκ³΅ν•©λ‹ˆλ‹€.
+
+이 λͺ¨λ“  λ§€κ°œλ³€μˆ˜λŠ” "`static`"κ³Ό λ‹€λ₯Ό μˆ˜ μžˆμœΌλ©°, μ‚¬μš©μž μ‘μš© ν”„λ‘œκ·Έλž¨μ˜ μš”ꡬ μ‚¬ν•­ λ° κ΅¬μ²΄μ μΈ μ„ΈλΆ€ μ •보에 λ”°λΌ λ§€κ°œλ³€μˆ˜λ₯Ό μ‘°μ •ν•  μˆ˜ μžˆμŠ΅λ‹ˆλ‹€.
+
+
+## μΆ”κ°€ μ •보
+
+μžμ„Έν•œ λ‚΄μš©κ³Ό μ„ νƒ μ‚¬ν•­μ„ λ³΄λ €λ©΄ <a href="https://www.starlette.io/staticfiles/" class="external-link" target="_blank">Starlette의 μ •적 νŒŒμΌμ— κ΄€ν•œ λ¬Έμ„œ</a>λ₯Ό ν™•μΈν•˜μ‹­μ‹œμ˜€.