技术

Linux内核文档内网部署

作者: EricXi 分类: 技术

11月 18, 2021

Linux内核文档迁移内网操作手册 notes: 若想直接过去内核文档,内网部署请直接访问 链接:https://pan.baidu.com/s/1I1EJplvZIqH0HPoSzuuMUw 提取码:6666 1. 迁移概述: 外网可在http://kernel.org/doc/html查看linux内核所有版本的文档,为方便内网查看手册特迁移外网文档入内网,Linux内核文档位于项目代码Documentation目录下 文档以reStructuredText文件存放,可通过Sphinx换成为HTML或PDF或LaTex格式文档,项目中makefile文件支持使用 make htmldocs 或 make pdfdocs 命令构建HTML或PDF格式的文档, 最终生成文件位于Documentation/output文件夹中,内网通过nginx或apache搭建web服务,移动output到/var/www/目录下,改名为对应版本如v4.19,则可通过web界面直接访问文档。 2. 具体步骤: 1. 下载内核代码 git clone https://github.com/torvalds/linux.git git checkout v4.19 -b v4.19 # 切换到要构建的内核版本 2. 安装Sphinx # python3安装 yum -y install python3.6 python3 -m pip install virtualenv # 其他依赖 内核文档构建系统包含一个扩展,可以处理GraphViz和SVG格式的图像为了让它工作,您需要同时安装GraphViz和ImageMagick包。 挂载方式安装texlive软件包,目前只有Sphinx 1.4及更高版本才支持这种构建。 对于PDF和LaTeX输出,还需要 XeLaTeX 3.

继续阅读