翻译问题汇总 #1445

malphi · 2019-11-05T07:26:16Z

翻译中遇到的问题，请回复本issue，描述一下具体的问题以及解决方法。最好贴出完整的错误信息。
我们会将问题合并到FAQ里供大家参考。

vflong · 2019-11-05T07:35:10Z

由于此页面引用了 adapters 术语，导致 adapters 术语标题无法修改，所以需要同时翻译此页面，然后重新提交。
报错信息如下：

$ make serve                                                           
Building with the build container: gcr.io/istio-testing/build-tools:2019-10-24T14-05-17.
Building sites … ERROR 2019/11/04 23:12:03 Could not find glossary entry for 'adapters' ("/work/content/zh/about/contribute/creating-and-editing-pages/index.md:551:12")
ERROR 2019/11/04 23:12:03 Could not find glossary entry for 'adapters' ("/work/content/zh/about/contribute/creating-and-editing-pages/index.md:561:15")
Total in 150454 ms
Error: Error building site: logged 2 error(s)
Makefile.core.mk:30: recipe for target 'serve' failed
make: *** [serve] Error 255
Makefile:104: recipe for target 'serve' failed
make: *** [serve] Error 2

可以同时解决解决两个 issue 不？

huntsman-li · 2019-11-05T07:40:12Z

问题：

解决：

通过官方给的提议 https://istio.io/about/contribute/creating-and-editing-pages/#linting
进行尝试，但还是没有解决问题

ilylia · 2019-11-05T07:49:10Z

问题：

解决：

通过官方给的提议 https://istio.io/about/contribute/creating-and-editing-pages/#linting
进行尝试，但还是没有解决问题

这种拼写错误是类似 Kubernetes 这种在 .spelling 文件中只加了首字母大写形式的单词，是否可以在锚点中也可以大写？ @malphi @rootsongjc

wangzewang · 2019-11-05T07:54:48Z

问题：

解决：

通过官方给的提议 https://istio.io/about/contribute/creating-and-editing-pages/#linting
进行尝试，但还是没有解决问题

@huntsman-li 在chrome中添加这个语法插件，copy有问题的行到chrome中任意的文本输入框里，这个插件可以提示你错误在哪里

huntsman-li · 2019-11-05T08:08:17Z

@wangzewang 这个应该不是普通的语法错误，其他贡献者也是这样去定义的

huntsman-li · 2019-11-05T08:44:32Z

经过测试，需要在.spelling文件中，增加一些词汇kpi、kubernetes、spiffe、vs、tls、servicerole、servicerolebinding、istio
@rootsongjc @malphi

sirius1024 · 2019-11-05T09:34:31Z

make lint通过以后，我是不是应该先git fetch upstream，然后merge当前issue的branch到本地master，然后提交PR到官方仓库？

gaohuag · 2019-11-05T09:50:47Z

key/cert secrets 翻译成什么好呢？

rootsongjc · 2019-11-05T09:53:17Z

有些简单的专有名词，建议不翻译。

luxious · 2019-11-05T09:53:55Z

key/cert secrets 翻译成什么好呢？

可以参考这个 pr
https://github.com/istio/istio.io/pull/5333/files
这里 key/cert 翻译的是: 密钥/证书
secrets 不翻译

gaohuag · 2019-11-05T09:59:47Z

key/cert secrets 翻译成什么好呢？

可以参考这个 pr
https://github.com/istio/istio.io/pull/5333/files
这里 key/cert 翻译的是: 密钥/证书
secrets 不翻译

谢谢

rootsongjc · 2019-11-05T10:38:46Z

make lint通过以后，我是不是应该先git fetch upstream，然后merge当前issue的branch到本地master，然后提交PR到官方仓库？

是的

rootsongjc · 2019-11-05T12:24:17Z

经过测试，需要在.spelling文件中，增加一些词汇kpi、kubernetes、spiffe、vs、tls、servicerole、servicerolebinding、istio
@rootsongjc @malphi

.spelling 文件中有这些词汇的大写形式，但是小写没有

huntsman-li · 2019-11-06T02:31:39Z

问题
本地只更新了 /docs/concepts/security/index.md文件
本地make serve 没问题

但是官方deploy/netlify 没通过，以下报错

