🇰🇷 Korean Translation Discussion

[hard-coders]

👋 Greetings! Hope we discuss here translating Korean.

💭 Why I opened this discussion

I opened #2017, and it has worked well until the number of translators is not that many.
But now, we need to communicate in a single place for several reasons.

Because:

• a reviewer had to same suggestions or requests in lots of PRs.
• a translator use different Korean terms in the same English terms.
  • These are not in the glossary because it's not technical terms.
  • It's not good for readers.
  • e.g. "password" -> "패스워드", "비밀번호", "암호"
• I don't want to use other platforms like Discord. We should share all progress here, not closed somewhere.

As a result, I've thought we need to open a new discussion for translating. See #2017 (comment), #2475 (comment).

If you think this is not necessary, please tell me what you think. I'm not a dictator :)

🤔 Okay... But we have to speak English only here?

Nope. You can talk in Korean. Why I write in English often is I want to share works the others, not only Koreans.

[hard-coders]

파이썬 공식 한국어 문서에 없는 용어 중 현재 사용하고 있는 용어

🇺🇸	🇰🇷	note
!!! tip	!!! tip "팁"	block syntax
!!! note	!!! note "참고"	block syntax
!!! note "Technical Details"	!!! note "기술적 세부사항"	block syntax
!!! info	!!! info "정보"	block syntax
!!! warning	!!! warning "경고"	block syntax
!!! danger	!!! danger "위험"	block syntax
!!! check	!!! check "확인"	block syntax
Path operation	경로 작동
header	헤더	http header
body	본문	http body
docker	도커	영어, 단독, 병행 표기 가능
kubernetes	쿠버네티스	영어, 단독, 병행 표기 가능
gunicorn	구니콘	영어, 단독, 병행 표기 가능
uvicorn	유비콘	영어, 단독, 병행 표기 가능

• 경로 동작 -> 경로 작동: Accept 🇰🇷 Korean Translation Discussion #3167 (comment) Updated at 2021-10-19
• Add gunicorn and uvicorn: Accept 🇰🇷 Korean Translation Discussion #3167 (comment) Updated at 2022-07-20

gunicorn이나 uvicorn과 같은 단어들을 반드시 한글로 표현 할 필요는 없습니다. 영어 그대로 적어도 되며, 이는 각 PR의 리뷰에서 얘기하면 좋을것 같습니다.

[hard-coders]

"Example" is used to represent both 예제 and 예시, so I think it doesn't matter.
In addition, I want not to apply rigid rules because it increases the difficulty of the barriers to entry.

And I added !!! note "Technical Details" 😎

[0417taehyun]

Can you add Body as 본문 and Header as 헤더?

I think it might be confused to translate Body as 본문 or 바디 if there isn't guideline because Header was translated as 헤더. If people check your previous works, or MDN documents, they can translate the Body as 본문 (not 바디) but it would be better to check from GitHub Discussion for convenience.

[hard-coders]

I added body and header. Thank you for the suggestion!

[NinaHwang]

I think it should be '!!! warning' instead of '!!! warn'. Btw, thank you for all the works you've done for FastAPI Korean translation😊

[hard-coders]

I replaced !!! warn with !!! warning.

[0417taehyun]

I want to discuss the word, Path Operation translated 경로 동작.
Is there any reason that you translate Operation to 동작?

Because 동작 is used to define the movement of living things such as human and 작동 is used to define the movement of machines.

So, I think it would be better to translate Operation to 작동 even it fits to use with HTTP methods such as GET, POST, etc.

It is better to check the 국립국어원: <동작과 작동 구분> 질문에 대한 답변

[hard-coders]

There was no reason to accept 동작 at that time. I agree with your opinion.
I updated it.

[0417taehyun]

@hard-coders

Thanks!

[0417taehyun]

I want to discuss the word, Injectable, Dependable, and Dependent.

