本地构建和运行本网站

    为了保证本地运行测试的工具和 Istio 持续集成（CI）运行测试的工具是相同的版本，我们提供了一个包含了所有需要工具的 Docker 镜像，包括了我们站点的生成器：Hugo。

    为了本地构建，测试和预览站点，要在您的系统上安装 。

    预览变更

    为了预览您对站点的修改，在 的分支根目录执行下面的命令：

    如果您要从远程服务器上构建和预览，可以使用 ISTIO_SERVE_DOMAIN 来设置这个服务器的 IP 地址或者 DNS 域名，例如：

    这个例子是在 这个远程服务器上构建站点并且启动一个 web 服务器。像前面一样，可以通过 http://192.168.7.105:1313 这个地址来访问这个 web 服务器。

    我们使用静态检测和测试方法，通过自动检查确保网站内容的质量基线。提交的贡献都必须成功通过这些检测才能被批准合入主线。在您提交 PR 之前确保在本地已经运行了这些检查。我们会执行以下自动检查：

    • HTML 校对：确保所有链接以及其它检查均有效。
    • 拼写检查：确保所有内容的拼写都是正确的。

    如果拼写检查有错误，很有可能是以下原因：

    • 有错别字：在 Markdown 文件上修复错别字。
    • 报告有命令，字段或者符号名称错误：将带有错误的内容放在反引号中。

    如果网络链接不稳定，可能会无法使用链接检查器。如果您的网络链接不好，可以设置检查器不检查外部链接。例如：在运行静态检查之前，设置环境变量 INTERNAL_ONLY 为 True：

    当您修改的内容通过所有检查，就可以把修改作为 PR 向仓库提交了。更多信息请访问。