README_CN.md

Cloudpods文档

English | 简体中文

本仓库包含 Cloudpods 相关的文档。

安装依赖

文档的编译开发使用 docker 运行 hugo 容器来进行，这样的好处是不需要在本地安装配置 hugo ，保证开发环境的统一。

• docker: 安装 docker 请参考文档 https://docs.docker.com/get-docker/

查看文档网站

$ git clone https://github.com/yunionio/docs --recursive
$ cd docs

# 使用 docker 运行 hugo serve 容器
$ make container-serve
# 然后访问 http://localhost:1313 查看文档

编辑文档

文档在 content/{en,zh} 目录下，选择需要的部分进行编辑或者添加，内容组织请参考：https://gohugo.io/content-management/organization/。

文档头部 meta 元信息

# edition 标记文档包含在ce(开源版)或者ee(企业版)，如果不设置则表示两个版本都会包含
edition: ce

# docscope 表示文档所属的作用域，这个在离线编译模式会用到，默认为 system ，可以设置为 domain 和 project
docscope: project

# oem_ignore 表示该文档会在 oem 模式下编译被忽略
oem_ignore: true

编译文档

开发阶段的文档是没有多版本的，如果要查看多版本文档的效果，可以运行以下命令。

# 使用 docker 编译多版本的文档
# 生成的文档网站会在 ./public 目录下
$ make container-build
$ cd public && python3 -m http.server 1313

更新 Submodule

$ git submodule update --recursive
$ git pull --recurse-submodules

查看最新版本的效果

# 编译最新版本的文档，放到public目录中
make test
# 打开浏览器访问 http://localhost:1313