요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. _translations:
============
Translations
============
.. toctree::
:maxdepth: 1
zh_CN/index
zh_TW/index
it_IT/index
ko_KR/index
ja_JP/index
sp_SP/index
.. _translations_disclaimer:
Disclaimer
----------
.. raw:: latex
\kerneldocCJKoff
Translation's purpose is to ease reading and understanding in languages other
than English. Its aim is to help people who do not understand English or have
doubts about its interpretation. Additionally, some people prefer to read
documentation in their native language, but please bear in mind that the
*only* official documentation is the English one: :ref:`linux_doc`.
It is very unlikely that an update to :ref:`linux_doc` will be propagated
immediately to all translations. Translations' maintainers - and
contributors - follow the evolution of the official documentation and they
maintain translations aligned as much as they can. For this reason there is
no guarantee that a translation is up to date. If what you read in a
translation does not sound right compared to what you read in the code, please
inform the translation maintainer and - if you can - check also the English
documentation.
A translation is not a fork of the official documentation, therefore
translations' users should not find information that differs from the official
English documentation. Any content addition, removal or update, must be
applied to the English documents first. Afterwards and when possible, the
same change should be applied to translations. Translations' maintainers
accept only contributions that are merely translation related (e.g. new
translations, updates, fixes).
Translations try to be as accurate as possible but it is not possible to map
one language directly to all other languages. Each language has its own
grammar and culture, so the translation of an English statement may need to be
adapted to fit a different language. For this reason, when viewing
translations, you may find slight differences that carry the same message but
in a different form.
If you need to communicate with the Linux community but you do not feel
comfortable writing in English, you can ask the translation's maintainers
for help.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
번역 문서 언어 목록
1-18이 페이지는 Linux 커널 문서 번역의 최상위 목차입니다. `_translations` 참조 대상을 선언하고, 깊이 1의 toctree에서 제공 언어별 문서 루트를 연결합니다.
목록에는 중국어 간체 `zh_CN`, 중국어 번체 `zh_TW`, 이탈리아어 `it_IT`, 한국어 `ko_KR`, 일본어 `ja_JP`, 스페인어 `sp_SP` 문서가 포함됩니다.
언어 디렉터리 이름은 문서 경로와 Sphinx 목차 연결에 쓰이는 식별자이므로 번역하지 않고 그대로 유지합니다. 각 항목의 `index`가 해당 언어 문서의 시작점입니다.
.. toctree::
:maxdepth: 1
zh_CN/index
zh_TW/index
it_IT/index
ko_KR/index
ja_JP/index
sp_SP/indextoctree에 등록된 언어 코드와 문서 루트입니다.
.. _translations:
============
Translations
============
.. toctree::
:maxdepth: 1
zh_CN/index
zh_TW/index
it_IT/index
ko_KR/index
ja_JP/index
sp_SP/index
.. _translations_disclaimer:공식 원문과 최신성 고지
19-40번역의 목적은 영어 이외의 언어로 문서를 더 쉽게 읽고 이해하게 하는 것입니다. 영어를 이해하기 어렵거나 해석이 확실하지 않은 독자를 돕고, 모국어 문서를 선호하는 사람에게 읽기 편한 자료를 제공합니다.
그러나 공식 문서는 오직 영어 문서 `linux_doc`뿐입니다. 번역은 이해를 돕는 자료이며, 기술적 판단이나 원문과의 충돌을 해결할 때는 영어 문서를 기준으로 삼아야 합니다.
영어 공식 문서의 변경 사항이 모든 번역에 즉시 전파될 가능성은 매우 낮습니다. 번역 유지관리자와 기여자는 공식 문서의 변화를 추적하고 가능한 범위에서 번역을 맞추지만, 특정 번역이 최신이라고 보장할 수는 없습니다.
번역에서 읽은 내용이 실제 코드와 맞지 않는 것처럼 보이면 번역 유지관리자에게 알려야 합니다. 가능하다면 영어 공식 문서도 함께 확인하여 코드, 영어 원문, 번역 사이의 차이를 판단해야 합니다.
LaTeX 출력에서는 `\kerneldocCJKoff` raw 지시어로 이 고지 구간의 CJK 처리를 조정합니다. 이 렌더링 지시어는 정책 문장의 일부는 아니지만 원문 구조로 그대로 보존됩니다.
번역에 의심이 생겼을 때 코드와 공식 영어 문서를 우선 확인합니다.
공식성, 갱신 지연, 검증 책임을 구분합니다.
Disclaimer
----------
.. raw:: latex
\kerneldocCJKoff
Translation's purpose is to ease reading and understanding in languages other
than English. Its aim is to help people who do not understand English or have
doubts about its interpretation. Additionally, some people prefer to read
documentation in their native language, but please bear in mind that the
*only* official documentation is the English one: :ref:`linux_doc`.
It is very unlikely that an update to :ref:`linux_doc` will be propagated
immediately to all translations. Translations' maintainers - and
contributors - follow the evolution of the official documentation and they
maintain translations aligned as much as they can. For this reason there is
no guarantee that a translation is up to date. If what you read in a
translation does not sound right compared to what you read in the code, please
inform the translation maintainer and - if you can - check also the English
documentation.포크 금지와 번역 기여 원칙
41-59번역은 공식 문서의 포크가 아닙니다. 따라서 번역 사용자에게 공식 영어 문서와 다른 기술 정보를 제공해서는 안 됩니다.
내용의 추가, 삭제, 갱신은 반드시 영어 문서에 먼저 적용해야 합니다. 그 뒤 가능할 때 같은 변경을 번역 문서에 반영합니다. 번역 유지관리자는 새 번역, 번역 갱신, 번역 오류 수정처럼 번역 자체와 관련된 기여만 받습니다.
번역은 가능한 한 정확해야 하지만 한 언어를 다른 모든 언어에 일대일로 대응시키는 것은 불가능합니다. 언어마다 문법과 문화가 다르므로 영어 문장은 대상 언어에 자연스럽게 맞도록 조정될 수 있습니다.
이 때문에 번역 표현이 영어 문장과 조금 달라도 같은 메시지를 다른 형식으로 전달할 수 있습니다. 표현 차이는 허용되지만 기술적 의미가 달라져서는 안 됩니다.
Linux 커뮤니티와 소통해야 하지만 영어로 작성하는 것이 편하지 않다면 번역 유지관리자에게 도움을 요청할 수 있습니다.
기술 내용은 영어 공식 문서에서 먼저 합의하고 번역으로 전파합니다.
번역 저장소에서 허용되는 변경과 먼저 영어 문서로 가야 하는 변경입니다.
A translation is not a fork of the official documentation, therefore
translations' users should not find information that differs from the official
English documentation. Any content addition, removal or update, must be
applied to the English documents first. Afterwards and when possible, the
same change should be applied to translations. Translations' maintainers
accept only contributions that are merely translation related (e.g. new
translations, updates, fixes).
Translations try to be as accurate as possible but it is not possible to map
one language directly to all other languages. Each language has its own
grammar and culture, so the translation of an English statement may need to be
adapted to fit a different language. For this reason, when viewing
translations, you may find slight differences that carry the same message but
in a different form.
If you need to communicate with the Linux community but you do not feel
comfortable writing in English, you can ask the translation's maintainers
for help.
요약·해설
index.rst:1-59번역 문서는 비영어 독자의 이해를 돕지만 공식 기술 기준은 영어 Linux 문서입니다. 번역이 코드나 영어 원문과 어긋날 때는 공식 원문을 우선하고, 기술 내용의 변경은 영어 문서에 먼저 반영한 뒤 번역으로 전파해야 합니다.