启用文档的部署特性
在默认的本地构建文档中,我们禁用了一些特性来缩短文档的构建时间。在针对 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 地址中的内容来确定构建的正确。
如果你对文档进行了修改,并且需要重新构建的话,你需要重复上面的步骤。