Browse Source

๐ŸŒ Add Korean translation for Tutorial - Intro (#2317)

Co-authored-by: Dahun Jeong <[email protected]>
pull/3031/head
Spike 4 years ago
committed by GitHub
parent
commit
973595b3cb
No known key found for this signature in database GPG Key ID: 4AEE18F83AFDEB23
  1. 80
      docs/ko/docs/tutorial/index.md
  2. 2
      docs/ko/mkdocs.yml

80
docs/ko/docs/tutorial/index.md

@ -0,0 +1,80 @@
# ์ž์Šต์„œ - ์‚ฌ์šฉ์ž ์•ˆ๋‚ด์„œ - ๋„์ž…๋ถ€
์ด ์ž์Šต์„œ๋Š” **FastAPI**์˜ ๋Œ€๋ถ€๋ถ„์˜ ๊ธฐ๋Šฅ์„ ๋‹จ๊ณ„๋ณ„๋กœ ์‚ฌ์šฉํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ๋ณด์—ฌ์ค๋‹ˆ๋‹ค.
๊ฐ ์„น์…˜์€ ์ด์ „ ์„น์…˜์„ ๊ธฐ๋ฐ˜ํ•ด์„œ ์ ์ง„์ ์œผ๋กœ ๋งŒ๋“ค์–ด ์กŒ์ง€๋งŒ, ์ฃผ์ œ๋ฅผ ๊ตฌ๋ถ„ํ•˜์—ฌ ๊ตฌ์„ฑ ๋˜์—ˆ๊ธฐ ๋•Œ๋ฌธ์— ํŠน์ • API ์š”๊ตฌ์‚ฌํ•ญ์„ ํ•ด๊ฒฐํ•˜๊ธฐ ์œ„ํ•ด ์–ด๋–ค ํŠน์ • ํ•ญ๋ชฉ์ด๋˜์ง€ ์ง์ ‘ ์ด๋™ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
๋˜ํ•œ ํ–ฅํ›„ ์ฐธ์กฐ๊ฐ€ ๋  ์ˆ˜ ์žˆ๋„๋ก ๋งŒ๋“ค์–ด์กŒ์Šต๋‹ˆ๋‹ค.
๊ทธ๋Ÿฌ๋ฏ€๋กœ ๋‹ค์‹œ ๋Œ์•„์™€์„œ ์ •ํ™•ํžˆ ํ•„์š”ํ•œ ๊ฒƒ์„ ๋ณผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
## ์ฝ”๋“œ ์‹คํ–‰ํ•˜๊ธฐ
๋ชจ๋“  ์ฝ”๋“œ ๋ธ”๋ก์€ ๋ณต์‚ฌํ•˜๊ณ  ์ง์ ‘ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค(์‹ค์ œ๋กœ ํ…Œ์ŠคํŠธํ•œ ํŒŒ์ด์ฌ ํŒŒ์ผ์ž…๋‹ˆ๋‹ค).
์˜ˆ์ œ๋ฅผ ์‹คํ–‰ํ•˜๋ ค๋ฉด ์ฝ”๋“œ๋ฅผ `main.py` ํŒŒ์ผ์— ๋ณต์‚ฌํ•˜๊ณ  ๋‹ค์Œ์„ ์‚ฌ์šฉํ•˜์—ฌ `uvicorn`์„ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค:
<div class="termy">
```console
$ uvicorn main:app --reload
<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
<span style="color: green;">INFO</span>: Started reloader process [28720]
<span style="color: green;">INFO</span>: Started server process [28722]
<span style="color: green;">INFO</span>: Waiting for application startup.
<span style="color: green;">INFO</span>: Application startup complete.
```
</div>
์ฝ”๋“œ๋ฅผ ์ž‘์„ฑํ•˜๊ฑฐ๋‚˜ ๋ณต์‚ฌ, ํŽธ์ง‘ํ•  ๋•Œ, ๋กœ์ปฌ์—์„œ ์‹คํ–‰ํ•˜๋Š” ๊ฒƒ์„ **๊ฐ•๋ ฅํžˆ ์žฅ๋ ค**ํ•ฉ๋‹ˆ๋‹ค.
ํŽธ์ง‘๊ธฐ์—์„œ ์ด๋ ‡๊ฒŒ ์‚ฌ์šฉํ•˜๋ฉด, ๋ชจ๋“  ํƒ€์ž… ๊ฒ€์‚ฌ, ์ž๋™์™„์„ฑ ๋“ฑ ์ž‘์„ฑํ•ด์•ผ ํ•˜๋Š” ์ฝ”๋“œ๊ฐ€ ์–ผ๋งˆ๋‚˜ ์ ์€์ง€ ๋ณด๋ฉด์„œ FastAPI์˜ ์žฅ์ ์„ ์‹ค์ œ๋กœ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
---
## FastAPI ์„ค์น˜
์ฒซ ๋ฒˆ์งธ ๋‹จ๊ณ„๋Š” FastAPI ์„ค์น˜์ž…๋‹ˆ๋‹ค.
์ž์Šต์‹œ์—๋Š” ๋ชจ๋“  ์„ ํƒ์ ์ธ ์˜์กด์„ฑ ๋ฐ ๊ธฐ๋Šฅ์„ ์‚ฌ์šฉํ•˜์—ฌ ์„ค์น˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:
<div class="termy">
```console
$ pip install fastapi[all]
---> 100%
```
</div>
...์ฝ”๋“œ๋ฅผ ์‹คํ–‰ํ•˜๋Š” ์„œ๋ฒ„๋กœ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋Š” `uvicorn` ์—ญ์‹œ ํฌํ•จํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.
!!! note "์ฐธ๊ณ "
๋ถ€๋ถ„์ ์œผ๋กœ ์„ค์น˜ํ•  ์ˆ˜๋„ ์žˆ์Šต๋‹ˆ๋‹ค.
์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์šด์˜ ํ™˜๊ฒฝ์— ๋ฐฐํฌํ•˜๋ ค๋Š” ๊ฒฝ์šฐ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ํ•ฉ๋‹ˆ๋‹ค:
```
pip install fastapi
```
์ถ”๊ฐ€๋กœ ์„œ๋ฒ„ ์—ญํ• ์„ ํ•˜๋Š” `uvicorn`์„ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค:
```
pip install uvicorn
```
์‚ฌ์šฉํ•˜๋ ค๋Š” ๊ฐ ์„ ํƒ์ ์ธ ์˜์กด์„ฑ์— ๋Œ€ํ•ด์„œ๋„ ๋™์ผํ•ฉ๋‹ˆ๋‹ค.
## ๊ณ ๊ธ‰ ์‚ฌ์šฉ์ž ์•ˆ๋‚ด์„œ
์ด **์ž์Šต์„œ - ์‚ฌ์šฉ์ž ์•ˆ๋‚ด์„œ** ๋‹ค์Œ์— ์ฝ์„ ์ˆ˜ ์žˆ๋Š” **๊ณ ๊ธ‰ ์‚ฌ์šฉ์ž ์•ˆ๋‚ด์„œ**๋„ ์žˆ์Šต๋‹ˆ๋‹ค.
**๊ณ ๊ธ‰ ์‚ฌ์šฉ์ž ์•ˆ๋‚ด์„œ**๋Š” ํ˜„์žฌ ๋ฌธ์„œ๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ํ•˜๊ณ , ๋™์ผํ•œ ๊ฐœ๋…์„ ์‚ฌ์šฉํ•˜๋ฉฐ, ์ถ”๊ฐ€ ๊ธฐ๋Šฅ๋“ค์„ ์•Œ๋ ค์ค๋‹ˆ๋‹ค.
ํ•˜์ง€๋งŒ (์ง€๊ธˆ ์ฝ๊ณ  ์žˆ๋Š”) **์ž์Šต์„œ - ์‚ฌ์šฉ์ž ์•ˆ๋‚ด์„œ**๋ฅผ ๋จผ์ € ์ฝ๋Š”๊ฒŒ ์ข‹์Šต๋‹ˆ๋‹ค.
**์ž์Šต์„œ - ์‚ฌ์šฉ์ž ์•ˆ๋‚ด์„œ**๋งŒ์œผ๋กœ ์™„์ „ํ•œ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๊ตฌ์ถ•ํ•œ ๋‹ค์Œ, **๊ณ ๊ธ‰ ์‚ฌ์šฉ์ž ์•ˆ๋‚ด์„œ**์˜ ๋ช‡ ๊ฐ€์ง€ ์ถ”๊ฐ€ ์•„์ด๋””์–ด๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ํ•„์š”์— ๋”ฐ๋ผ ๋‹ค์–‘ํ•œ ๋ฐฉ์‹์œผ๋กœ ํ™•์žฅํ•  ์ˆ˜ ์žˆ๋„๋ก ์„ค๊ณ„๋˜์—ˆ์Šต๋‹ˆ๋‹ค.

2
docs/ko/mkdocs.yml

@ -50,6 +50,8 @@ nav:
- tr: /tr/
- uk: /uk/
- zh: /zh/
- ์ž์Šต์„œ - ์‚ฌ์šฉ์ž ์•ˆ๋‚ด์„œ:
- tutorial/index.md
markdown_extensions:
- toc:
permalink: true

Loadingโ€ฆ
Cancel
Save