跳至内容

简介

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