简介¶
如果您愿意,可以本地构建文档系统,而无需 Docker 或 LXD。但是,如果您选择使用此过程,请注意,如果您进行大量的 Python 编码或在本地使用 Python,那么最安全的做法是创建一个 Python 虚拟环境,此处有描述。这可以保护您的所有 Python 进程彼此隔离,这是推荐的做法。如果您选择使用此过程,但没有 Python 虚拟环境,那么请注意,您正在承担一定程度的风险。
过程¶
克隆 docs.rockylinux.org 仓库
git clone https://github.com/rocky-linux/docs.rockylinux.org.git
完成后,进入 docs.rockylinux.org 目录
cd docs.rockylinux.org
现在使用以下命令克隆文档仓库
git clone https://github.com/rocky-linux/documentation.git docs
接下来,安装 mkdocs 的 requirements.txt 文件
python3 -m pip install -r requirements.txt
最后运行 mkdocs 服务器
mkdocs serve
结论¶
这提供了一种快速简单的方法来运行本地文档副本,而无需 Docker 或 LXD。如果您选择此方法,您应该真正设置一个 Python 虚拟环境来保护您的其他 Python 进程。
作者: Lukas Magauer
贡献者: Steven Spencer, Ganna Zhyrnova