dapr-cn / docs Goto Github PK

refer to https://github.com/dapr/docs-zh/pull/15/files

contact to crowdin to fix it

https://crowdin.com/translate/cndocsdapr/15808/en-zhcn?filter=basic&value=0

请在此留下你的 crowdin id

crowdin.yml 中指定的翻译内容和原文内容的对应关系。这是 crowdin 的一个配置内容。目前存在一个问题：

1. 规则使用通配符的方式编写，这使得 crowdin cli 在进行 --delete-obselote 的内容的时候，无法正常剔除内容，因为通配符会全部命中

因此：

1. 需要使用脚本来生成每一个文件单独规则的清单，并且每次更新时自动更新 crowdin.yml

https://crowdin.com/translate/cndocsdapr/15852/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15784/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15812/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15850/en-zhcn?filter=basic&value=0

结论：
对于代码段，不应该对其进行翻译。应该使用 "Hide String" 功能对其进行隐藏。操作如下图：

该规则可以扩展应用到其他任何不需要翻译的内容上。例如：

1. 单行代码段
   
2. hugo metadata 头部内容
   
3. hugo 代码块
   

注意，混编在文本中的代码段不受此规则约束。

原因：

例如，存在以下代码段

aaaa
bbbb
cccc

如果直接将内容直接拷贝为翻译内容，则该词条会进入TM。如果代码段内容发生了变化，变为：

aaaa
bbbb
cccc
dddd

当使用 TM 进行翻译时，由于 crowdin 的识别问题，可能会导致该段出现内容重复，格式错乱的情况。
故而以上内容若在 TM 中不存在，则不会出现错误的替换。

https://crowdin.com/translate/cndocsdapr/15806/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15886/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15818/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15828/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15830/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15840/en-zhcn?filter=basic&value=0

Most of them are inserted incorrectly at the beginning of this project.
create a python script in tasks.py in the main branch and run it in github action.

API: https://support.crowdin.com/api/v2/#operation/api.tms.delete

There are some docs with aliases like:

---
type: docs
title: "How-To: Configure state store and pub/sub message broker"
linkTitle: "(optional) Configure state & pub/sub"
weight: 80
description: "Configure state store and pub/sub message broker components for Dapr"
aliases:
  - /getting-started/configure-redis/
---

and it should be updated to url with zh-hans prefix like

---
aliases:
  - /zh-hans/getting-started/configure-redis/
---

It should be done at tasks.py
https://github.com/dapr-cn/docs/blob/main/src/scripts/tasks.py

crowdin 的识别问题，已经联系客服，并确认为 crowdin 系统 bug。等待期官方进行修复。

https://crowdin.com/translate/cndocsdapr/15820/en-zhcn?filter=basic&value=0

Most of them are inserted incorrectly at the beginning of this project.
create a python script in tasks.py in the main branch and run it in github action.

API: https://support.crowdin.com/api/v2/#operation/api.projects.translations.delete

https://crowdin.com/translate/cndocsdapr/15782/en-zhcn?filter=basic&value=0

Hugo 头部标记

我觉得linkTitle还是应该翻译，除非为特点术语，或cli 命令
目前效果看起来比较奇怪

https://crowdin.com/translate/cndocsdapr/15802/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15848/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15816/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15894/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15824/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15814/en-zhcn?filter=basic&value=0

dapr/docs#1485

不知道怎么提交 pr 到中文站

https://crowdin.com/translate/cndocsdapr/15838/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15834/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15822/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/17078/en-zhcn?filter=basic&value=5
https://crowdin.com/translate/cndocsdapr/17074/en-zhcn?filter=basic&value=5
https://crowdin.com/translate/cndocsdapr/17076/en-zhcn?filter=basic&value=5
https://crowdin.com/translate/cndocsdapr/17088/en-zhcn?filter=basic&value=5
https://crowdin.com/translate/cndocsdapr/17082/en-zhcn?filter=basic&value=5
https://crowdin.com/translate/cndocsdapr/17084/en-zhcn?filter=basic&value=5
https://crowdin.com/translate/cndocsdapr/17086/en-zhcn?filter=basic&value=5

https://crowdin.com/translate/cndocsdapr/15826/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15810/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15892/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15844/en-zhcn?filter=basic&value=0

https://crowdin.com/project/cndocsdapr/zh-CN#/v1.6_translate_site/content/content/reference/components-reference/supported-pubsub

Hello,

Please reference the changes documented in dapr/docs#1879 to make the same changes in the Dapr CN docs. Below are the PRs you can reference for the changes that were made to accommodate the new Stable lable and criteria that have replaced the previously named GA as of Dapr release v1.5

Files needing update:

daprdocs/content/en/operations/components/certification-lifecycle.md
daprdocs/content/en/operations/support/support-versioning.md
daprdocs/content/en/reference/*

PRs for reference:

• dapr/docs#1880
• dapr/docs#1904

https://crowdin.com/translate/cndocsdapr/15846/en-zhcn?filter=basic&value=0

https://crowdin.com/translate/cndocsdapr/15832/en-zhcn?filter=basic&value=0

1. 虽然 crowdin 可以展示当前的翻译度
2. 但是，我们代码段不翻译
3. 所以，译者不知道哪些文档确实翻译完了

因此，需要一个检查清单，这个清单需要能够表示

1. 所有的文件
2. 文件当前在 crowdin 的翻译完成度
3. 是否有译者进行的手动确认（当译者手动确认完毕之后，管理员便即可进行代码 hide 操作，以达到 100%

可以考虑使用 github issue 中的 todo list 来表示这份内容

https://docs.dapr.io/zh-hans/getting-started/install-dapr-selfhost/

https://docs.dapr.io/zh-hans/getting-started/get-started-api/

https://crowdin.com/translate/cndocsdapr/15842/en-zhcn?filter=basic&value=0