JuneBurning / kernel-doc

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

内核文档选译

内核文档是采用sphinx撰写,这种文档撰写方法值得借鉴,可以作为自己技术工作文档撰写指南。

我想选择一些自己感兴趣的项目做一些选译,基于Kernel Document的翻译来学习。

Linux Kernel Documentation是包含在 Linux 内核源代码的 Documentation 目录下,下载源代码之后就可以阅读。

License: 文档翻译自Linux Kernel Document,应该是和内核相同的GPL协议

  • 从Linux Kernel Documentation目录复制出需要选译的文档子目录
src_doc_dir=/usr/src/kernels/linux/Documentation
dst_doc_dir=/home/huatai/github/kernel-doc

cp $src_doc_dir/index.rst $dst_doc_dir/
cp $src_doc_dir/conf.py $dst_doc_dir/
cp -R $src_doc_dir/sphinx $dst_doc_dir/
cp -R $src_doc_dir/admin-guide $dst_doc_dir/
cp -R $src_doc_dir/kernel-hacking $dst_doc_dir/
cp -R $src_doc_dir/doc-guide $dst_doc_dir/
cp -R $src_doc_dir/vm $dst_doc_dir/
cp -R $src_doc_dir/trace $dst_doc_dir/
  • 将文档版本明确写入config.py文件(在Documentation是根据Makefile中配置获得):
echo "version = release = 'v4.20.0'" >> conf.py

以上步骤已经执行过一次,无需再次执行

  • 使用如下命令来构建文档:
sphinx-build -b html . output

输出的文档位于 output 子目录,可以很方便做文档翻译。

About


Languages

Language:Python 59.4%Language:Perl 39.5%Language:Vim Script 1.1%