Docker 文档编译 - 启用文档的部署特性

启用文档的部署特性

在默认的本地构建文档中,我们禁用了一些特性来缩短文档的构建时间。在针对 docs.docker.com 网站中部署的文档和本地构建的文档有下面的一些配置不同:

  • 使用 js/metadata.json 的自动搜索完成
  • google analytics 配置
  • 页面评分配置(page ratings)
  • 创建站点地图 sitemap.xml
  • 样式表的压缩和小型化(css/style.css)
  • 针对内容在其他仓库中的 “编辑页面(edit this page)” 页面的链接

如果你对上面的内容进行了修改的话,你可以在你的本地使用 “服务器(Production)” 构建。

为了能够预览针对服务器的部署环境的特性是否被启用了,你需要在对你的文档进行构建的时候设置 JEKYLL_ENV 环境变量。

JEKYLL_ENV=production docker-compose up --build

当构建完成后,请访 http://localhost:4000 地址中的内容来确定构建的正确。

如果你对文档进行了修改,并且需要重新构建的话,你需要重复上面的步骤。