Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feature/translate #288

Merged
merged 9 commits into from
Feb 1, 2025
Merged
Show file tree
Hide file tree
Changes from 7 commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
36 changes: 10 additions & 26 deletions .github/crowdin-download.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ name: Download translation from Crowdin

on:
schedule:
- cron: "0 0 * * *"
- cron: "10 1 * * *"
workflow_dispatch:
push:
branches:
Expand All @@ -12,46 +12,34 @@ on:
jobs:
synchronize-with-crowdin:
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
version_tag:
- v1.5
- v1.4
- v1.3
- v1.2
- v1.1
- v1.0

steps:
- name: Checkout
uses: actions/checkout@v2
with:
ref: ${{ matrix.version_tag }}/translate_site
- name: sleep
- name: remove old files
run: |
# sleep some time according to the version tag. e.g. v1.5 will sleep for 5*30 seconds
sleep $(($(echo ${{ matrix.version_tag }} | sed -e 's/v//' -e 's/\.//g')*30))
cd src
rm -rf translated_content
mkdir -p translated_content/zh_CN
cp -r content/* translated_content/zh_CN
- name: crowdin action
uses: crowdin/github-action@v1.19.0
with:
upload_sources: false
upload_translations: false
download_translations: true
dryrun_action: false
crowdin_branch_name: ${{ matrix.version_tag }}_translate_site

# This is the name of the git branch that Crowdin will create when opening a pull request.
# This branch does NOT need to be manually created. It will be created automatically by the action.
localization_branch_name: l10n_crowdin_action_${{ matrix.version_tag }}
localization_branch_name: l10n_crowdin_action
create_pull_request: false
push_translations: false
pull_request_title: "New Crowdin translations"
pull_request_body: "New Crowdin pull request with translations"
pull_request_labels: "translation update, automated pr"
# This is the name of the git branch to with pull request will be created.
# If not specified default repository branch will be used.
pull_request_base_branch_name: ${{ matrix.version_tag }}/translate_site
pull_request_base_branch_name: main
env:
GITHUB_TOKEN: ${{ secrets.REPO_SCOPED_TOKEN }}
CROWDIN_PROJECT_ID: ${{ secrets.CROWDIN_PROJECT_ID }}
Expand All @@ -70,16 +58,12 @@ jobs:
commit-message: "New Crowdin translations"
signoff: false
delete-branch: true
branch: l10n_crowdin_action_${{ matrix.version_tag }}
base: ${{ matrix.version_tag }}/translate_site
branch: l10n_crowdin_action
base: main
title: "New Crowdin translations"
labels: |
automated pr
${{ matrix.version_tag }}
assignees: |
newbe36524
reviewers: |
newbe36524
team-reviewers: |
owners
maintainers
16 changes: 1 addition & 15 deletions .github/crowdin-update-source.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ name: Update source to crowdin

on:
schedule:
- cron: "0 0 * * *"
- cron: "10 0 * * *"
workflow_dispatch:
push:
branches:
Expand All @@ -11,22 +11,9 @@ on:
jobs:
synchronize-with-crowdin:
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
version_tag:
- v1.5
- v1.4
- v1.3
- v1.2
- v1.1
- v1.0

steps:
- name: Checkout
uses: actions/checkout@v2
with:
ref: ${{ matrix.version_tag }}/translate_site
- name: crowdin action
uses: crowdin/github-action@v1.19.0
with:
Expand All @@ -35,7 +22,6 @@ jobs:
upload_translations: false
download_translations: false
dryrun_action: false
crowdin_branch_name: ${{ matrix.version_tag }}_translate_site

env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
Expand Down
69 changes: 0 additions & 69 deletions .github/workflows/crowdin-download.yml

This file was deleted.

29 changes: 0 additions & 29 deletions .github/workflows/crowdin-update-source.yml

This file was deleted.

82 changes: 82 additions & 0 deletions src/translated_content/zh_CN/contributing/dotnet-contributing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
---
type: docs
title: "为 .NET SDK 贡献"
linkTitle: ".NET SDK"
weight: 3000
description: 为 Dapr .NET SDK 贡献的指南
---

# 欢迎!
如果你正在阅读这篇文章,说明你可能对为 Dapr 和/或 Dapr .NET SDK 做出贡献感兴趣。欢迎加入这个项目,感谢你对贡献的兴趣!

请查看文档,了解 Dapr 的定义及其目标,并通过 [Discord](https://bit.ly/dapr-discord) 联系我们。告诉我们你想如何贡献,我们很乐意提供想法和建议。

有很多方式可以为 Dapr 做出贡献:
- 为 [Dapr 运行时](https://github.com/dapr/dapr/issues/new/choose) 或 [Dapr .NET SDK](https://github.com/dapr/dotnet-sdk/issues/new/choose) 提交错误报告
- 提出新的 [运行时功能](https://github.com/dapr/proposals/issues/new/choose) 或 [SDK 功能](https://github.com/dapr/dotnet-sdk/issues/new/choose)
- 改进 [Dapr 大项目](https://github.com/dapr/docs) 或 [Dapr .NET SDK 专门](https://github.com/dapr/dotnet-sdk/tree/master/daprdocs) 的文档
- 添加新的或改进现有的 [组件](https://github.com/dapr/components-contrib/),以实现各种构建块
- 增强 [.NET 可插拔组件 SDK 功能](https://github.com/dapr-sandbox/components-dotnet-sdk)
- 改进 Dapr .NET SDK 代码库和/或修复错误(详见下文)

如果你是代码库的新手,请在 Discord 的 #dotnet-sdk 频道中询问如何进行更改或提出一般性问题。你不需要获得许可即可进行任何工作,但请注意,如果某个问题已分配给某人,这表明可能已经有人开始处理它了。特别是如果自上次活动以来已经有一段时间,请随时联系他们,看看他们是否仍然有兴趣继续,或者你是否可以接手,并提交你的实现的 pull request。

如果你想将自己分配给一个问题,请在对话中回复 "/assign",机器人会将你分配给它。

我们将一些问题标记为 `good-first-issue` 或 `help wanted`,表明这些问题可能是小的、独立的更改。

如果你不确定你的实现,请将其创建为草稿 pull request,并通过标记 `@dapr/maintainers-dotnet-sdk` 向 [.NET 维护者](https://github.com/orgs/dapr/teams/maintainers-dotnet-sdk) 征求反馈,并提供一些关于你需要帮助的上下文。

# 贡献规则和最佳实践

在为 [.NET SDK](https://github.com/dapr/dotnet-sdk) 贡献时,应遵循以下规则和最佳实践。

## Pull Requests
仅包含格式更改的 pull request 通常不被鼓励。pull request 应该寻求修复错误、添加新功能或改进现有功能。

请尽量将你的 pull request 限制在单个问题上。涉及许多文件的广泛 PR 不太可能在短时间内被审查或接受。在单个 PR 中处理许多不同的问题使得很难确定你的代码是否完全解决了潜在问题,并使代码审查复杂化。

## 测试
所有 pull request 应包括单元和/或集成测试,以反映所添加或更改的内容,以便明确功能按预期工作。避免使用自动生成的测试,这些测试会多次重复测试相同的功能。相反,寻求通过验证更改的每个可能路径来提高代码覆盖率,以便未来的贡献者可以更轻松地导航你的逻辑轮廓,并更容易识别限制。

## 示例

`examples` 目录包含用户可以运行的代码示例,以尝试各种 Dapr .NET SDK 包和扩展的特定功能。在编写新的和更新的示例时,请记住:

- 所有示例应可在 Windows、Linux 和 MacOS 上运行。虽然 .NET Core 代码在操作系统之间是一致的,但任何前/后示例命令应通过 [codetabs]({{< ref "contributing-docs.md#tabbed-content" >}}) 提供选项
- 包含下载/安装任何所需先决条件的步骤。一个全新操作系统安装的用户应该能够开始示例并完成它而不会出错。链接到外部下载页面是可以的。

## 文档

`daprdocs` 目录包含渲染到 [Dapr Docs](https://docs.dapr.io) 网站的 markdown 文件。当文档网站构建时,此仓库被克隆并配置,以便其内容与文档内容一起渲染。在编写文档时,请记住:

- 除了这些规则外,还应遵循 [文档指南]({{< ref contributing-docs.md >}}) 中的所有规则。
- 所有文件和目录应以 `dotnet-` 为前缀,以确保所有文件/目录名称在所有 Dapr 文档中都是全局唯一的。

所有 pull request 应努力包括代码中的 XML 文档,清楚地指明功能的作用和原因,以及对已发布文档的更改,以便为其他开发人员澄清你的更改如何改进 Dapr 框架。

## GitHub Dapr Bot 命令

查看 [daprbot 文档](https://docs.dapr.io/contributing/daprbot/) 以获取你可以在此仓库中运行的常见任务的 Github 命令。例如,你可以在问题上评论 `/assign` 来将其分配给自己。

## 提交签署
提交到 Dapr .NET SDK 的所有代码必须由编写它的开发人员签署。这意味着每个提交必须以以下内容结尾:
> Signed-off-by: First Last <flast@example.com>

姓名和电子邮件地址必须与提交更改的用户的注册 GitHub 姓名和电子邮件地址匹配。我们使用一个机器人在 pull request 中检测这一点,如果此检查未能验证,我们将无法合并 PR。

如果你注意到 PR 因 DCO 检查失败而未能验证,请考虑在本地压缩 PR 并重新提交,以确保签署声明包含在提交历史中。

# 语言、工具和流程
Dapr .NET SDK 中的所有源代码都是用 C# 编写的,并针对最新的语言版本可用于最早支持的 .NET SDK。截至 v1.15,这意味着因为 .NET 6 仍然受支持,最新的语言版本是 [C# 版本 10](https://learn.microsoft.com/en-us/dotnet/csharp/whats-new/csharp-version-history#c-version-10)。

截至 v1.15,支持以下 .NET 版本:

| 版本 | 备注 |
| --- |-----------------------------------------------------------------|
| .NET 6 | 将在 v1.16 中停止支持 |
| .NET 7 | 仅在 Dapr.Workflows 中支持,将在 v1.16 中停止支持 |
| .NET 8 | 将在 v1.16 中继续支持 |
| .NET 9 | 将在 v1.16 中继续支持 |

欢迎贡献者使用他们最熟悉的 IDE 进行开发,但请不要提交 IDE 特定的偏好文件,因为这些文件将被拒绝。
23 changes: 23 additions & 0 deletions src/translated_content/zh_CN/contributing/go-contributing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
type: docs
title: "为 Go SDK 贡献"
linkTitle: "Go SDK"
weight: 3000
description: 为 Dapr Go SDK 贡献的指南
---

在为 [Go SDK](https://github.com/dapr/go-sdk) 贡献时,贡献者应该遵循以下规则和最佳实践。

## 示例

`examples` 目录包含用户可以运行的代码示例,以尝试各种 Go SDK 包和扩展的特定功能。在编写新的和更新的示例时,请注意:

- 所有示例应能在 Windows、Linux 和 MacOS 上运行。虽然 Go 代码在不同操作系统之间是一致的,但任何示例的前置/后置命令应通过 [codetabs]({{< ref "contributing-docs.md#tabbed-content" >}}) 提供不同的选项。
- 包含下载和安装任何必要前提条件的步骤。即使是刚安装操作系统的用户,也应该能够顺利开始并完成示例而不出现错误。可以链接到外部下载页面。

## 文档

`daprdocs` 目录包含被渲染到 [Dapr Docs](https://docs.dapr.io) 网站的 markdown 文件。当文档网站构建时,此仓库会被克隆并配置,以便其内容与文档内容一起呈现。在编写文档时,请注意:

- 除了这些规则外,还应遵循 [docs guide]({{< ref contributing-docs.md >}}) 中的所有规则。
- 所有文件和目录应以 `go-` 为前缀,以确保在所有 Dapr 文档中文件和目录名称的全局唯一性。
23 changes: 23 additions & 0 deletions src/translated_content/zh_CN/contributing/java-contributing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
type: docs
title: "为 Java SDK 贡献"
linkTitle: "Java SDK"
weight: 3000
description: 为 Dapr Java SDK 贡献的指南
---

贡献 [Java SDK](https://github.com/dapr/java-sdk) 时,应该遵循以下规则和最佳实践。

## 示例

`examples` 目录中包含用户可以运行的代码示例,用于尝试各种 Java SDK 包和扩展的特定功能。在编写或更新示例时,请注意:

- 所有示例应能在 Windows、Linux 和 MacOS 上运行。虽然 Java 代码在不同操作系统上是一致的,但任何示例的前置或后续命令应通过 [codetabs]({{< ref "contributing-docs.md#tabbed-content" >}}) 提供不同的选项。
- 包含下载和安装所有必要前提条件的步骤。即使是全新安装操作系统的用户,也应该能够顺利开始并完成示例。可以链接到外部下载页面。

## 文档

`daprdocs` 目录中包含的 markdown 文件会被渲染到 [Dapr Docs](https://docs.dapr.io) 网站上。当文档网站构建时,此仓库会被克隆并配置,以便其内容与文档内容一起渲染。在编写文档时,请注意:

- 除了这些规则外,还应遵循 [docs guide]({{< ref contributing-docs.md >}}) 中的所有规则。
- 所有文件和目录名称应以 `java-` 为前缀,以确保在所有 Dapr 文档中具有全局唯一性。
Loading