Skip to content

🌐 Add Korean translation for docs/ko/docs/advanced/custom-response.md#13265

Merged
alejsdev merged 23 commits intofastapi:masterfrom
11kkw:korean-translation-custom-response
Feb 15, 2025
Merged

🌐 Add Korean translation for docs/ko/docs/advanced/custom-response.md#13265
alejsdev merged 23 commits intofastapi:masterfrom
11kkw:korean-translation-custom-response

Conversation

@11kkw
Copy link
Contributor

@11kkw 11kkw commented Jan 28, 2025

내용

이 PR은 docs/ko/docs/advanced/custom-response.md 파일에 대한 한국어 번역을 추가합니다. FastAPI 프로젝트에 두 번째로 기여하는 PR이며, 공식 문서를 기반으로 번역을 완료했습니다.

참고 사항

  • 문서에서 **"Custom"**을 **"사용자 정의"**로 번역하여 맥락에 맞는 표현을 사용했습니다.
  • 번역 작업은 최신 FastAPI 문서를 기반으로 진행되었으며, 원본의 Markdown 구조 및 코드 블록은 그대로 유지했습니다.

번역 기준

  • 번역 과정에서 다음 용어를 사용했습니다:
    • Custom: 사용자 정의
    • Response Class: 응답 클래스
    • HTMLResponse: HTML 응답
    • Media Type: 미디어 타입

작업 이력

  • 관련 커밋: 🌐 Add Korean translation for docs/ko/docs/advanced/custom-response.md

기여 메시지

이 PR은 저의 두 번째 오픈소스 기여입니다. 번역 스타일이나 프로세스에서 부족한 점이 있다면 적극적으로 피드백을 반영하겠습니다.

검토 요청

  • 번역 내용이 자연스럽고 명확한지 확인 부탁드립니다.
  • **"Custom"**을 **"사용자 정의"**로 번역한 부분이 적절한지 검토 부탁드립니다.
  • 문서 포맷이나 번역 스타일에서 개선이 필요한 부분에 대한 의견을 주시면 감사하겠습니다.

@github-actions github-actions bot added the lang-all Translations label Jan 28, 2025
@11kkw 11kkw changed the title 🌐 Add Korean translation for docs/ko/docs/advanced/custom-response.md 🌐 Add Korean translation for docs/ko/docs/advanced/custom-response.md Jan 28, 2025
@11kkw 11kkw force-pushed the korean-translation-custom-response branch from 17d3ddd to cb4b699 Compare January 28, 2025 17:57
@tiangolo tiangolo added lang-ko Korean translations awaiting-review labels Jan 28, 2025

예를 들어, 성능을 극대화하려는 경우, <a href="https://github.com/ijl/orjson" class="external-link" target="_blank">orjson</a>을 설치하여 사용하고 응답을 `ORJSONResponse`로 설정 할수 있습니다.

사용하고자 하는 `Response` 클래스(하위 클래스)를 가져와서 **경로 작동 테코레이터*에서 선언하세요.
Copy link
Contributor

@timothy-jeong timothy-jeong Feb 7, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for your �Awesome Job!
I noticed that in lines 9, 11, and 13, "path operation" is translated as "경로 작업." Therefore, please change any instance of "경로 작동" to "경로 작업" for consistency.


이유는 기본적으로, FastAPI가 내부의 모든 항목을 검사하고 JSON으로 직렬화할 수 있는지 확인하기 때문입니다. 이는 사용자 안내서에서 설명된 [JSON 호환 가능 인코더](../tutorial/encoder.md){.internal-link target=_blank}를 사용하는 방식과 동일합니다. 이를 통해 데이터베이스 모델과 같은 **임의의 객체**를 반환할 수 있습니다.

하지만 반환하는 내용이 **JSON으로 직렬화 가능**하다고 확신하는 경우, 해당 내용을 응답 클래스에 직접 전달할 수 있으며, FastAPI가 반환 내용을 `jsonable_encoder`를 통해 처리한 뒤 응답 클래스에 전달하는 추가적인 시간을 피할 수 있습니다.
Copy link
Contributor

@timothy-jeong timothy-jeong Feb 7, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In my opinion, translating "overhead" simply as "추가적인 시간" is a somewhat limited interpretation. Generally, "overhead" doesn't refer solely to time but to the extra processing cost (e.g., time, memory, computation, etc.) incurred when performing a particular task or process.

Currently, there isn't an established translation for "overhead" in the Korean version of the documentation. Moreover, in the German translation of the FastAPI benchmarks document—which is one of the most frequently referenced sources for this term—"overhead" is left unchanged. Considering these examples, it might be best for us to use "overhead" as is in our translation, to avoid any confusion and to convey the original meaning accurately.

Therefore, instead of translating "overhead" as "추가적인 시간," it's preferable to leave it as "오버헤드."


**FastAPI**에서 HTML 응답을 직접 반환하려면 `HTMLResponse`를 사용하세요.

* `HTMLResponse`를 가져옵니다.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since "import" is a Python-specific keyword, retaining it as "임포트" preserves its intended meaning. I recommend keeping it as is.

Other Korean translated documents, such as body-fields and body-nested-models, directly translate the term "import" as "임포트."

this review include line 25 and 55

@timothy-jeong
Copy link
Contributor

Great Job!

@11kkw 11kkw requested a review from timothy-jeong February 10, 2025 02:39

**FastAPI**에서 HTML 응답을 직접 반환하려면 `HTMLResponse`를 사용하세요.

* `HTMLResponse`를 임포트합니.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* `HTMLResponse`임포트합니.
* `HTMLResponse`임포트합니다.

minor typo

Copy link
Contributor

@timothy-jeong timothy-jeong left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM 🚀

Copy link
Contributor

@yes0ng yes0ng left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great translation! I have left a few review comments. Please take a look :)

* It would be better if you could mark the resolved comments as "resolved" for easier review.

11kkw and others added 14 commits February 13, 2025 15:49
Copy link
Contributor

@yes0ng yes0ng left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM 🔥

@alejsdev alejsdev merged commit 030012b into fastapi:master Feb 15, 2025
58 checks passed
@alejsdev
Copy link
Member

Nice! Thank you so much for your contribution @11kkw 🚀
And thanks for your reviews @timothy-jeong @yes0ng

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved-2 lang-all Translations lang-ko Korean translations

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants