요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
=========================
Il sottosistema I2C/SMBus
=========================
Introduzione
============
.. toctree::
:maxdepth: 1
summary
i2c-protocol
Scrivere un device driver
=========================
.. toctree::
:maxdepth: 1
Debugging
=========
.. toctree::
:maxdepth: 1
Slave I2C
=========
.. toctree::
:maxdepth: 1
Argomenti avanzati
==================
.. toctree::
:maxdepth: 1
.. only:: subproject and html
Indici
======
* :ref:`genindex`
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
라이선스, 제목, 소개 문서
1-15이 문서는 `GPL-2.0`으로 배포되는 이탈리아어 I2C 문서 묶음의 색인입니다. 최상위 제목은 I2C와 SMBus를 하나의 하위 시스템으로 묶어 안내합니다.
`Introduzione` 섹션의 `toctree`는 깊이를 1로 제한합니다. 따라서 이 페이지에서는 직접 연결된 문서만 한 단계 목록으로 표시하고, 그 아래의 세부 장은 각 문서에서 탐색합니다.
현재 소개 섹션에 실제로 연결된 문서는 `summary`와 `i2c-protocol` 두 개입니다. 앞 문서는 I2C와 SMBus의 개념 및 용어를 설명하고, 뒤 문서는 버스 트랜잭션의 기호와 메시지 순서를 설명합니다.
색인에 이름이 나타난다는 사실과 해당 문서의 번역 완료 여부는 별개입니다. 이 페이지는 연결 관계를 번역하며, 각 대상 문서는 자체 원문 해시와 전문 번역으로 따로 검증됩니다.
깊이 1의 `toctree`가 직접 노출하는 두 문서입니다.
색인은 두 문서의 진입점이며 내용을 대신하지 않습니다.
.. SPDX-License-Identifier: GPL-2.0
=========================
Il sottosistema I2C/SMBus
=========================
Introduzione
============
.. toctree::
:maxdepth: 1
summary
i2c-protocol
현재 비어 있는 주제 그룹
16-40`Scrivere un device driver`는 장치 드라이버 작성, `Debugging`은 디버깅, `Slave I2C`는 I2C 장치 역할, `Argomenti avanzati`는 고급 주제를 뜻합니다.
네 제목 아래에는 모두 `toctree` 지시문과 `:maxdepth: 1` 설정이 있지만, 현재 원문에는 포함할 문서 경로가 하나도 없습니다. 그러므로 이 색인에서 해당 제목은 보이더라도 하위 문서 링크는 생성되지 않습니다.
빈 `toctree`는 내용이 번역되었다는 뜻이 아닙니다. 이 전문 번역은 빈 상태 자체를 보존하며, 존재하지 않는 하위 문서나 설명을 임의로 추가하지 않습니다.
`Slave I2C`라는 제목은 원문에 남아 있는 역사적 표현입니다. 뒤의 개요 문서는 최신 권장 용어인 controller와 target/device를 설명하지만, 이 색인의 제목 문자열은 원문 보존 대상입니다.
제목은 있지만 원문 `toctree`에 하위 항목이 없는 네 그룹입니다.
제목과 탐색 컨테이너는 유지되지만 링크 항목은 생기지 않습니다.
Scrivere un device driver
=========================
.. toctree::
:maxdepth: 1
Debugging
=========
.. toctree::
:maxdepth: 1
Slave I2C
=========
.. toctree::
:maxdepth: 1
Argomenti avanzati
==================
.. toctree::
:maxdepth: 1
조건부 인덱스
41-46마지막 `only` 지시문은 빌드 조건이 `subproject and html`일 때만 아래 내용을 포함합니다. 즉 하위 프로젝트를 HTML로 만들 때에 한해 인덱스 섹션이 나타납니다.
조건이 참이면 `Indici`, 즉 인덱스 제목 아래에 Sphinx의 `genindex` 참조가 배치됩니다. 이것은 문서 본문의 새 장이 아니라 생성된 일반 색인으로 가는 링크입니다.
HTML이 아니거나 하위 프로젝트 조건을 만족하지 않으면 이 블록은 출력에서 제외됩니다. 원문 조건식과 `genindex` 앵커 이름은 번역하지 않고 그대로 보존합니다.
빌드 조건에 따른 마지막 블록의 표시 여부입니다.
두 조건을 모두 만족해야 생성 색인이 나타납니다.
.. only:: subproject and html
Indici
======
* :ref:`genindex`
요약·해설
index.rst:1-46이 색인은 I2C/SMBus 소개 문서 두 개를 직접 연결합니다. 드라이버 작성, 디버깅, I2C 장치 역할, 고급 주제는 제목과 빈 `toctree`만 있으므로 하위 문서가 있는 것으로 세지 않습니다.
`subproject and html` 조건에서는 Sphinx의 `genindex` 링크가 추가됩니다. 색인의 완료 상태는 이 46줄 전체를 번역하고 원문을 복원할 수 있는지로 판정하며, 연결된 다른 문서의 완료를 대신하지 않습니다.