요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
===============================
Documentazione dell'API di base
===============================
Utilità di base
===============
.. toctree::
:maxdepth: 1
symbol-namespaces
Primitive di sincronizzazione
=============================
Come Linux impedisce che tutto si verifichi contemporaneamente. Consultate
Documentation/translations/it_IT/locking/index.rst per maggiorni informazioni
sul tema.
.. toctree::
:maxdepth: 1
../RCU/index
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
핵심 유틸리티 목차
1-12이 페이지의 이탈리아어 제목 `Documentazione dell'API di base`는 ‘핵심 API 문서’를 뜻합니다. 첫 하위 절 `Utilità di base`는 ‘핵심 유틸리티’입니다.
깊이 1의 toctree는 `symbol-namespaces` 문서를 연결합니다. 이는 커널 symbol namespace의 정의와 사용법을 설명하는 이탈리아어 Core API 문서로 이어집니다.
.. toctree::
:maxdepth: 1
symbol-namespaces
현재 이 절에 등록된 Core API 문서입니다.
===============================
Documentazione dell'API di base
===============================
Utilità di base
===============
.. toctree::
:maxdepth: 1
symbol-namespaces
동기화 프리미티브
13-24`Primitive di sincronizzazione`는 ‘동기화 프리미티브’를 뜻합니다. Linux가 모든 일이 동시에 벌어져 충돌하지 않게 만드는 방법을 다루는 문서 영역입니다.
더 자세한 잠금 문서는 `Documentation/translations/it_IT/locking/index.rst`에서 확인하라고 안내합니다. 원문의 `maggiorni` 표기는 그대로 보존되지만 문맥상 ‘더 많은 정보’를 뜻합니다.
이 절의 toctree는 상대 경로 `../RCU/index`를 연결합니다. RCU는 읽기 중심 동시성에서 업데이트와 reclamation을 조정하는 Linux 동기화 메커니즘입니다.
.. toctree::
:maxdepth: 1
../RCU/index
Core API 목차에서 잠금 안내와 RCU 번역 문서로 이동합니다.
Primitive di sincronizzazione
=============================
Come Linux impedisce che tutto si verifichi contemporaneamente. Consultate
Documentation/translations/it_IT/locking/index.rst per maggiorni informazioni
sul tema.
.. toctree::
:maxdepth: 1
../RCU/index
HTML 하위 프로젝트 색인
25-30마지막 블록은 `subproject and html` 조건에서만 출력됩니다. 즉 전체 문서가 아닌 HTML 하위 프로젝트 빌드일 때 색인 절을 노출합니다.
`genindex` 참조는 Sphinx가 생성하는 일반 색인으로 연결됩니다. 조건 지시어와 참조 이름은 빌드 동작을 결정하므로 그대로 유지합니다.
빌드 조건과 표시 대상을 정리합니다.
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
요약·해설
index.rst:1-30이 페이지는 이탈리아어 핵심 API 문서의 목차입니다. symbol namespace 문서와 RCU·잠금 번역 문서를 연결하고, HTML 하위 프로젝트에서는 Sphinx 일반 색인을 표시합니다.