10:06:58 AM: Build ready to start
10:06:59 AM: build-image version: 9e0f207a27642d0115b1ca97cd5e8cebbe492f63
10:06:59 AM: build-image tag: v3.3.2
10:06:59 AM: buildbot version: a2bab682ae0761baa4d123ebd00c57be933655dc
10:07:00 AM: Fetching cached dependencies
10:07:00 AM: Starting to download cache of 225.4MB
10:07:00 AM: Finished downloading cache in 788.578145ms
10:07:00 AM: Starting to extract cache
10:07:07 AM: Finished extracting cache in 6.19458211s
10:07:07 AM: Finished fetching cache in 7.124724386s
10:07:07 AM: Starting to prepare the repo for build
10:07:07 AM: Preparing Git Reference pull/5330/head
10:07:09 AM: Found netlify.toml. Overriding site configuration
10:07:09 AM: Starting build script
10:07:09 AM: Installing dependencies
10:07:10 AM: Started restoring cached node version
10:07:13 AM: Finished restoring cached node version
10:07:14 AM: v12.8.0 is already installed.
10:07:15 AM: Now using node v12.8.0 (npm v6.10.2)
10:07:15 AM: Attempting ruby version 2.6.2, read from environment
10:07:17 AM: Using ruby version 2.6.2
10:07:17 AM: Using PHP version 5.6
10:07:17 AM: Installing Hugo 0.58.2
10:07:17 AM: Hugo Static Site Generator v0.58.2-253E5FDC/extended linux/amd64 BuildDate: 2019-09-13T08:10:51Z
10:07:17 AM: Started restoring cached go cache
10:07:17 AM: Finished restoring cached go cache
10:07:17 AM: unset GOOS;
10:07:17 AM: unset GOARCH;
10:07:17 AM: export GOROOT='/opt/buildhome/.gimme/versions/go1.12.linux.amd64';
10:07:17 AM: export PATH="/opt/buildhome/.gimme/versions/go1.12.linux.amd64/bin:${PATH}";
10:07:17 AM: go version >&2;
10:07:17 AM: export GIMME_ENV='/opt/buildhome/.gimme/env/go1.12.linux.amd64.env';
10:07:17 AM: go version go1.12 linux/amd64
10:07:17 AM: Installing missing commands
10:07:17 AM: Verify run directory
10:07:17 AM: Executing user command: make netlify
10:07:17 AM: Building with your local toolchain.
10:07:17 AM: Wrote to /opt/build/repo/package.json:
10:07:17 AM: {
10:07:17 AM:   "name": "repo",
10:07:17 AM:   "version": "1.0.0",
10:07:17 AM:   "description": "| Site | Status |------|------- | istio.io | [![Netlify Status](https://api.netlify.com/api/v1/badges/c98435af-5464-4ac3-93c2-9c98faeec9b6/deploy-status)](https://app.netlify.com/sites/istio/deploys) | preliminary.istio.io | [![Netlify Status](https://api.netlify.com/api/v1/badges/a1cfd435-23d5-4a43-ac6d-8ec9230d9eb3/deploy-status)](https://app.netlify.com/sites/preliminary-istio/deploys) | archive.istio.io | [![Netlify Status](https://api.netlify.com/api/v1/badges/f8c3eecb-3c5c-48d9-b952-54c7ed0ece8f/deploy-status)](https://app.netlify.com/sites/archive-istio/deploys)",
10:07:17 AM:   "main": "index.js",
10:07:17 AM:   "directories": {
10:07:17 AM:     "example": "examples",
10:07:17 AM:     "test": "test"
10:07:17 AM:   },
10:07:17 AM:   "scripts": {
10:07:17 AM:     "test": "echo \"Error: no test specified\" && exit 1"
10:07:17 AM:   },
10:07:17 AM:   "keywords": [],
10:07:17 AM:   "author": "",
10:07:17 AM:   "license": "ISC"
10:07:17 AM: }
10:07:32 AM: /opt/buildhome/.nvm/versions/node/v12.8.0/bin/babel -> /opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/@babel/cli/bin/babel.js
10:07:32 AM: /opt/buildhome/.nvm/versions/node/v12.8.0/bin/babel-external-helpers -> /opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/@babel/cli/bin/babel-external-helpers.js
10:07:32 AM: /opt/buildhome/.nvm/versions/node/v12.8.0/bin/sass -> /opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/sass/sass.js
10:07:32 AM: /opt/buildhome/.nvm/versions/node/v12.8.0/bin/svgstore -> /opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/svgstore-cli/bin/svgstore
10:07:32 AM: /opt/buildhome/.nvm/versions/node/v12.8.0/bin/tsserver -> /opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/typescript/bin/tsserver
10:07:32 AM: /opt/buildhome/.nvm/versions/node/v12.8.0/bin/tsc -> /opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/typescript/bin/tsc
10:07:33 AM: npm WARN
10:07:33 AM: optional SKIPPING OPTIONAL DEPENDENCY: [email protected] (node_modules/sass/node_modules/fsevents):
10:07:33 AM: npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for [email protected]: wanted {"os":"darwin","arch":"any"} (current: {"os":"linux","arch":"x64"})
10:07:33 AM: npm WARN optional SKIPPING OPTIONAL DEPENDENCY: [email protected] (node_modules/@babel/cli/node_modules/fsevents):
10:07:33 AM: npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for [email protected]: wanted {"os":"darwin","arch":"any"} (current: {"os":"linux","arch":"x64"})
10:07:33 AM: + [email protected]
10:07:33 AM: + @babel/[email protected]
10:07:33 AM: + [email protected]
10:07:33 AM: + @babel/[email protected]
10:07:33 AM: + @babel/[email protected]
10:07:33 AM: + [email protected]
10:07:33 AM: added 2 packages from 1 contributor, removed 3 packages and updated 75 packages in 14.58s
10:07:35 AM: npm notice
10:07:35 AM:  created a lockfile as package-lock.json. You should commit this file.
10:07:35 AM: npm
10:07:35 AM: WARN [email protected] No repository field.
10:07:35 AM: audited 40 packages in 1.101s
10:07:35 AM: found 0 vulnerabilities
10:07:37 AM: > [email protected] postinstall /opt/build/repo/node_modules/core-js
10:07:37 AM: > node postinstall || echo "ignore"
10:07:37 AM: Thank you for using core-js ( https://github.com/zloirock/core-js ) for polyfilling JavaScript standard library!
10:07:37 AM: The project needs your help! Please consider supporting of core-js on Open Collective or Patreon: 
10:07:37 AM: > https://opencollective.com/core-js 
10:07:37 AM: > https://www.patreon.com/zloirock 
10:07:37 AM: Also, the author of core-js ( https://github.com/zloirock ) is looking for a good job -)
10:07:37 AM: npm WARN
10:07:37 AM:  [email protected] No repository field.
10:07:37 AM: + @babel/[email protected]
10:07:37 AM: added 35 packages from 9 contributors and audited 43 packages in 1.553s
10:07:37 AM: found 0 vulnerabilities
10:07:41 AM: TypeError: Cannot set property inList of [object Object] which has only a getter
10:07:41 AM:     at PluginPass.exit (/opt/build/repo/node_modules/babel-plugin-minify-simplify/lib/index.js:549:40)
10:07:41 AM:     at newFn (/opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/@babel/core/node_modules/@babel/traverse/lib/visitors.js:179:21)
10:07:41 AM:     at NodePath._call (/opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/@babel/core/node_modules/@babel/traverse/lib/path/context.js:55:20)
10:07:41 AM:     at NodePath.call (/opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/@babel/core/node_modules/@babel/traverse/lib/path/context.js:42:17)
10:07:41 AM:     at NodePath.visit (/opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/@babel/core/node_modules/@babel/traverse/lib/path/context.js:99:8)
10:07:41 AM:     at TraversalContext.visitQueue (/opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/@babel/core/node_modules/@babel/traverse/lib/context.js:112:16)
10:07:41 AM:     at TraversalContext.visitSingle (/opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/@babel/core/node_modules/@babel/traverse/lib/context.js:84:19)
10:07:41 AM:     at TraversalContext.visit (/opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/@babel/core/node_modules/@babel/traverse/lib/context.js:140:19)
10:07:41 AM:     at Function.traverse.node (/opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/@babel/core/node_modules/@babel/traverse/lib/index.js:84:17)
10:07:41 AM:     at NodePath.visit (/opt/buildhome/.nvm/versions/node/v12.8.0/lib/node_modules/@babel/core/node_modules/@babel/traverse/lib/path/context.js:97:18)
10:07:41 AM: Makefile.core.mk:49: recipe for target 'netlify' failed
10:07:41 AM: make: *** [netlify] Error 1
10:07:41 AM: Skipping functions preparation step: no functions directory set
10:07:41 AM: Caching artifacts
10:07:41 AM: Started saving node modules
10:07:41 AM: Finished saving node modules
10:07:41 AM: Started saving pip cache
10:07:41 AM: Finished saving pip cache
10:07:41 AM: Started saving emacs cask dependencies
10:07:41 AM: failed during stage 'building site': Build script returned non-zero exit code: 2
10:07:41 AM: Finished saving emacs cask dependencies
10:07:41 AM: Started saving maven dependencies
10:07:41 AM: Finished saving maven dependencies
10:07:41 AM: Started saving boot dependencies
10:07:41 AM: Finished saving boot dependencies
10:07:41 AM: Started saving go dependencies
10:07:41 AM: Finished saving go dependencies
10:07:41 AM: Error running command: Build script returned non-zero exit code: 2
10:07:41 AM: Failing build: Failed to build site
10:07:42 AM: Finished processing build request in 42.438921146s

解决
已经解决，问题在于官方的 bug，在2019年11月5日23点左右解决，具体 pr
Workaround for sudden Netlify errors istio/istio.io#5379

rootsongjc · 2019-11-06T02:36:10Z

@huntsman-li 请先 rebase 下 upstream 的 master 分支，这个问题好像昨晚官方已经解决了。

zqzzq · 2019-11-06T03:43:19Z

Building with your local toolchain.
Building sites … 
                   | EN  | ZH   
+------------------+-----+-----+
  Pages            | 547 | 545  
  Paginator pages  |   0 |   0  
  Non-page files   | 164 | 164  
  Static files     |  54 |  54  
  Processed images |   0 |   0  
  Aliases          |   1 |   0  
  Sitemaps         |   2 |   1  
  Cleaned          |   0 |   0  

Total in 76124 ms
>> 431 files are free from spelling errors
>> 429 files are free from spelling errors
Running ["LinkCheck", "HtmlCheck", "OpenGraphCheck", "ImageCheck", "ScriptCheck"] on ["./public"] on *.html... 


Found 0 links in the cache...
Adding 898 links to the cache...
Removing 0 links from the cache...
Checking 898 external links...
Ran on 761 files!


- ./public/about/community/join/index.html
  *  External link http://www.servicemesher.com failed: got a time out (response code 301)
htmlproofer 3.12.0 | Error:  HTML-Proofer found 1 failure!
LINTING FAILED
Makefile.core.mk:27: recipe for target 'lint' failed
make: *** [lint] Error 1

这种链接超时错误怎么办

rootsongjc · 2019-11-06T04:05:05Z

@zqzzq 这个链接 http://www.servicemesher.com 改成 https://www.servicemesher.com 应该就没问题了。

TomatoAres · 2019-11-06T06:47:36Z

执行 hugo 时渲染出错：failed to render shortcode "tip"

PS C:\gopath\src\github.com\TomatoAres\istio.io> hugo server
Building sites … Total in 2282 ms
Error: Error building site: "...\istio.io\content\en\docs\setup\install\multicluster\gateways\index.md:66:5": failed to render shortcode "tip": failed to process shortcode: execute of template failed: template: shortcodes/text.html:2:4: executing "shortcodes/text.html" at <partial "code_block.html" .>: error calling partial: "C:\gopath\src\github.com\TomatoAres\istio.io\layouts\partials\code_block.html:62:106": execute of template failed: template: partials/code_block.html:62:106: executing "partials/code_block.html" at <.Page.Position>: can't evaluate field Position in type page.Page

rootsongjc · 2019-11-06T08:01:30Z

执行 hugo 时渲染出错：failed to render shortcode "tip"

PS C:\gopath\src\github.com\TomatoAres\istio.io> hugo server
Building sites … Total in 2282 ms
Error: Error building site: "...\istio.io\content\en\docs\setup\install\multicluster\gateways\index.md:66:5": failed to render shortcode "tip": failed to process shortcode: execute of template failed: template: shortcodes/text.html:2:4: executing "shortcodes/text.html" at <partial "code_block.html" .>: error calling partial: "C:\gopath\src\github.com\TomatoAres\istio.io\layouts\partials\code_block.html:62:106": execute of template failed: template: partials/code_block.html:62:106: executing "partials/code_block.html" at <.Page.Position>: can't evaluate field Position in type page.Page

这个是 hugo 的 shortcode，请查看你修改的文档是否该 shortcode 引用的格式错误。

TomatoAres · 2019-11-06T15:02:05Z

执行 hugo 时渲染出错：failed to render shortcode "tip"
PS C:\gopath\src\github.com\TomatoAres\istio.io> hugo server
Building sites … Total in 2282 ms
Error: Error building site: "...\istio.io\content\en\docs\setup\install\multicluster\gateways\index.md:66:5": failed to render shortcode "tip": failed to process shortcode: execute of template failed: template: shortcodes/text.html:2:4: executing "shortcodes/text.html" at <partial "code_block.html" .>: error calling partial: "C:\gopath\src\github.com\TomatoAres\istio.io\layouts\partials\code_block.html:62:106": execute of template failed: template: partials/code_block.html:62:106: executing "partials/code_block.html" at <.Page.Position>: can't evaluate field Position in type page.Page

这个是 hugo 的 shortcode，请查看你修改的文档是否该 shortcode 引用的格式错误。

我还未开始翻译工作，只是想预览以下效果，这只是将代码clone 下来之后，hugo 报的错误。
替换了几个不同版本的 hugo ，包括自己重新使用hugo 源码编译出的二进制，出现同样的问题
查看hugo shortcode 文档，shortcode 关联的文件在 layouts/shortcodes 也找到对应的模板文件，
换了台电脑，同样的地方报的warn，可以启动 server ，但是最终无法正常显示
我自己的站也是 hugo 搭的，测试可以正常启动server，并正常显示

vflong · 2019-11-06T15:26:33Z

执行 hugo 时渲染出错：failed to render shortcode "tip"
PS C:\gopath\src\github.com\TomatoAres\istio.io> hugo server
Building sites … Total in 2282 ms
Error: Error building site: "...\istio.io\content\en\docs\setup\install\multicluster\gateways\index.md:66:5": failed to render shortcode "tip": failed to process shortcode: execute of template failed: template: shortcodes/text.html:2:4: executing "shortcodes/text.html" at <partial "code_block.html" .>: error calling partial: "C:\gopath\src\github.com\TomatoAres\istio.io\layouts\partials\code_block.html:62:106": execute of template failed: template: partials/code_block.html:62:106: executing "partials/code_block.html" at <.Page.Position>: can't evaluate field Position in type page.Page

这个是 hugo 的 shortcode，请查看你修改的文档是否该 shortcode 引用的格式错误。

我还未开始翻译工作，只是想预览以下效果，这只是将代码clone 下来之后，hugo 报的错误。

替换了几个不同版本的 hugo ，包括自己重新使用hugo 源码编译出的二进制，出现同样的问题

查看hugo shortcode 文档，shortcode 关联的文件在 layouts/shortcodes 也找到对应的模板文件，

换了台电脑，同样的地方报的warn，可以启动 server ，但是最终无法正常显示

我自己的站也是 hugo 搭的，测试可以正常启动server，并正常显示

建议使用 make serve 运行，可以参考我在 Ubuntu 中的配置。

TomatoAres · 2019-11-06T15:57:55Z

参考istio issue 换用 ubuntu ，问题同样，
浏览器 F12 debug，发现缺少 js,css 等文件

TomatoAres · 2019-11-06T16:31:43Z

不整了，不能预览反正不影响翻译工作

luxious · 2019-11-07T01:19:48Z

不整了，不能预览反正不影响翻译工作

同样建议 make serve，因为我的 hugo 也不能运行。

JuwanXu · 2019-11-07T04:49:42Z

Building with your local toolchain.
Building sites … 
                   | EN  | ZH   
+------------------+-----+-----+
  Pages            | 547 | 546  
  Paginator pages  |   0 |   0  
  Non-page files   | 164 | 164  
  Static files     |  54 |  54  
  Processed images |   0 |   0  
  Aliases          |   1 |   0  
  Sitemaps         |   2 |   1  
  Cleaned          |   0 |   0  

Total in 70464 ms
>> 431 files are free from spelling errors
>> 430 files are free from spelling errors
Running ["OpenGraphCheck", "ScriptCheck", "LinkCheck", "HtmlCheck", "ImageCheck"] on ["./public"] on *.html... 


Found 0 links in the cache...
Adding 899 links to the cache...
Removing 0 links from the cache...
Checking 899 external links...
Ran on 762 files!


- ./public/zh/docs/reference/config/policy-and-telemetry/adapters/cloudmonitor/index.html
  *  External link https://cloudmonitor.console.aliyun.com/ failed: got a time out (response code 302)
htmlproofer 3.12.0 | Error:  HTML-Proofer found 1 failure!
LINTING FAILED
Makefile.core.mk:27: recipe for target 'lint' failed
make: *** [lint] Error 1

这个错误怎么解决？

rootsongjc · 2019-11-07T05:02:22Z

@JuwanXu 这是因为 cotent/zh/docs/reference/config/policy-and-telemetry/adapters/cloudmonitor/index.md文件里的 https://cloudmonitor.console.aliyun.com/ 链接问题，这个并不是你提交的文档里的链接，暂时先不用管。

charili · 2019-11-09T02:17:35Z

这个错误有遇到的吗？

ERROR 2019/11/09 10:10:35 "/Users/liqing/project/open_source/istio.io/content/zh/news/2019/announcing-1.1.17/index.md:13:1": failed to render shortcode "relnote": failed to process shortcode: "/Users/liqing/project/open_source/istio.io/layouts/shortcodes/relnote.html:76:41": execute of template failed: template: shortcodes/relnote.html:76:41: executing "shortcodes/relnote.html" at <.Page.GetPage>: can't evaluate field Page in type *hugolib.Page
ERROR 2019/11/09 10:10:35 "/Users/liqing/project/open_source/istio.io/content/zh/news/2019/announcing-1.3.3/index.md:14:1": failed to render shortcode "relnote": failed to process shortcode: "/Users/liqing/project/open_source/istio.io/layouts/shortcodes/relnote.html:76:41": execute of template failed: template: shortcodes/relnote.html:76:41: executing "shortcodes/relnote.html" at <.Page.GetPage>: can't evaluate field Page in type *hugolib.Page
ERROR 2019/11/09 10:10:35 "/Users/liqing/project/open_source/istio.io/content/zh/news/2019/announcing-1.1.16/index.md:13:1": failed to render shortcode "relnote": failed to process shortcode: "/Users/liqing/project/open_source/istio.io/layouts/shortcodes/relnote.html:76:41": execute of template failed: template: shortcodes/relnote.html:76:41: executing "shortcodes/relnote.html" at <.Page.GetPage>: can't evaluate field Page in type *hugolib.Page
ERROR 2019/11/09 10:10:35 "/Users/liqing/project/open_source/istio.io/content/zh/news/2019/announcing-1.3.2/index.md:13:1": failed to render shortcode "relnote": failed to process shortcode: "/Users/liqing/project/open_source/istio.io/layouts/shortcodes/relnote.html:76:41": execute of template failed: template: shortcodes/relnote.html:76:41: executing "shortcodes/relnote.html" at <.Page.GetPage>: can't evaluate field Page in type *hugolib.Page
WARNING: make non-relative ref/relref page reference(s) in page "/news/2019/announcing-1.3.4/index.md" absolute, e.g. {{< ref "/blog/my-post.md" >}}
Total in 47396 ms
Error: Error building site: "/Users/liqing/project/open_source/istio.io/content/zh/news/2019/announcing-1.2.8/index.md:13:1": failed to render shortcode "relnote": failed to process shortcode: "/Users/liqing/project/open_source/istio.io/layouts/shortcodes/relnote.html:76:41": execute of template failed: template: shortcodes/relnote.html:76:41: executing "shortcodes/relnote.html" at <.Page.GetPage>: can't evaluate field Page in type *hugolib.Page

charili · 2019-11-09T03:38:02Z

docker 版本为Docker version 17.12.0-ce ,通过Make Server的方式启动会遇到权限问题：
docker: Error response from daemon: Mounts denied:
The path /etc/passwd
is not shared from OS X and is not known to Docker.
You can configure shared paths from Docker -> Preferences... -> File Sharing.
See https://docs.docker.com/docker-for-mac/osxfs/#namespaces for more info.

修改本地Makefile 文件找到RUN命令行：修改卷的映射：
-v /etc/passwd:/etc/passwd:ro 为 -v /private/etc/passwd:/etc/passwd:ro
后可以通过Make Server 启动

huntsman-li · 2019-11-11T03:04:58Z

问题
经过翻译，发现content/zh/docs/tasks/security 和 content/en/docs/tasks/security 下的内容不一致，这个问题是否会导致其他问题，是否需要校准

malphi · 2019-11-12T13:10:27Z

问题
经过翻译，发现content/zh/docs/tasks/security 和 content/en/docs/tasks/security 下的内容不一致，这个问题是否会导致其他问题，是否需要校准

拉取最新的，follow en的

donychen1134 · 2019-11-15T09:03:59Z

CLA 问题：
google CLA 一直无法通过，多次修改用户名、邮箱仍然不行。
此时，在终端里，切换到提交的分支目录下，执行：git log 命令，查看提交的用户名与邮箱地址。
一般该问题是由于公司内用户名、邮箱，和 github 邮箱不一致导致的。使用 git log 里查看到的用户名、邮箱签署 CLA 即可。

WisWang · 2019-11-20T01:32:34Z

我这个PR#5748 lint_istio.io — Job failed. 这块一直过不去，这是报错 lint 的链接，这个不知道该怎么debug。

zxh326 · 2019-11-20T12:21:10Z

istio/istio.io#5725
遇到netlify报错

12:13:55 AM: Building sites …
12:15:05 AM: ERROR 2019/11/15 16:15:05 Could not find glossary entry for 'workload instance' ("/opt/build/repo/content/zh/docs/setup/deployment-models/index.md:107:1")

看起来是因为我改了标题导致找个不到这个 gloass

deployment-models/index.md:107:1

{{< gloss "workload instance" >}}workload instances{{< /gloss >}}
can reach each other directly without an Istio gateway.

WisWang · 2019-11-26T08:35:38Z

我这个PR#5748 lint_istio.io — Job failed. 这块一直过不去，这是报错 lint 的链接，这个不知道该怎么debug。

这个问题解决了，有两个错误，其中一个由于在我文件的200行的开头kubernetes之后没有空行，还有一个问题是在176行有个类似的乱码，我最开始用的vs code看不出来，后来把那行放到sublime就能看出来了，显示如下：

把特殊字符删了就好了。这次多谢@tanjunchen的帮助！

malphi · 2019-12-20T03:45:42Z

Error: Error building site: "/work/content/zh/docs/ops/diagnostic-tools/proxy-cmd/index.md:160:3": failed to render shortcode "text": failed to process shortcode: execute of template failed: template: shortcodes/text.html:2:4: executing "shortcodes/text.html" at <partial "code_block.html" .>: error calling partial: "/work/layouts/partials/code_block.html:62:106": execute of template failed: template: partials/code_block.html:62:106: executing "partials/code_block.html" at <.Page.Position>: can't evaluate field Position in type page.Page

这种问题在code_block.html:62中提示是text tag不能有缩进，其实主要原因是开闭两个tag不一致导致。建议统一成一个tab即可。

3ks · 2019-12-24T09:48:07Z

ERROR: Invalid char in CDATA 0x8 解决方案

错误提示

lint 时出现下面这种情况：

- ./public/zh/docs/tasks/traffic-management/ingress/ingress-sni-passthrough/index.html
* 68494:14: ERROR: Invalid char in CDATA 0x8 (line 68494)

通过错误信息，我们可以定位到具体的 md 文件，但是还无法定位到具体的某一行，对于这种无效字符，肉眼排查可能比较痛苦，这里有一种快速查找无效字符的方法。

快速排查

其实 lint 提示了我们，无效的字符是 0x8，这里我们可以通过 IDE 的 正则搜索 快速找到该字符。

这里我使用的是 Goland（IDEA 系），Ctrl+F 打开搜索框，输入 \+0x8，并勾选 Regx 即可。

然后删掉该字符即可。

其他字符

其它 无效字符方法相同：

根据 lint 提示信息定位到具体的 md 文件
搜索对应的无效字符并删除即可。

3ks · 2020-01-03T14:08:13Z

灵异的 MD038 错误快速排查

错误提示

有同学在翻译过程中遇到了 MD038 错误，lint 提示信息是这样的：

./zh/news/releases/1.1.x/announcing-1.1/helm-changes/index.md:7: MD038 Spaces inside code span elements

按照一般思维，定位到对应文件的第 7 行，发现第七行是空行，并且相邻的两行（第 6 行，第 8 行）也可以确认不存在错误，也就是说没有什么可修改的。

猜测这里是因为 Istio lint 程序的缺陷导致无法定位错误的位置。

错误原因

经过痛苦的排查后，发现错误确实不在第 7 行，先说一下相关情况以及错误原因。

这是一个包含了大量表格的 helm-change.md 文件，其格式类似于这种：

键	旧默认值	新默认值	新描述
`global.proxy.resources.requests.cpu`	`10m`	`100m`
`global.proxy.accessLogFile`	`"/dev/stdout"`	`""`
`global.proxy.enableCoreDump`	`false`	`false`	`如果设置，新注入的 sidecars 将启用 core dumps`

文本是：

| 键 | 旧默认值 | 新默认值 | 旧描述 | 新描述 |
| --- | --- | --- | --- | --- |
| `global.proxy.resources.requests.cpu` | `10m` | `100m` |  |  |
| `global.proxy.accessLogFile` | `"/dev/stdout"` | `""` |  |  |
| `global.proxy.enableCoreDump` | `false` | `false` |  | `如果设置，新注入的 sidecars 将启用 core dumps ` |

通过文本可以看到，除非单元格为空，否则，每个单元格的内容都用 ` ` 包裹着，且 ` 与 | 之间有一个空格，完整文件可参考这里。

`如果设置，新注入的 sidecars 将启用 core dumps `

错误的原因（我的情况）是：dumps 和 ` 之间有一个空格，没错就只是一个空格，一个空格……

解决方法：删掉这个空格即可解决 lint 错误。

类似问题

` ` 包裹内容的 尾缀 空格，lint 无法 给出正确的错误行数，例如前面遇到的这种情况。

` ` 包裹内容的 前缀 空格，lint 可以 给出正确的错误行数，但是会导致附近的 多行 一起报错，这种情况，其实只需要修复错误的那一行即可，并不表示每一行都有错。

快速排查

这种不起眼的空格肉眼排查比较痛苦。不过在了解错误原因后，我们就可以快速的定位到错误位置，并修复。

Ctrl+F 打开你使用的编辑器的搜索框，输入 `（空格，反引号，空格）

注意，该文件的 格式 决定了，两侧的空格是必不可少的，否则搜索结果会变成这样：

解决方法

原谅我这个唠叨的孤寡老人：

快速排查 找到导致 lint 失败的空格
删掉它

Kuri-su · 2021-03-19T08:03:26Z

有个疑问...为啥没有 reference 部分的文章的翻译任务.....

例如 envoy filter https://istio.io/latest/zh/docs/reference/config/networking/envoy-filter/

rootsongjc · 2021-03-19T08:33:15Z

请见第三轮翻译，https://i.cloudnative.to/istio/event/istio-doc-translation

mesher-bot added the welcome 新 Issue，尚未处理 label Nov 5, 2019

yuxiaobo96 mentioned this issue Nov 6, 2019

add some vocabularies in .spelling file istio/istio.io#5406

Closed

This comment has been minimized.

Sign in to view

SataQiu added pending 待认领（新任务/有更新） and removed welcome 新 Issue，尚未处理 labels Nov 19, 2019

rootsongjc modified the milestone: 1.5 Dec 25, 2019

rootsongjc mentioned this issue Dec 25, 2019

翻译流程中的问题 #1338

Closed

rootsongjc pinned this issue Dec 31, 2019

3ks added welcome 新 Issue，尚未处理 and removed pending 待认领（新任务/有更新） labels Jan 1, 2020

rootsongjc closed this as completed Mar 19, 2021

翻译问题汇总 #1445

翻译问题汇总 #1445

Comments

malphi commented Nov 5, 2019

vflong commented Nov 5, 2019 • edited Loading

huntsman-li commented Nov 5, 2019

ilylia commented Nov 5, 2019

wangzewang commented Nov 5, 2019

huntsman-li commented Nov 5, 2019

huntsman-li commented Nov 5, 2019 • edited Loading

sirius1024 commented Nov 5, 2019

gaohuag commented Nov 5, 2019

rootsongjc commented Nov 5, 2019

luxious commented Nov 5, 2019

gaohuag commented Nov 5, 2019

rootsongjc commented Nov 5, 2019

rootsongjc commented Nov 5, 2019

huntsman-li commented Nov 6, 2019 • edited Loading

rootsongjc commented Nov 6, 2019

zqzzq commented Nov 6, 2019

rootsongjc commented Nov 6, 2019

TomatoAres commented Nov 6, 2019 • edited Loading

rootsongjc commented Nov 6, 2019

TomatoAres commented Nov 6, 2019 • edited Loading

vflong commented Nov 6, 2019

TomatoAres commented Nov 6, 2019

TomatoAres commented Nov 6, 2019

luxious commented Nov 7, 2019

JuwanXu commented Nov 7, 2019

rootsongjc commented Nov 7, 2019

This comment has been minimized.

charili commented Nov 9, 2019

charili commented Nov 9, 2019

huntsman-li commented Nov 11, 2019

malphi commented Nov 12, 2019

donychen1134 commented Nov 15, 2019

WisWang commented Nov 20, 2019

zxh326 commented Nov 20, 2019

WisWang commented Nov 26, 2019

malphi commented Dec 20, 2019

3ks commented Dec 24, 2019

ERROR: Invalid char in CDATA 0x8 解决方案

错误提示

快速排查

其他字符

3ks commented Jan 3, 2020

灵异的 MD038 错误快速排查

错误提示

错误原因

类似问题

快速排查

解决方法

Kuri-su commented Mar 19, 2021

rootsongjc commented Mar 19, 2021

vflong commented Nov 5, 2019 •

edited

Loading

huntsman-li commented Nov 5, 2019 •

edited

Loading

huntsman-li commented Nov 6, 2019 •

edited

Loading

TomatoAres commented Nov 6, 2019 •

edited

Loading

TomatoAres commented Nov 6, 2019 •

edited

Loading