Wu XiangCheng | bd8ede4 | 2021-04-30 20:22:35 +0800 | [diff] [blame] | 1 | .. SPDX-License-Identifier: GPL-2.0 |
2 | |||||
Andy Deng | 2069889 | 2017-01-25 12:14:33 +0800 | [diff] [blame] | 3 | .. raw:: latex |
4 | |||||
5 | \renewcommand\thesection* | ||||
6 | \renewcommand\thesubsection* | ||||
Akira Yokosawa | f7ebe6b | 2021-05-26 00:25:39 +0900 | [diff] [blame] | 7 | \kerneldocCJKon |
Akira Yokosawa | e291ff6 | 2021-08-09 10:14:53 +0900 | [diff] [blame] | 8 | \kerneldocBeginSC |
Andy Deng | 2069889 | 2017-01-25 12:14:33 +0800 | [diff] [blame] | 9 | |
Wu XiangCheng | bd8ede4 | 2021-04-30 20:22:35 +0800 | [diff] [blame] | 10 | .. _linux_doc_zh: |
11 | |||||
Alex Shi | 744da90 | 2019-03-13 21:49:33 +0800 | [diff] [blame] | 12 | 中文翻译 |
13 | ======== | ||||
14 | |||||
Andy Deng | 2069889 | 2017-01-25 12:14:33 +0800 | [diff] [blame] | 15 | |
Wu XiangCheng | bd8ede4 | 2021-04-30 20:22:35 +0800 | [diff] [blame] | 16 | .. note:: |
17 | |||||
18 | **翻译计划:** | ||||
19 | 内核中文文档欢迎任何翻译投稿,特别是关于内核用户和管理员指南部分。 | ||||
20 | |||||
Hu Haowen | 4a52225 | 2021-06-08 15:52:07 +0800 | [diff] [blame] | 21 | 这是中文内核文档树的顶级目录。内核文档,就像内核本身一样,在很大程度上是一 |
22 | 项正在进行的工作;当我们努力将许多分散的文件整合成一个连贯的整体时尤其如此。 | ||||
23 | 另外,随时欢迎您对内核文档进行改进;如果您想提供帮助,请加入vger.kernel.org | ||||
24 | 上的linux-doc邮件列表。 | ||||
25 | |||||
Wu XiangCheng | bd8ede4 | 2021-04-30 20:22:35 +0800 | [diff] [blame] | 26 | 许可证文档 |
27 | ---------- | ||||
28 | |||||
29 | 下面的文档介绍了Linux内核源代码的许可证(GPLv2)、如何在源代码树中正确标记 | ||||
30 | 单个文件的许可证、以及指向完整许可证文本的链接。 | ||||
31 | |||||
32 | * Documentation/translations/zh_CN/process/license-rules.rst | ||||
33 | |||||
34 | 用户文档 | ||||
35 | -------- | ||||
36 | |||||
37 | 下面的手册是为内核用户编写的——即那些试图让它在给定系统上以最佳方式工作的 | ||||
38 | 用户。 | ||||
Alex Shi | ed85ae5 | 2020-07-13 19:58:07 +0800 | [diff] [blame] | 39 | |
Andy Deng | 2069889 | 2017-01-25 12:14:33 +0800 | [diff] [blame] | 40 | .. toctree:: |
Alex Shi | 744da90 | 2019-03-13 21:49:33 +0800 | [diff] [blame] | 41 | :maxdepth: 2 |
Andy Deng | 2069889 | 2017-01-25 12:14:33 +0800 | [diff] [blame] | 42 | |
Alex Shi | 37a607c | 2020-07-13 19:58:05 +0800 | [diff] [blame] | 43 | admin-guide/index |
Wu XiangCheng | bd8ede4 | 2021-04-30 20:22:35 +0800 | [diff] [blame] | 44 | |
45 | TODOList: | ||||
46 | |||||
47 | * kbuild/index | ||||
48 | |||||
49 | 固件相关文档 | ||||
50 | ------------ | ||||
51 | |||||
52 | 下列文档描述了内核需要的平台固件相关信息。 | ||||
53 | |||||
54 | TODOList: | ||||
55 | |||||
56 | * firmware-guide/index | ||||
57 | * devicetree/index | ||||
58 | |||||
59 | 应用程序开发人员文档 | ||||
60 | -------------------- | ||||
61 | |||||
62 | 用户空间API手册涵盖了描述应用程序开发人员可见内核接口方面的文档。 | ||||
63 | |||||
64 | TODOlist: | ||||
65 | |||||
66 | * userspace-api/index | ||||
67 | |||||
68 | 内核开发简介 | ||||
69 | ------------ | ||||
70 | |||||
71 | 这些手册包含有关如何开发内核的整体信息。内核社区非常庞大,一年下来有数千名 | ||||
72 | 开发人员做出贡献。与任何大型社区一样,知道如何完成任务将使得更改合并的过程 | ||||
73 | 变得更加容易。 | ||||
74 | |||||
75 | .. toctree:: | ||||
76 | :maxdepth: 2 | ||||
77 | |||||
Alex Shi | 744da90 | 2019-03-13 21:49:33 +0800 | [diff] [blame] | 78 | process/index |
Bernard Zhao | e514365 | 2021-04-15 13:43:06 +0800 | [diff] [blame] | 79 | dev-tools/index |
Wu XiangCheng | e18f54f | 2021-04-13 15:13:39 +0800 | [diff] [blame] | 80 | doc-guide/index |
Wu XiangCheng | 3501c96 | 2021-03-23 17:16:52 +0800 | [diff] [blame] | 81 | kernel-hacking/index |
Wu XiangCheng | 867e6d3 | 2021-05-17 18:34:20 +0800 | [diff] [blame] | 82 | maintainer/index |
Wu XiangCheng | bd8ede4 | 2021-04-30 20:22:35 +0800 | [diff] [blame] | 83 | |
84 | TODOList: | ||||
85 | |||||
86 | * trace/index | ||||
Wu XiangCheng | bd8ede4 | 2021-04-30 20:22:35 +0800 | [diff] [blame] | 87 | * fault-injection/index |
88 | * livepatch/index | ||||
89 | * rust/index | ||||
90 | |||||
91 | 内核API文档 | ||||
92 | ----------- | ||||
93 | |||||
94 | 以下手册从内核开发人员的角度详细介绍了特定的内核子系统是如何工作的。这里的 | ||||
95 | 大部分信息都是直接从内核源代码获取的,并根据需要添加补充材料(或者至少是在 | ||||
96 | 我们设法添加的时候——可能不是所有的都是有需要的)。 | ||||
97 | |||||
98 | .. toctree:: | ||||
99 | :maxdepth: 2 | ||||
100 | |||||
Yanteng Si | aa93de2 | 2021-04-16 18:32:30 +0800 | [diff] [blame] | 101 | core-api/index |
Wu XiangCheng | bd8ede4 | 2021-04-30 20:22:35 +0800 | [diff] [blame] | 102 | cpu-freq/index |
103 | iio/index | ||||
104 | sound/index | ||||
105 | filesystems/index | ||||
Yanteng Si | 8ce1162 | 2021-08-06 09:26:39 +0800 | [diff] [blame] | 106 | virt/index |
Yanteng Si | f4e60d9 | 2021-08-06 10:58:48 +0800 | [diff] [blame] | 107 | infiniband/index |
Yang Yang | 4f3791c | 2021-07-31 01:45:03 -0700 | [diff] [blame] | 108 | accounting/index |
Wu XiangCheng | bd8ede4 | 2021-04-30 20:22:35 +0800 | [diff] [blame] | 109 | |
110 | TODOList: | ||||
111 | |||||
112 | * driver-api/index | ||||
113 | * locking/index | ||||
Wu XiangCheng | bd8ede4 | 2021-04-30 20:22:35 +0800 | [diff] [blame] | 114 | * block/index |
115 | * cdrom/index | ||||
116 | * ide/index | ||||
117 | * fb/index | ||||
118 | * fpga/index | ||||
119 | * hid/index | ||||
120 | * i2c/index | ||||
121 | * isdn/index | ||||
Wu XiangCheng | bd8ede4 | 2021-04-30 20:22:35 +0800 | [diff] [blame] | 122 | * leds/index |
123 | * netlabel/index | ||||
124 | * networking/index | ||||
125 | * pcmcia/index | ||||
126 | * power/index | ||||
127 | * target/index | ||||
128 | * timers/index | ||||
129 | * spi/index | ||||
130 | * w1/index | ||||
131 | * watchdog/index | ||||
Wu XiangCheng | bd8ede4 | 2021-04-30 20:22:35 +0800 | [diff] [blame] | 132 | * input/index |
133 | * hwmon/index | ||||
134 | * gpu/index | ||||
135 | * security/index | ||||
136 | * crypto/index | ||||
137 | * vm/index | ||||
138 | * bpf/index | ||||
139 | * usb/index | ||||
140 | * PCI/index | ||||
141 | * scsi/index | ||||
142 | * misc-devices/index | ||||
143 | * scheduler/index | ||||
144 | * mhi/index | ||||
145 | |||||
146 | 体系结构无关文档 | ||||
147 | ---------------- | ||||
148 | |||||
149 | TODOList: | ||||
150 | |||||
151 | * asm-annotations | ||||
152 | |||||
153 | 特定体系结构文档 | ||||
154 | ---------------- | ||||
155 | |||||
156 | .. toctree:: | ||||
157 | :maxdepth: 2 | ||||
158 | |||||
159 | mips/index | ||||
160 | arm64/index | ||||
161 | riscv/index | ||||
Yanteng Si | 441ca97 | 2021-04-16 18:32:34 +0800 | [diff] [blame] | 162 | openrisc/index |
Yanteng Si | fa5b8fe | 2021-05-12 16:20:57 +0800 | [diff] [blame] | 163 | parisc/index |
Alex Shi | 744da90 | 2019-03-13 21:49:33 +0800 | [diff] [blame] | 164 | |
Wu XiangCheng | bd8ede4 | 2021-04-30 20:22:35 +0800 | [diff] [blame] | 165 | TODOList: |
166 | |||||
167 | * arm/index | ||||
168 | * ia64/index | ||||
169 | * m68k/index | ||||
170 | * nios2/index | ||||
Wu XiangCheng | bd8ede4 | 2021-04-30 20:22:35 +0800 | [diff] [blame] | 171 | * powerpc/index |
172 | * s390/index | ||||
173 | * sh/index | ||||
174 | * sparc/index | ||||
175 | * x86/index | ||||
176 | * xtensa/index | ||||
177 | |||||
178 | 其他文档 | ||||
179 | -------- | ||||
180 | |||||
181 | 有几份未排序的文档似乎不适合放在文档的其他部分,或者可能需要进行一些调整和/或 | ||||
182 | 转换为reStructureText格式,也有可能太旧。 | ||||
183 | |||||
184 | TODOList: | ||||
185 | |||||
186 | * staging/index | ||||
187 | * watch_queue | ||||
188 | |||||
Alex Shi | 744da90 | 2019-03-13 21:49:33 +0800 | [diff] [blame] | 189 | 目录和表格 |
190 | ---------- | ||||
191 | |||||
192 | * :ref:`genindex` | ||||
Akira Yokosawa | e291ff6 | 2021-08-09 10:14:53 +0900 | [diff] [blame] | 193 | |
194 | .. raw:: latex | ||||
195 | |||||
196 | \kerneldocEndSC |