English | 简体中文
FluidDoc包含了所有PaddlePaddle相关的文档，它通过CI系统为PaddlePaddle.org提供文档内容
FluidDoc将Paddle, Book 作为子模块，并放置在 external 目录下。按照标准做法，所有的子模块应当置于external 目录下
FluidDoc通过引用这些子模块来加载这些Repo中的文档。FluidDoc在 FluidDoc/doc/fluid 目录下构建了文档的整体树形结构。可以分别在 FluidDoc/doc/fluid/index_cn.rst 和 FluidDoc/doc/fluid/index_en.rst 查看。
当一个新发布的分支被push到了Github上，Travis-CI 将会自动启动编译文档并把文档部署到服务器
FluidDoc 需要Paddle Repo的python模块去编译生成API文档。但由于Paddle的python模块过于庞大，超过了Travis CI允许的最大时长，通常Travis CI将会因为超时问题失败。这是Travis上有三项作业的原因，其中两项用于构建库。当Travis缓存了这些库以后，下一次的构建将会变得非常的快。
为了预览FluidDoc的文档，请按照常规预览步骤，但请在这一步将 paddle 的路径替换为 Fluid 的路径
./runserver --paddle <path_to_FluidDoc_dir>
- 创建一个新的分支，此分支的名字应遵循
release/<version> - 在FluidDoc和子模块中更新文档
- 确认所有的子模块中处于发布就绪的状态。Paddle, book 应全部有稳定的commit 请注意：如果Paddle Repo更改了module/classes，涉及API文档的RST文件应当也被更新
- 在
external中更新文件然后commit文档变更 - 将这个分支push到Github，Travis CI将会启动几项构建工作以把文档发布到PaddlePaddle.org的服务器
- 请告知PaddlePaddle.org团队，发布的内容已经就绪。PaddlePaddle.org团队将使版本生效并更新默认的版本到最新版。PaddlePaddle.org也应当更新相应的搜索引擎文件