翻译流程中的问题

[rootsongjc]

@malphi 我们的流程里还有几个问题。

镜像更新

镜像我更新了，你合并下这个 PR吧，#1337

中文渲染失败

翻译指南里的预览部分需要更新下，建议全部使用 docker 的方式预览，另外要想预览中文内容还需要将 config.yaml中的这个地方给取消注释

    [languages.zh]
        contentDir = "content/zh"

现在执行 make serve 会报错：

Building with the build container: gcr.io/istio-testing/build-tools:2019-10-24T14-05-17.
Using docker credential directory /Users/jimmysong/.docker.
Building sites … WARN 2019/10/30 14:07:19 Content directory "/work/content/en/docs/tasks/traffic-management/egress" have both index.* and _index.* files, pick one.
WARN 2019/10/30 14:07:19 Content directory "/work/content/en/docs/tasks/traffic-management/ingress" have both index.* and _index.* files, pick one.
ERROR 2019/10/30 14:07:42 Image 'content/en/docs/tasks/telemetry/distributed-tracing/jaeger/./istio-tracing-list.png' was not found ("/work/content/zh/docs/tasks/telemetry/distributed-tracing/jaeger/index.md:35:5")
ERROR 2019/10/30 14:07:43 Image 'content/en/docs/tasks/telemetry/distributed-tracing/zipkin/./istio-tracing-list-zipkin.png' was not found ("/work/content/zh/docs/tasks/telemetry/distributed-tracing/zipkin/index.md:37:3")
Total in 45473 ms
Error: Error building site: "/work/content/zh/docs/tasks/telemetry/distributed-tracing/zipkin/index.md:37:3": failed to render shortcode "image": failed to process shortcode: "/work/layouts/shortcodes/image.html:106:20": execute of template failed: template: shortcodes/image.html:106:20: executing "shortcodes/image.html" at <imageConfig $path>: error calling imageConfig: open /work/content/en/docs/tasks/telemetry/distributed-tracing/zipkin/istio-tracing-list-zipkin.png: no such file or directory
Makefile.core.mk:30: recipe for target 'serve' failed
make: *** [serve] Error 255
make: *** [serve] Error 2

在正式开始翻译工程前需要保证当前的所有中文文档是正常的，可以通过 istio.io 的官方 CI。

[rootsongjc]

PS istio.io 中的 content_zh 目录是否可以删除？

[malphi]

好，我更新一下

[malphi]

PS istio.io 中的 content_zh 目录是否可以删除？

content/zh还是content_zh?我没看到这个目录

[rootsongjc]

PS istio.io 中的 content_zh 目录是否可以删除？

content/zh还是content_zh?我没看到这个目录

不好意思，是我本地遗留的。

[rootsongjc]

建议将 content/zh 目录内容先删掉，把英文的内容搬运过来，起码保证中文内容的目录结构跟英文的是一样的，这样也方便大家翻译。

[sirius1024]

建议将 content/zh 目录内容先删掉，把英文的内容搬运过来，起码保证中文内容的目录结构跟英文的是一样的，这样也方便大家翻译。

有同样的疑问，这样比较好，文件也无需有重命名操作。翻译成中文markdown即可，对吧？

[rootsongjc]

@sirius1024 是的，大家可以使用https://github.com/istio/istio.io/tree/archive 分支查看已归档的历史翻译。

[rootsongjc]

与另一个 issue 重复了，有问题请访问 #1445