]Isphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget/indexmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/zh_TW/indexmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/it_IT/indexmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/ja_JP/indexmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/ko_KR/indexmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/sp_SP/indexmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageChinese (Simplified)uh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhF/var/lib/git/docbuild/linux/Documentation/translations/zh_CN/index.rsthKubhraw)}(hY\renewcommand\thesection* \renewcommand\thesubsection* \kerneldocCJKon \kerneldocBeginSC{h]hY\renewcommand\thesection* \renewcommand\thesubsection* \kerneldocCJKon \kerneldocBeginSC{}hhsbah}(h]h ]h"]h$]h&]formatlatexhhuh1hhhhKhhhhubhtarget)}(h.. _linux_doc_zh:h]h}(h]h ]h"]h$]h&]refid linux-doc-zhuh1hhK hhhhhhubhsection)}(hhh](htitle)}(h 中文翻译h]h 中文翻译}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhK ubhnote)}(hu**翻译计划:** 内核中文文档欢迎任何翻译投稿，特别是关于内核用户和管理员指南部分。h]h paragraph)}(hu**翻译计划:** 内核中文文档欢迎任何翻译投稿，特别是关于内核用户和管理员指南部分。h](hstrong)}(h**翻译计划:**h]h 翻译计划:}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhubhd 内核中文文档欢迎任何翻译投稿，特别是关于内核用户和管理员指南部分。}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh)}(hXk这是中文内核文档树的顶级目录。内核文档，就像内核本身一样，在很大程度上是一 项正在进行的工作；当我们努力将许多分散的文件整合成一个连贯的整体时尤其如此。 另外，随时欢迎您对内核文档进行改进；如果您想提供帮助，请加入vger.kernel.org 上的linux-doc邮件列表。h]hXk这是中文内核文档树的顶级目录。内核文档，就像内核本身一样，在很大程度上是一 项正在进行的工作；当我们努力将许多分散的文件整合成一个连贯的整体时尤其如此。 另外，随时欢迎您对内核文档进行改进；如果您想提供帮助，请加入vger.kernel.org 上的linux-doc邮件列表。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hXE顺便说下，中文文档也需要遵守内核编码风格，风格中中文和英文的主要不同就是中文 的字符标点占用两个英文字符宽度，所以，当英文要求不要超过每行100个字符时， 中文就不要超过50个字符。另外，也要注意'-'，'='等符号与相关标题的对齐。在将 补丁提交到社区之前，一定要进行必要的 ``checkpatch.pl`` 检查和编译测试，确保 在 ``make htmldocs/pdfdocs`` 中不增加新的告警，最后，安装检查你生成的 html/pdf 文件，确认它们看起来是正常的。h](hX顺便说下，中文文档也需要遵守内核编码风格，风格中中文和英文的主要不同就是中文 的字符标点占用两个英文字符宽度，所以，当英文要求不要超过每行100个字符时， 中文就不要超过50个字符。另外，也要注意’-’，’=’等符号与相关标题的对齐。在将 补丁提交到社区之前，一定要进行必要的 }(hj#hhhNhNubhliteral)}(h``checkpatch.pl``h]h checkpatch.pl}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1j+hj#ubh$ 检查和编译测试，确保 在 }(hj#hhhNhNubj,)}(h``make htmldocs/pdfdocs``h]hmake htmldocs/pdfdocs}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1j+hj#ubht 中不增加新的告警，最后，安装检查你生成的 html/pdf 文件，确认它们看起来是正常的。}(hj#hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(h提交之前请确认你的补丁可以正常提交到中文文档维护库: https://git.kernel.org/pub/scm/linux/kernel/git/alexs/linux.git/ 如果你的补丁依赖于其他人的补丁, 可以与其他人商量后由某一个人合并提交。h](hM提交之前请确认你的补丁可以正常提交到中文文档维护库: }(hjWhhhNhNubh reference)}(h@https://git.kernel.org/pub/scm/linux/kernel/git/alexs/linux.git/h]h@https://git.kernel.org/pub/scm/linux/kernel/git/alexs/linux.git/}(hjahhhNhNubah}(h]h ]h"]h$]h&]refurijcuh1j_hjWubhi 如果你的补丁依赖于其他人的补丁, 可以与其他人商量后由某一个人合并提交。}(hjWhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK!hhhhubh)}(hhh](h)}(h!与Linux 内核社区一起工作h]h!与Linux 内核社区一起工作}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhhhhhK&ubh)}(hK与内核开发社区进行协作并将工作推向上游的基本指南。h]hK与内核开发社区进行协作并将工作推向上游的基本指南。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK(hjzhhubhcompound)}(hhh]htoctree)}(hhh]h}(h]h ]h"]h$]h&]htranslations/zh_CN/indexentries](N.translations/zh_CN/process/development-processN-translations/zh_CN/process/submitting-patches 行为准则*translations/zh_CN/process/code-of-conductN#translations/zh_CN/maintainer/index完整开发流程文档 translations/zh_CN/process/indexe includefiles](jjjjjemaxdepthKcaptionNglobhidden includehiddennumberedK titlesonly rawentries](jjeuh1jhhhK*hjubah}(h]h ]toctree-wrapperah"]h$]h&]uh1jhjzhhhhhNubeh}(h]linuxah ]h"]!与linux 内核社区一起工作ah$]h&]uh1hhhhhhhhK&ubh)}(hhh](h)}(h内部API文档h]h内部API文档}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK4ubh)}(h6开发人员使用的内核内部交互接口手册。h]h6开发人员使用的内核内部交互接口手册。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjhhubj)}(hhh]j)}(hhh]h}(h]h ]h"]h$]h&]hjj](N!translations/zh_CN/core-api/indexN#translations/zh_CN/driver-api/indexN!translations/zh_CN/subsystem-apis内核中的锁 translations/zh_CN/locking/indexej](jjjjejKjNjjjjKjj]jauh1jhhhK8hjubah}(h]h ]jah"]h$]h&]uh1jhjhhhhhNubeh}(h]apiah ]h"]内部api文档ah$]h&]uh1hhhhhhhhK4ubh)}(hhh](h)}(h开发工具和流程h]h开发工具和流程}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKAubh)}(hE为所有内核开发人员提供有用信息的各种其他手册。h]hE为所有内核开发人员提供有用信息的各种其他手册。}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKChjhhubj)}(hhh]j)}(hhh]h}(h]h ]h"]h$]h&]hjj](N(translations/zh_CN/process/license-rulesN"translations/zh_CN/doc-guide/indexN"translations/zh_CN/dev-tools/indexN-translations/zh_CN/dev-tools/testing-overviewN'translations/zh_CN/kernel-hacking/indexNtranslations/zh_CN/rust/indexej](jCjEjGjIjKjMejKjNjjjjKjj]uh1jhhhKEhj6ubah}(h]h ]jah"]h$]h&]uh1jhjhhhhhNubh)}(h TODOList:h]h TODOList:}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjhhubh bullet_list)}(hhh](h list_item)}(h trace/indexh]h)}(hjnh]h trace/index}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKQhjlubah}(h]h ]h"]h$]h&]uh1jjhjghhhhhNubjk)}(hfault-injection/indexh]h)}(hjh]hfault-injection/index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhjubah}(h]h ]h"]h$]h&]uh1jjhjghhhhhNubjk)}(hlivepatch/index h]h)}(hlivepatch/indexh]hlivepatch/index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKShjubah}(h]h ]h"]h$]h&]uh1jjhjghhhhhNubeh}(h]h ]h"]h$]h&]bullet*uh1jehhhKQhjhhubeh}(h]id2ah ]h"]开发工具和流程ah$]h&]uh1hhhhhhhhKAubh)}(hhh](h)}(h面向用户的文档h]h面向用户的文档}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKVubh)}(h下列手册针对 希望内核在给定系统上以最佳方式工作的*用户*， 和查找内核用户空间API信息的程序开发人员。h]h下列手册针对 希望内核在给定系统上以最佳方式工作的*用户*， 和查找内核用户空间API信息的程序开发人员。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKXhjhhubj)}(hhh]j)}(hhh]h}(h]h ]h"]h$]h&]hjj](N$translations/zh_CN/admin-guide/indexN/translations/zh_CN/admin-guide/reporting-issuesN&translations/zh_CN/userspace-api/index内核构建系统translations/zh_CN/kbuild/indexej](jjjjejKjNjjjjKjj]jauh1jhhhK\hjubah}(h]h ]jah"]h$]h&]uh1jhjhhhhhNubh)}(h TODOList:h]h TODOList:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKdhjhhubjf)}(hhh]jk)}(h!用户空间工具 h]h)}(h 用户空间工具 h]h 用户空间工具 }(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhjubah}(h]h ]h"]h$]h&]uh1jjhj hhhhhNubah}(h]h ]h"]h$]h&]jjuh1jehhhKfhjhhubh)}(hc也可参考独立于内核文档的 `Linux 手册页 `_ 。h](h%也可参考独立于内核文档的 }(hj.hhhNhNubj`)}(h:`Linux 手册页 `_h]hLinux 手册页}(hj6hhhNhNubah}(h]h ]h"]h$]h&]nameLinux 手册页refuri%https://www.kernel.org/doc/man-pages/uh1j_hj.ubh)}(h( h]h}(h]id4ah ]h"]linux 手册页ah$]h&]refurijGuh1hƌ referencedKhj.ubh 。}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhjhhubeh}(h]id3ah ]h"]面向用户的文档ah$]h&]uh1hhhhhhhhKVubh)}(hhh](h)}(h固件相关文档h]h固件相关文档}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhhKkubh)}(h?下列文档描述了内核需要的平台固件相关信息。h]h?下列文档描述了内核需要的平台固件相关信息。}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKmhjhhhubj)}(hhh]j)}(hhh]h}(h]h ]h"]h$]h&]hjj]N#translations/zh_CN/devicetree/indexaj]jajKjNjjjjKjj]uh1jhhhKohjubah}(h]h ]jah"]h$]h&]uh1jhjhhhhhhNubh)}(h TODOList:h]h TODOList:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKthjhhhubjf)}(hhh]jk)}(hfirmware-guide/index h]h)}(hfirmware-guide/indexh]hfirmware-guide/index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKvhjubah}(h]h ]h"]h$]h&]uh1jjhjhhhhhNubah}(h]h ]h"]h$]h&]jjuh1jehhhKvhjhhhubeh}(h]id5ah ]h"]固件相关文档ah$]h&]uh1hhhhhhhhKkubh)}(hhh](h)}(h体系结构文档h]h体系结构文档}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKyubj)}(hhh]j)}(hhh]h}(h]h ]h"]h$]h&]hjj]Ntranslations/zh_CN/arch/indexaj]jajKjNjjjjKjj]uh1jhhhK{hjubah}(h]h ]jah"]h$]h&]uh1jhjhhhhhNubeh}(h]id6ah ]h"]体系结构文档ah$]h&]uh1hhhhhhhhKyubh)}(hhh](h)}(h 其他文档h]h 其他文档}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(h有几份未分类的文档似乎不适合放在文档的其他部分，或者可能需要进行一些调整和/或 转换为reStructureText格式，也有可能太旧。h]h有几份未分类的文档似乎不适合放在文档的其他部分，或者可能需要进行一些调整和/或 转换为reStructureText格式，也有可能太旧。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hhh]j)}(hhh]h}(h]h ]h"]h$]h&]hjj]N translations/zh_CN/staging/indexaj]j1ajKjNjjjjKjj]uh1jhhhKhj$ubah}(h]h ]jah"]h$]h&]uh1jhjhhhhhNubeh}(h]id7ah ]h"] 其他文档ah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h 术语表h]h 术语表}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjChhhhhKubj)}(hhh]j)}(hhh]h}(h]h ]h"]h$]h&]hjj]Ntranslations/zh_CN/glossaryaj]jaajKjNjjjjKjj]uh1jhhhKhjTubah}(h]h ]jah"]h$]h&]uh1jhjChhhhhNubeh}(h]id8ah ]h"] 术语表ah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h索引和表格h]h索引和表格}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjshhhhhKubjf)}(hhh]jk)}(h:ref:`genindex` h]h)}(h:ref:`genindex`h]h)}(hjh]hinline)}(hjh]hgenindex}(hjhhhNhNubah}(h]h ](xrefstdstd-refeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdocj refdomainjreftyperef refexplicitrefwarn reftargetgenindexuh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jjhjhhhhhNubah}(h]h ]h"]h$]h&]jjuh1jehhhKhjshhubh)}(h}\kerneldocEndSCh]h}\kerneldocEndSC}hjsbah}(h]h ]h"]h$]h&]formatlatexhhuh1hhhhKhjshhubeh}(h]id9ah ]h"]索引和表格ah$]h&]uh1hhhhhhhhKubeh}(h](hӌid1eh ]h"]( 中文翻译 linux_doc_zheh$]h&]uh1hhhhhhhhK expect_referenced_by_name}jhsexpect_referenced_by_id}hhsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}h]hasnameids}(jhjjjjjjjjjejbjQjNjjjjj@j=jpjmjju nametypes}(jjjjjjejQjjj@jpjuh}(hhjhjjzjjjjjbjjNjHjjhjjj=jjmjCjjsu footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jK sRparse_messages]transform_messages]hsystem_message)}(hhh]h)}(hhh]h2Hyperlink target "linux-doc-zh" is not referenced.}hjvsbah}(h]h ]h"]h$]h&]uh1hhjsubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehlineK uh1jquba transformerN include_log] decorationNhhub.