跳到内容

简介

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