简介¶
如果您愿意,可以在本地构建文档系统,无需 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