🌐 Update Korean translation for `docs/ko/docs/tutorial/first-steps.md…

…`, `docs/ko/docs/tutorial/index.md`, `docs/ko/docs/tutorial/path-params.md`, and `docs/ko/docs/tutorial/query-params.md` (#4218)
tiangolo · Feb 2, 2024 · d254e2f · d254e2f
1 parent 6f6e786
commit d254e2f
Show file tree

Hide file tree

Showing 4 changed files with 104 additions and 103 deletions.
diff --git a/docs/ko/docs/tutorial/first-steps.md b/docs/ko/docs/tutorial/first-steps.md
@@ -1,12 +1,12 @@
 # 첫걸음
 
-가장 단순한 FastAPI 파일은 다음과 같이 보일 겁니다:
+가장 단순한 FastAPI 파일은 다음과 같이 보일 것입니다:
 
 ```Python
 {!../../../docs_src/first_steps/tutorial001.py!}
 ```
 
-위를 `main.py`에 복사합니다.
+위 코드를 `main.py`에 복사합니다.
 
 라이브 서버를 실행합니다:
 
@@ -29,9 +29,9 @@ $ uvicorn main:app --reload
 
     * `main`: 파일 `main.py` (파이썬 "모듈").
     * `app`: `main.py` 내부의 `app = FastAPI()` 줄에서 생성한 오브젝트.
-    * `--reload`: 코드 변경 후 서버 재시작. 개발에만 사용.
+    * `--reload`: 코드 변경 시 자동으로 서버 재시작. 개발 시에만 사용.
 
-출력에 아래와 같은 줄이 있습니다:
+출력되는 줄들 중에는 아래와 같은 내용이 있습니다:
 
 ```hl_lines="4"
 INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
@@ -75,7 +75,7 @@ INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
 
 #### API "스키마"
 
-이 경우, <a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank">OpenAPI</a>는 API의 스키마를 어떻게 정의하는지 지시하는 규격입니다.
+<a href="https://github.com/OAI/OpenAPI-Specification" class="external-link" target="_blank">OpenAPI</a>는 API의 스키마를 어떻게 정의하는지 지시하는 규격입니다.
 
 이 스키마 정의는 API 경로, 가능한 매개변수 등을 포함합니다.
 
@@ -87,13 +87,13 @@ INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
 
 #### OpenAPI와 JSON 스키마
 
-OpenAPI는 API에 대한 API 스키마를 정의합니다. 또한 이 스키마에는 JSON 데이터 스키마의 표준인 **JSON 스키마**를 사용하여 API에서 보내고 받은 데이터의 정의(또는 "스키마")를 포함합니다.
+OpenAPI는 당신의 API에 대한 API 스키마를 정의합니다. 또한 이 스키마는 JSON 데이터 스키마의 표준인 **JSON 스키마**를 사용하여 당신의 API가 보내고 받는 데이터의 정의(또는 "스키마")를 포함합니다.
 
 #### `openapi.json` 확인
 
-가공되지 않은 OpenAPI 스키마가 어떻게 생겼는지 궁금하다면, FastAPI는 자동으로 API의 설명과 함께 JSON (스키마)를 생성합니다.
+FastAPI는 자동으로 API의 설명과 함께 JSON (스키마)를 생성합니다.
 
-여기에서 직접 볼 수 있습니다: <a href="http://127.0.0.1:8000/openapi.json" class="external-link" target="_blank">http://127.0.0.1:8000/openapi.json</a>.
+가공되지 않은 OpenAPI 스키마가 어떻게 생겼는지 궁금하다면, 여기에서 직접 볼 수 있습니다: <a href="http://127.0.0.1:8000/openapi.json" class="external-link" target="_blank">http://127.0.0.1:8000/openapi.json</a>.
 
 다음과 같이 시작하는 JSON을 확인할 수 있습니다:
 
@@ -124,7 +124,7 @@ OpenAPI 스키마는 포함된 두 개의 대화형 문서 시스템을 제공
 
 그리고 OpenAPI의 모든 것을 기반으로 하는 수십 가지 대안이 있습니다. **FastAPI**로 빌드한 애플리케이션에 이러한 대안을 쉽게 추가 할 수 있습니다.
 
-API와 통신하는 클라이언트를 위해 코드를 자동으로 생성하는 데도 사용할 수 있습니다. 예로 프론트엔드, 모바일, IoT 애플리케이션이 있습니다.
+API와 통신하는 클라이언트(프론트엔드, 모바일, IoT 애플리케이션 등)를 위해 코드를 자동으로 생성하는 데도 사용할 수 있습니다.
 
 ## 단계별 요약
 
@@ -134,7 +134,7 @@ API와 통신하는 클라이언트를 위해 코드를 자동으로 생성하
 {!../../../docs_src/first_steps/tutorial001.py!}
 ```
 
-`FastAPI`는 API에 대한 모든 기능을 제공하는 파이썬 클래스입니다.
+`FastAPI`는 당신의 API를 위한 모든 기능을 제공하는 파이썬 클래스입니다.
 
 !!! note "기술 세부사항"
     `FastAPI`는 `Starlette`를 직접 상속하는 클래스입니다.
@@ -147,11 +147,11 @@ API와 통신하는 클라이언트를 위해 코드를 자동으로 생성하
 {!../../../docs_src/first_steps/tutorial001.py!}
 ```
 
-여기 있는 `app` 변수는 `FastAPI` 클래스의 "인스턴스"가 됩니다.
+여기에서 `app` 변수는 `FastAPI` 클래스의 "인스턴스"가 됩니다.
 
-이것은 모든 API를 생성하기 위한 상호작용의 주요 지점이 될 것입니다.
+이것은 당신의 모든 API를 생성하기 위한 상호작용의 주요 지점이 될 것입니다.
 
-이 `app`은 다음 명령에서 `uvicorn`이 참조하고 것과 동일합니다:
+이 `app`은 다음 명령에서 `uvicorn`이 참조하고 있는 것과 동일합니다:
 
 <div class="termy">
 
@@ -181,11 +181,11 @@ $ uvicorn main:my_awesome_api --reload
 
 </div>
 
-### 3 단계: *경로 동작* 생성
+### 3 단계: *경로 작동* 생성
 
 #### 경로
 
-여기서 "경로"는 첫 번째 `/`에서 시작하는 URL의 마지막 부분을 나타냅니다.
+여기서 "경로"는 첫 번째 `/`부터 시작하는 URL의 뒷부분을 의미합니다.
 
 그러므로 아래와 같은 URL에서:
 
@@ -200,13 +200,13 @@ https://example.com/items/foo
 ```
 
 !!! info "정보"
-    "경로"는 일반적으로 "앤드포인트" 또는 "라우트"라고도 불립니다.
+    "경로"는 일반적으로 "엔드포인트" 또는 "라우트"라고도 불립니다.
 
-API를 빌드하는 동안 "경로"는 "관심사"와 "리소스"를 분리하는 주요 방법입니다.
+API를 설계할 때 "경로"는 "관심사"와 "리소스"를 분리하기 위한 주요한 방법입니다.
 
-#### 동작
+#### 작동
 
-여기서 "동작(Operation)"은 HTTP "메소드" 중 하나를 나타냅니다.
+"작동(Operation)"은 HTTP "메소드" 중 하나를 나타냅니다.
 
 다음 중 하나이며:
 
@@ -215,7 +215,7 @@ API를 빌드하는 동안 "경로"는 "관심사"와 "리소스"를 분리하
 * `PUT`
 * `DELETE`
 
-...이국적인 것들도 있습니다:
+...흔히 사용되지 않는 것들도 있습니다:
 
 * `OPTIONS`
 * `HEAD`
@@ -226,20 +226,20 @@ HTTP 프로토콜에서는 이러한 "메소드"를 하나(또는 이상) 사용
 
 ---
 
-API를 빌드하는 동안 일반적으로 특정 행동을 수행하기 위해 특정 HTTP 메소드를 사용합니다.
+API를 설계할 때 일반적으로 특정 행동을 수행하기 위해 특정 HTTP 메소드를 사용합니다.
 
-일반적으로 다음을 사용합니다:
+일반적으로 다음과 같습니다:
 
 * `POST`: 데이터를 생성하기 위해.
 * `GET`: 데이터를 읽기 위해.
-* `PUT`: 데이터를 업데이트하기 위해.
+* `PUT`: 데이터를 수정하기 위해.
 * `DELETE`: 데이터를 삭제하기 위해.
 
-그래서 OpenAPI에서는 각 HTTP 메소드들을 "동작"이라 부릅니다.
+그래서 OpenAPI에서는 각 HTTP 메소드들을 "작동"이라 부릅니다.
 
-이제부터 우리는 메소드를 "**동작**"이라고도 부를겁니다.
+우리 역시 이제부터 메소드를 "**작동**"이라고 부를 것입니다.
 
-#### *경로 동작 데코레이터* 정의
+#### *경로 작동 데코레이터* 정의
 
 ```Python hl_lines="6"
 {!../../../docs_src/first_steps/tutorial001.py!}
@@ -248,47 +248,47 @@ API를 빌드하는 동안 일반적으로 특정 행동을 수행하기 위해
 `@app.get("/")`은 **FastAPI**에게 바로 아래에 있는 함수가 다음으로 이동하는 요청을 처리한다는 것을 알려줍니다.
 
 * 경로 `/`
-* <abbr title="HTTP GET 메소드"><code>get</code> 동작</abbr> 사용
+* <abbr title="HTTP GET 메소드"><code>get</code> 작동</abbr> 사용
 
 !!! info "`@decorator` 정보"
     이 `@something` 문법은 파이썬에서 "데코레이터"라 부릅니다.
 
-    함수 맨 위에 놓습니다. 마치 예쁜 장식용(Decorative) 모자처럼(개인적으로 이 용어가 여기서 유래한거 같습니다).
+    마치 예쁜 장식용(Decorative) 모자처럼(개인적으로 이 용어가 여기서 유래한 것 같습니다) 함수 맨 위에 놓습니다.
 
-    "데코레이터" 아래 있는 함수를 받고 그걸 이용해 무언가 합니다.
+    "데코레이터"는 아래 있는 함수를 받아 그것으로 무언가를 합니다.
 
-    우리의 경우, 이 데코레이터는 **FastAPI**에게 아래 함수가 **경로** `/`에 해당하는 `get` **동작**하라고 알려줍니다.
+    우리의 경우, 이 데코레이터는 **FastAPI**에게 아래 함수가 **경로** `/`의 `get` **작동**에 해당한다고 알려줍니다.
 
-    이것이 "**경로 동작 데코레이터**"입니다.
+    이것이 "**경로 작동 데코레이터**"입니다.
 
-다른 동작도 쓸 수 있습니다:
+다른 작동도 사용할 수 있습니다:
 
 * `@app.post()`
 * `@app.put()`
 * `@app.delete()`
 
-이국적인 것들도 있습니다:
+흔히 사용되지 않는 것들도 있습니다:
 
 * `@app.options()`
 * `@app.head()`
 * `@app.patch()`
 * `@app.trace()`
 
 !!! tip "팁"
-    각 동작(HTTP 메소드)을 원하는 대로 사용해도 됩니다.
+    각 작동(HTTP 메소드)을 원하는 대로 사용해도 됩니다.
 
     **FastAPI**는 특정 의미를 강제하지 않습니다.
 
-    여기서 정보는 지침서일뿐 요구사항이 아닙니다.
+    여기서 정보는 지침서일뿐 강제사항이 아닙니다.
 
-    예를 들어 GraphQL을 사용할때 일반적으로 `POST` 동작만 사용하여 모든 행동을 수행합니다.
+    예를 들어 GraphQL을 사용하는 경우, 일반적으로 `POST` 작동만 사용하여 모든 행동을 수행합니다.
 
-### 4 단계: **경로 동작 함수** 정의
+### 4 단계: **경로 작동 함수** 정의
 
-다음은 우리의 "**경로 동작 함수**"입니다:
+다음은 우리의 "**경로 작동 함수**"입니다:
 
 * **경로**: 는 `/`입니다.
-* **동작**: 은 `get`입니다.
+* **작동**: 은 `get`입니다.
 * **함수**: 는 "데코레이터" 아래에 있는 함수입니다 (`@app.get("/")` 아래).
 
 ```Python hl_lines="7"
@@ -297,13 +297,13 @@ API를 빌드하는 동안 일반적으로 특정 행동을 수행하기 위해
 
 이것은 파이썬 함수입니다.
 
-`GET` 동작을 사용하여 URL "`/`"에 대한 요청을 받을 때마다 **FastAPI**에 의해 호출됩니다.
+URL "`/`"에 대한 `GET` 작동을 사용하는 요청을 받을 때마다 **FastAPI**에 의해 호출됩니다.
 
-위의 경우 `async` 함수입니다.
+위의 예시에서 이 함수는 `async`(비동기) 함수입니다.
 
 ---
 
-`async def` 대신 일반 함수로 정의할 수 있습니다:
+`async def`을 이용하는 대신 일반 함수로 정의할 수 있습니다:
 
 ```Python hl_lines="7"
 {!../../../docs_src/first_steps/tutorial003.py!}
@@ -322,12 +322,12 @@ API를 빌드하는 동안 일반적으로 특정 행동을 수행하기 위해
 
 Pydantic 모델을 반환할 수도 있습니다(나중에 더 자세히 살펴봅니다).
 
-JSON으로 자동 변환되는 객체들과 모델들이 많이 있습니다(ORM 등을 포함해서요). 가장 마음에 드는 것을 사용하세요, 이미 지원되고 있을 겁니다.
+JSON으로 자동 변환되는 객체들과 모델들(ORM 등을 포함해서)이 많이 있습니다. 가장 마음에 드는 것을 사용하십시오, 이미 지원되고 있을 것입니다.
 
 ## 요약
 
 * `FastAPI` 임포트.
 * `app` 인스턴스 생성.
-* (`@app.get("/")`처럼) **경로 동작 데코레이터** 작성.
-* (위에 있는 `def root(): ...`처럼) **경로 동작 함수** 작성.
+* (`@app.get("/")`처럼) **경로 작동 데코레이터** 작성.
+* (위에 있는 `def root(): ...`처럼) **경로 작동 함수** 작성.
 * (`uvicorn main:app --reload`처럼) 개발 서버 실행.
diff --git a/docs/ko/docs/tutorial/index.md b/docs/ko/docs/tutorial/index.md
@@ -1,16 +1,16 @@
 # 자습서 - 사용자 안내서
 
-이 자습서는 **FastAPI**의 대부분의 기능을 단계별로 사용하는 방법을 보여줍니다.
+이 자습서는 단계별로 **FastAPI**의 대부분의 기능에 대해 설명합니다.
 
-각 섹션은 이전 섹션을 기반해서 점진적으로 만들어 졌지만, 주제에 따라 다르게 구성되었기 때문에 특정 API 요구사항을 해결하기 위해서라면 어느 특정 항목으로던지 직접 이동할 수 있습니다.
+각 섹션은 이전 섹션에 기반하는 순차적인 구조로 작성되었지만, 각 주제로 구분되어 있기 때문에 필요에 따라 특정 섹션으로 바로 이동하여 필요한 내용을 바로 확인할 수 있습니다.
 
-또한 향후 참조가 될 수 있도록 만들어졌습니다.
+또한 향후에도 참조 자료로 쓰일 수 있도록 작성되었습니다.
 
-그러므로 다시 돌아와서 정확히 필요한 것을 확인할 수 있습니다.
+그러므로 필요할 때에 다시 돌아와서 원하는 것을 정확히 찾을 수 있습니다.
 
 ## 코드 실행하기
 
-모든 코드 블록은 복사하고 직접 사용할 수 있습니다(실제로 테스트한 파이썬 파일입니다).
+모든 코드 블록은 복사하여 바로 사용할 수 있습니다(실제로 테스트된 파이썬 파일입니다).
 
 예제를 실행하려면 코드를 `main.py` 파일에 복사하고 다음을 사용하여 `uvicorn`을 시작합니다:
 
@@ -28,17 +28,18 @@ $ uvicorn main:app --reload
 
 </div>
 
-코드를 작성하거나 복사, 편집할 때, 로컬에서 실행하는 것을 **강력히 장려**합니다.
+코드를 작성하거나 복사, 편집할 때, 로컬 환경에서 실행하는 것을 **강력히 권장**합니다.
+
+로컬 편집기에서 사용한다면, 모든 타입 검사와 자동완성 등 작성해야 하는 코드가 얼마나 적은지 보면서 FastAPI의 비로소 경험할 수 있습니다.
 
-편집기에서 이렇게 사용한다면, 모든 타입 검사와 자동완성 등 작성해야 하는 코드가 얼마나 적은지 보면서 FastAPI의 장점을 실제로 확인할 수 있습니다.
 
 ---
 
 ## FastAPI 설치
 
-첫 번째 단계는 FastAPI 설치입니다.
+첫 번째 단계는 FastAPI를 설치하는 것입니다.
 
-자습시에는 모든 선택적인 의존성 및 기능을 사용하여 설치할 수 있습니다:
+자습시에는 모든 선택적인 의존성 및 기능을 함께 설치하는 것을 추천합니다:
 
 <div class="termy">
 
@@ -50,7 +51,7 @@ $ pip install "fastapi[all]"
 
 </div>
 
-...코드를 실행하는 서버로 사용할 수 있는 `uvicorn` 역시 포함하고 있습니다.
+...이는 코드를 실행하는 서버로 사용할 수 있는 `uvicorn` 또한 포함하고 있습니다.
 
 !!! note "참고"
     부분적으로 설치할 수도 있습니다.
@@ -73,8 +74,8 @@ $ pip install "fastapi[all]"
 
 이 **자습서 - 사용자 안내서** 다음에 읽을 수 있는 **고급 사용자 안내서**도 있습니다.
 
-**고급 사용자 안내서**는 현재 문서를 기반으로 하고, 동일한 개념을 사용하며, 추가 기능들을 알려줍니다.
+**고급 사용자 안내서**는 현재 문서를 기반으로 하고, 동일한 개념을 사용하며, 추가적인 기능들에 대해 설명합니다.
 
-하지만 (지금 읽고 있는) **자습서 - 사용자 안내서**를 먼저 읽는게 좋습니다.
+하지만 (지금 읽고 있는) **자습서 - 사용자 안내서**를 먼저 읽는 것을 권장합니다.
 
-**자습서 - 사용자 안내서**만으로도 완전한 애플리케이션을 구축할 수 있으며, 필요에 따라 **고급 사용자 안내서**에서 제공하는 몇 가지 추가적인 기능을 사용하여 다양한 방식으로 확장할 수 있도록 설계되었습니다.
+**자습서 - 사용자 안내서**만으로도 완전한 애플리케이션을 구축할 수 있도록 작성되었으며, 필요에 따라 **고급 사용자 안내서**의 추가적인 아이디어를 적용하여 다양한 방식으로 확장할 수 있습니다.