Re: [PATCH] docs/zh_CN: Adjust order and content of zh_CN/index.rst

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Wu XiangCheng <bobwxc@xxxxxxxx> 于2021年4月16日周五 下午4:06写道:
>
> Adjust order and content of zh_CN/index.rst to make it clear,
> Complete introductions and TODOLists.
>
> Signed-off-by: Wu XiangCheng <bobwxc@xxxxxxxx>
> ---
> docs-next tree
> base-commit: f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7
>
>  Documentation/translations/zh_CN/index.rst | 168 +++++++++++++++++++++++++++--
>  1 file changed, 159 insertions(+), 9 deletions(-)
>
> diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst
> index 2c154e18b37d..868efe11bb9d 100644
> --- a/Documentation/translations/zh_CN/index.rst
> +++ b/Documentation/translations/zh_CN/index.rst
> @@ -1,34 +1,184 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
>  .. raw:: latex
>
>         \renewcommand\thesection*
>         \renewcommand\thesubsection*
>
> +.. _linux_doc_zh:
> +
>  中文翻译
>  ========
>
> -这些手册包含有关如何开发内核的整体信息。内核社区非常庞大,一年下来有数千名开发
> -人员做出贡献。 与任何大型社区一样,知道如何完成任务将使得更改合并的过程变得更
> -加容易。
>
> -翻译计划:
> -内核中文文档欢迎任何翻译投稿,特别是关于内核用户和管理员指南部分。
> +.. note::
> +
> +   **翻译计划:**
> +   内核中文文档欢迎任何翻译投稿,特别是关于内核用户和管理员指南部分。
> +
> +许可证文档
> +----------
> +
> +下面的文档介绍了Linux内核源代码的许可证(GPLv2)、如何在源代码树中正确标记
> +单个文件的许可证、以及指向完整许可证文本的链接。
> +
> +* Documentation/translations/zh_CN/process/license-rules.rst
> +
> +用户文档
> +--------
> +
> +下面的手册是为内核用户编写的——即那些试图让它在给定系统上以最佳方式工作的
> +用户。
>
>  .. toctree::
>     :maxdepth: 2
>
>     admin-guide/index
> +
> +TODOList:
> +
> +* kbuild/index
> +
> +固件相关文档
> +------------
> +
> +下列文档描述了内核需要的平台固件相关信息。
> +
> +TODOList:
> +
> +* firmware-guide/index
> +* devicetree/index
> +
> +应用程序开发人员文档
> +--------------------
> +
> +用户空间API手册涵盖了描述应用程序开发人员可见内核接口方面的文档。
> +
> +TODOlist:
> +
> +* userspace-api/index
> +
> +内核开发简介
> +------------
> +
> +这些手册包含有关如何开发内核的整体信息。内核社区非常庞大,一年下来有数千名
> +开发人员做出贡献。与任何大型社区一样,知道如何完成任务将使得更改合并的过程
> +变得更加容易。
> +
> +.. toctree::
> +   :maxdepth: 2
> +
>     process/index
>     dev-tools/index
>     doc-guide/index
>     kernel-hacking/index
> -   filesystems/index
> -   arm64/index
> -   sound/index
> +
> +TODOList:
> +
> +* trace/index
> +* maintainer/index
> +* fault-injection/index
> +* livepatch/index
> +* rust/index
> +
> +内核API文档
> +-----------
> +
> +以下手册从内核开发人员的角度详细介绍了特定的内核子系统是如何工作的。这里的
> +大部分信息都是直接从内核源代码获取的,并根据需要添加补充材料(或者至少是在
> +我们设法添加的时候——可能不是所有的都是有需要的)。
> +
> +.. toctree::
> +   :maxdepth: 2
> +
>     cpu-freq/index
> -   mips/index
>     iio/index
> +   sound/index
> +   filesystems/index
> +
> +TODOList:
> +
> +* driver-api/index
> +* core-api/index
> +* locking/index
> +* accounting/index
> +* block/index
> +* cdrom/index
> +* ide/index
> +* fb/index
> +* fpga/index
> +* hid/index
> +* i2c/index
> +* isdn/index
> +* infiniband/index
> +* leds/index
> +* netlabel/index
> +* networking/index
> +* pcmcia/index
> +* power/index
> +* target/index
> +* timers/index
> +* spi/index
> +* w1/index
> +* watchdog/index
> +* virt/index
> +* input/index
> +* hwmon/index
> +* gpu/index
> +* security/index
> +* crypto/index
> +* vm/index
> +* bpf/index
> +* usb/index
> +* PCI/index
> +* scsi/index
> +* misc-devices/index
> +* scheduler/index
> +* mhi/index
> +
> +体系结构无关文档
> +----------------
> +
> +TODOList:
> +
> +* asm-annotations
> +
> +特定体系结构文档
> +----------------
> +
> +.. toctree::
> +   :maxdepth: 2
> +
> +   mips/index
> +   arm64/index
>     riscv/index
>
> +TODOList:
> +
> +* arm/index
> +* ia64/index
> +* m68k/index
> +* nios2/index
> +* openrisc/index
> +* parisc/index
> +* powerpc/index
> +* s390/index
> +* sh/index
> +* sparc/index
> +* x86/index
> +* xtensa/index
> +
> +其他文档
> +--------
> +
> +有几份未排序的文档似乎不适合放在文档的其他部分,或者可能需要进行一些调整和/或
和/或?
emmm…… can you remove one? Or split into two sentences?:)
> +转换为reStructureText格式,也有可能太旧。
> +
> +TODOList:
> +
> +* staging/index
> +* watch_queue
> +
>  目录和表格
>  ----------
>
>
> --
> 2.11.0
>

Thanks,

Yanteng




[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux