요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. include:: ../disclaimer-ita.rst
.. note:: Per leggere la documentazione originale in inglese:
:ref:`Documentation/doc-guide/index.rst <doc_guide>`
.. _it_doc_guide:
==========================================
Come scrivere la documentazione del kernel
==========================================
.. toctree::
:maxdepth: 1
sphinx
kernel-doc
parse-headers
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
공식 원문과 문서 작성 도구 목차
1-18이 페이지는 이탈리아어 공통 면책 고지 `../disclaimer-ita.rst`를 포함하고, 영어 공식 문서 `Documentation/doc-guide/index.rst`의 `doc_guide` 참조를 안내합니다.
`_it_doc_guide`는 이탈리아어 페이지의 anchor이고 제목 `Come scrivere la documentazione del kernel`은 ‘커널 문서 작성 방법’을 뜻합니다.
깊이 1의 toctree는 `sphinx`, `kernel-doc`, `parse-headers` 세 문서를 연결합니다. 각각 문서 빌드 체계, 소스 주석 API 문서화, header parsing 도구를 다룹니다.
.. toctree::
:maxdepth: 1
sphinx
kernel-doc
parse-headers이탈리아어로 연결된 세 도구 문서입니다.
작성 대상에 따라 관련 가이드로 이동합니다.
.. include:: ../disclaimer-ita.rst
.. note:: Per leggere la documentazione originale in inglese:
:ref:`Documentation/doc-guide/index.rst <doc_guide>`
.. _it_doc_guide:
==========================================
Come scrivere la documentazione del kernel
==========================================
.. toctree::
:maxdepth: 1
sphinx
kernel-doc
parse-headers
HTML 하위 프로젝트 색인
19-24`subproject and html` 조건에서만 `Indices` 절을 표시합니다. HTML 하위 프로젝트 빌드에서 Sphinx 일반 색인 `genindex`로 연결됩니다.
조건 지시어와 `genindex` 참조는 렌더링 동작을 결정하므로 번역 과정에서도 그대로 보존합니다.
빌드 조건과 표시 결과입니다.
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
요약·해설
index.rst:1-24커널 문서 작성에 필요한 Sphinx, kernel-doc, parse-headers 가이드와 HTML 일반 색인을 연결하는 이탈리아어 목차입니다.