I already translated tutorial/dependencies/index.md (check #4063 ) with those words.

I did as 인젝터블, 의존 가능한, 디펜던트 for each. But are there any better words?

Inejctable can be translated 주입 가능한 and Dependent can be translated 의존 but the reason why I translated it 인젝터블 and 디펜던트 because Injectable means the set of things which can be injected and the meaning of set (translated as 집합 in Korean)is not included in the translated word 주입 가능한. Also, by the same reason, Dependent as 의존.

However Dependable refers to things that can be dependency, then I translated as "의존 가능한" or "의존 가능한 것" by the context.

Any suggestions?

[0417taehyun]

I think it would be better to update the guideline #2017 to add the encouragement of using less English, like Using less English as you can.

I review #4019 and there are lots of words in English such as markdown, pull request, python etc.

Even those words are proper noun, could be translated as 마크다운, 풀 리퀘스트, 파이썬 for consistency.

Any suggestions and ideas would be welcome 😆

[0417taehyun]

The another example of this, the 동작 section in the doc, 첫걸음.

Like:

• PUT : 데이터를 업데이트하기 위해.

could be translated as:

• PUT : 데이터를 수정하기 위해.

수정 instead of 업데이트.

[hard-coders]

It's a great idea! I will update the guideline.

[0417taehyun]

@hard-coders

Thank you 😆

[0417taehyun]

I think it would be better to update the guideline #2017 to add the recommendation to join the FastAPI discord and communicate in #korean channel to discuss the translation or etc.

cf.
I divided the discussions to communicate easily by using reply.

[hard-coders]

There's a FastAPI Discord 😳
I didn't know that. I'm going to join!!

[jujumilk3]

At the last of many chapters, Recap translated as 요약 so i just followed it.

And, I named as

gunicorn -> 규니콘
uvicorn -> 유비콘
docker -> 도커
kubernetes -> 쿠버네티스
worker process -> 워커프로세스

at my other translation commi(#4935)

Would you please check it and give me your opinion?

[hard-coders]

Sorry for the late.

Looks good to me, but one thing �"구니콘" is better than "규니콘".
Of course, there is no official Korean for that; many people sound "구니콘" instead.

Try to search for two words on google. you will find out the results.

[jujumilk3]

@hard-coders I applied it, thx for review

[mirusu400]

영어로 적기 힘들어서 한국어로 적습니다 양해 부탁드려요 ㅠㅠ

쿠버네티스나 도커 워커프로세스는 이미 한국어로 자주 써서 익숙한데
gunicorn이나 uvicorn 같은건 구니콘, 유비콘이라고 쓰는것보다 영어 그대로 적는 경우가 더 많은거 같습니다

혹시 이런 고유명사도 모두 한국어로 번역해야된다는 규칙이 있나요? 없다면, 영어 그대로를 유지하는걸 제안해봅니다

[hard-coders]

@mirusu400 강제하지는 않지만 웬만하면 영어보다는 한국어를 사용하는게 좋다, 라고 한국어 이슈 Glossary에 적어놓긴 했습니다.
추가로 "쿠버네티스" 역시 고유명사이지만 자주 써서 받아들이기 쉬울 뿐입니다.
"아파치", "리눅스", "우분투", "장고", 등등 모두 고유명사이지만, 익숙하기 때문에 그냥 사용합니다. 그저 익숙함의 차이일 뿐입니다.

저 역시 거부감이 들긴 하지만, 굳이 한글로 표현할 수 있는 것을 알파벳으로 나타내야 할 명확한 이유가 없습니다(이건 저의 개인적인 생각입니다).
그러나 어디까지 제안사항일 뿐이고 강제사항이 아닙니다.

다만..이러한 단어들은 강제하지 않고 자유롭게 쓰되, 리뷰에서 얘기하는게 맞을거 같습니다. 고로, 위 표에서 병행표기나 영어 단독표기해도 무방하다고 수정 해놓겠습니다 :)

[joonas-yoon]

Hi guys, good to see you.

As you know, there is so many missing translations and it is hard to see and know almost immediately.

I listed up all of headings in document (from docs/en), and here is

If you have any PR in progress, kindly comment me with PR link. I will update the checklist with link to anyone can see it.

This is for sharing with contributors, and will inspire us! I hope all contributions stay tuned and up to date.

Of course any ideas are welcomed =D

Checklist

*Checked means that already merged into master documentation.

**Updated at 2023/07/01, merged until 9176th PR, listed until 9616th PR

• features.md
  • 🌐 Add Korean translation for docs/ko/docs/features.md #4137
  • 🌐 Add Korean translation for docs/ko/docs/features.md #5237
• fastapi-people.md
• python-types.md
• 자습서 - 사용자 안내서:
  • tutorial/index.md
  • tutorial/first-steps.md
    • 🌐 Fix Korean translation for docs/ko/docs/tutorial/first-steps.md #3171
    • 🌐 Fix Korean translation for docs/ko/docs/tutorial/security/first-steps.md #4196
    • 🌐 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
  • tutorial/path-params.md
  • tutorial/query-params.md
  • tutorial/body.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/body.md #2392
  • tutorial/query-params-str-validations.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/query-params-str-validations.md #2415
  • tutorial/path-params-numeric-validations.md
  • tutorial/body-multiple-params.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/body-multiple-params.md #2461, 🌐 Add Korean translation for docs/ko/docs/tutorial/body-multiple-params.md #5854
  • tutorial/body-fields.md -🌐 Add Korean translation for docs/ko/docs/tutorial/body-fields.md #2489
  • tutorial/body-nested-models.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/body-nested-models.md #2506
  • tutorial/schema-extra-example.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/schema-extra-example.md #3161
  • tutorial/extra-data-types.md - 🌐 Add Korean translation for docs/ko/docs/extra-data-types.md #2528
  • tutorial/cookie-params.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/cookie-params.md #2545
  • tutorial/header-params.md
  • tutorial/response-model.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/response-model.md #2766
  • tutorial/extra-models.md - 🌐 Add Korean translation for Tutorial - Extra Models #3162
  • tutorial/response-status-code.md
  • tutorial/request-forms.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/request-forms.md #2908
  • tutorial/request-files.md
  • tutorial/request-forms-and-files.md
  • tutorial/handling-errors.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/handling-errors.md #3748
  • tutorial/path-operation-configuration.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/path-operation-configuration.md #3639
  • tutorial/encoder.md
  • tutorial/body-updates.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/body-updates.md #3120
  • Dependencies:
    • tutorial/dependencies/index.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/dependencies/index.md #5605
    • tutorial/dependencies/classes-as-dependencies.md
    • tutorial/dependencies/sub-dependencies.md
    • tutorial/dependencies/dependencies-in-path-operation-decorators.md
    • tutorial/dependencies/global-dependencies.md
    • tutorial/dependencies/dependencies-with-yield.md
  • Security:
    • tutorial/security/index.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/security/index.md #5612
    • tutorial/security/first-steps.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/security/first-steps.md #5643
    • tutorial/security/get-current-user.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/security/get-current-user.md #5737
    • tutorial/security/simple-oauth2.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/security/simple-oauth2.md #5744
    • tutorial/security/oauth2-jwt.md
  • tutorial/middleware.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/middleware.md #2829
  • tutorial/cors.md
  • tutorial/sql-databases.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/sql-databases.md #4170
  • tutorial/bigger-applications.md
  • tutorial/background-tasks.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/background-tasks.md #5910
  • tutorial/metadata.md
  • tutorial/static-files.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/static-files.md #2957
  • tutorial/testing.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/testing.md #4200, 🌐 Add Korean translation for docs/ko/docs/benchmarks.md and docs/ko/docs/tutorial/testing.md #9496
  • tutorial/debugging.md - 🌐 Add Korean translation for docs/ko/docs/tutorial/debugging.md #5695
• Advanced User Guide:
  • advanced/index.md - 🌐 Add Korean translation for docs/ko/docs/advanced/index.md #9613
  • advanced/path-operation-advanced-configuration.md
  • advanced/additional-status-codes.md - Add Korean translation for docs/ko/docs/advanced/additional-status-codes.md #9616
  • advanced/response-directly.md
  • advanced/custom-response.md
  • advanced/additional-responses.md
  • advanced/response-cookies.md
  • advanced/response-headers.md - 🌐 Add Korean translation for docs/ko/docs/advanced/response-headers.md #4430
  • advanced/response-change-status-code.md
  • advanced/advanced-dependencies.md
  • Advanced Security:
    • advanced/security/index.md
    • advanced/security/oauth2-scopes.md
    • advanced/security/http-basic-auth.md
  • advanced/using-request-directly.md
  • advanced/dataclasses.md
  • advanced/middleware.md
  • advanced/sql-databases-peewee.md
  • advanced/async-sql-databases.md
  • advanced/nosql-databases.md
  • advanced/sub-applications.md - 🌐 Add Korean translation for docs/ko/docs/advanced/sub-applications.md #4543
  • advanced/behind-a-proxy.md - 🌐 Add Korean translation for docs/ko/docs/advanced/behind-a-proxy.md #4774
  • advanced/templates.md
  • advanced/graphql.md
  • advanced/websockets.md
  • advanced/events.md - 🌐 Add Korean translation for docs/ko/docs/advanced/events.md #5087
  • advanced/custom-request-and-route.md
  • advanced/testing-websockets.md
  • advanced/testing-events.md
  • advanced/testing-dependencies.md
  • advanced/testing-database.md
  • advanced/async-tests.md
  • advanced/settings.md
  • advanced/conditional-openapi.md
  • advanced/extending-openapi.md
  • advanced/openapi-callbacks.md
  • advanced/wsgi.md
  • advanced/generate-clients.md
• async.md - 🌐 Add Korean translation for docs/ko/docs/async.md #4179
• Deployment:
  • deployment/index.md - 🌐 Add Korean translation for docs/ko/docs/deployment/index.md #4561
  • deployment/versions.md
  • deployment/https.md
  • deployment/manually.md - 🌐 Add Korean translation for docs/ko/docs/deployment/manually.md #5594
  • deployment/concepts.md
  • deployment/deta.md
  • deployment/server-workers.md - 🌐 Add Korean translation for docs/ko/docs/deployment/server-workers.md #4935
  • deployment/docker.md - 🌐 Add Korean translation for docs/ko/docs/deployment/docker.md #5657
• project-generation.md - 🌐 Add Korean translation for docs/project-generation.md #4136
• alternatives.md
• history-design-future.md
• external-links.md
• benchmarks.md - 🌐 Add Korean translation for docs/benchmarks.md #4142, 🌐 Add Korean translation for docs/ko/docs/benchmarks.md and docs/ko/docs/tutorial/testing.md #9496
• help-fastapi.md - 🌐 Add Korean translation for docs/ko/docs/help-fastapi.md #4139
• contributing.md - 🌐 Add Korean translation for docs/ko/docs/contributing.md #4019
• release-notes.md

[junah201]

I have made PR for docs/ko/docs/tutorial/background-tasks.md : #5910
Thanks for your checklist !!!

[ElliottLarsen]

Hi, I have just created a PR for tutorial/testing.md: #9496

[ElliottLarsen]

Hello,

I've made two PRs:

• docs/ko/docs/advanced/index.md: 🌐 Add Korean translation for docs/ko/docs/advanced/index.md #9613
• docs/ko/docs/advanced/additional-status-codes.md: Add Korean translation for docs/ko/docs/advanced/additional-status-codes.md #9616

Thank you for your checklist!

[junah201]

There are three new translation PRs.
Thank you for updating the checklist.

• docs/ko/docs/benchmarks.md and docs/ko/docs/tutorial/testing.md: 🌐 Add Korean translation for docs/ko/docs/benchmarks.md and docs/ko/docs/tutorial/testing.md #9496
• docs/ko/docs/advanced/index.md : 🌐 Add Korean translation for docs/ko/docs/advanced/index.md #9613
• docs/ko/docs/advanced/additional-status-codes.md : Add Korean translation for docs/ko/docs/advanced/additional-status-codes.md #9616

[KaniKim]

If someone don't mind, someone can review my translations?

• 🌐 Add Korean translation for docs/ko/docs/features.md #10976
• 🌐 Add Korean translation for docs/ko/docs/help/index.md #10983
• 🌐 Add Korean translation for docs/ko/docs/tutorial/dependencies/index.md #10989
  Thanks

[github-actions[bot]]

There's a new translation PR to be reviewed: #9176 by @sehwan505 Good job! This is done. 🍰☕

[github-actions[bot]]

There's a new translation PR to be reviewed: #9496 by @ElliottLarsen Good job! This is done. 🍰☕

[github-actions[bot]]

There's a new translation PR to be reviewed: #9613 by @ElliottLarsen Good job! This is done. 🍰☕

[github-actions[bot]]

There's a new translation PR to be reviewed: #9616 by @ElliottLarsen Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #2461 by @PandaHun Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #2506 by @hard-coders Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #2766 by @hard-coders Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #2267 by @jrim Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #10758 by @2chanhaeng Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #10977 by @KaniKim Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #10976 by @KaniKim Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #10989 by @KaniKim Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #10983 by @KaniKim Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #11000 by @KaniKim Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #11112 by @KaniKim Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #11113 by @KaniKim Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #11114 by @KaniKim Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #11118 by @riroan Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #11121 by @KaniKim Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #11123 by @riroan Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #11124 by @riroan Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #11296 by @choi-haram Good job! This is done. 🍰☕

[tiangolo]

There's a new translation PR to be reviewed: #11299 by @choi-haram Good job! This is done. 🍰☕