为Web开发和内容作者运行docs.rockylinux.org网站的本地副本¶

本文档介绍了如何在本地计算机上重新创建且运行整个docs.rockylinux.org网站的本地副本。这是一项正在进行中的工作。

在以下情况下，运行文档网站的本地副本可能很有用：

您有兴趣了解docs.rockylinux.org网站的Web开发方面并为其做出贡献
您是一名作者，在贡献文档之前，您希望查看文档在Docs网站上的外观呈现
您是一名Web开发人员，希望贡献或帮助维护docs.rockylinux.org网站

一些注意事项:¶

本指南中的说明不是Rocky文档作者或内容贡献者的必备条件
整个环境在Docker容器中运行，因此您需要在本地计算机上安装Docker引擎
该容器构建在官方的RockyLinux docker镜像之上，可从 https://hub.docker.com/r/rockylinux/rockylinux 获得
容器将文档内容(guides、books、images等)与Web引擎(Mkdocs)分开
容器会启动一个监听端口为8000的本地Web服务器，而8000端口将被转发到Docker主机上

创建内容环境¶

将你本地系统中的当前工作目录改为你打算进行写作的文件夹，本指南的其余部分中，我们将该目录称为$ROCKYDOCS。在我们这里的演示中，$ROCKYDOCS指向我们演示系统上的~/projects/rockydocs。

如果$ROCKYDOCS尚不存在，请创建它，然后键入：
```
cd  $ROCKYDOCS
```
请确保您已经安装了git(dnf-y install git)。在 $ROCKYDOCS 中，使用git克隆官方Rocky文档内容存储库（git repository）。
```
git clone https://github.com/rocky-linux/documentation.git
```
现在您将拥有一个$ROCKYDOCS/Documentation文件夹。该文件夹是一个git存储库（git repository），由git进行控制。

创建并启动RockyDocs的Web开发环境¶

确保你的本地机器已经启动并运行了Docker（你可以用systemctl检查）
从终端中执行以下操作：
```
docker pull wsoyinka/rockydocs:latest
```
检查以确保镜像下载成功
```
docker image  ls
```

启动RockyDocs容器¶

从rockydocs的镜像中启动一个容器。

docker run -it --name rockydoc --rm \
    -p 8000:8000  \
    --mount type=bind,source="$(pwd)"/documentation,target=/documentation  \
    wsoyinka/rockydocs:latest

或者，如果您愿意并且安装了docker-compose，您也可以创建名为docker-compose.yml的撰写文件，内容如下：

version: "3.9"
services:
rockydocs:
    image: wsoyinka/rockydocs:latest
    volumes:
     - type: bind
      source: ./documentation
      target: /documentation
    container_name: rocky
 ports:
    - "8000:8000"

将文件名为docker-compose.yml保存在$ROCKYDOCS工作目录中，并通过运行以下命令启动服务/容器：

docker-compose  up

浏览本地的docs.rockylinux.org网站¶

容器启动且运行后，您现在应该可以将Web浏览器指向以下URL，以查看站点的本地副本：

http://localhost:8000

Author: Wale Soyinka

Contributors: tianci li, Steven Spencer