요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
=============================
4
Sound Subsystem Documentation
5
=============================
7
.. toctree::
8
:maxdepth: 2
10
kernel-api/index
11
designs/index
12
soc/index
13
alsa-configuration
14
hd-audio/index
15
cards/index
16
codecs/index
17
utimers
19
.. only:: subproject and html
21
Indices
22
=======
24
* :ref:`genindex`
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Sound subsystem 문서 트리
1-24이 문서는 GPL-2.0 라이선스의 Sound Subsystem Documentation 최상위 색인입니다. Sphinx `toctree`의 최대 깊이는 `2`이며 kernel API, 설계 문서, ASoC, ALSA 설정, HD-Audio, card, codec, userspace timer 문서를 차례로 연결합니다.
순서toctree 항목내용
1kernel-api/indexALSA kernel API와 driver 작성 안내
2designs/indexALSA subsystem 설계 문서
3soc/indexALSA System on Chip(ASoC) 문서
4alsa-configurationALSA driver별 module option과 설정
5hd-audio/indexHD-Audio 구현과 codec 문서
6cards/indexSound card별 문서
7codecs/indexAudio codec 문서
8utimersALSA userspace timer
원문의 toctree 순서와 각 항목의 역할을 보존했습니다.
HTML subproject로 생성될 때는 `Indices` 절에 `genindex` 참조를 표시합니다. 이 조건부 색인은 Sphinx의 전체 symbol 및 항목 색인으로 연결됩니다.
Sound Subsystem Documentation→Kernel API / designs / ASoC→ALSA configuration / HD-Audio→Cards / codecs / userspace timers→HTML subproject에서는 genindex 제공
최상위 색인이 기능군별 하위 문서로 이어지는 구조입니다.
.. SPDX-License-Identifier: GPL-2.0
=============================
Sound Subsystem Documentation
=============================
.. toctree::
:maxdepth: 2
kernel-api/index
designs/index
soc/index
alsa-configuration
hd-audio/index
cards/index
codecs/index
utimers
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
요약·해설
index.rst:1-24Sound subsystem의 Kernel API, 설계, ASoC, ALSA 설정, HD-Audio, card, codec, userspace timer 문서를 연결하는 최상위 색인입니다.
`toctree` 순서는 홈페이지 탐색 구조의 기준이며 HTML subproject에서는 `genindex`도 제공합니다.