요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
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. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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 일반 색인을 연결하는 이탈리아어 목차입니다.