Skip to content

Add Chinese language #135

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

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .gitmodules
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
[submodule "axelor-open-suite"]
path = modules/axelor-open-suite
url = [email protected]:axelor/axelor-open-suite.git
url = [email protected]:macrogoal/axelor-open-suite.git
74 changes: 74 additions & 0 deletions CONTRIBUTING_zh.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
# 贡献指南

我们非常欢迎您为我们的源代码做出贡献,使应用程序更加完善。虽然我们尽量减少对贡献的要求,但仍有一些指南希望您遵守:

* [贡献者许可协议](#contributor-license-agreement)
* [报告问题](#reporting-issues)
* [提交贡献](#submitting)
* [行为准则](#code-of-conduct)

## 贡献者许可协议

如果您以个人身份提交代码,则同意[个人贡献者许可协议][individual-cla].
B如果您以实体身份提交代码,则同意[企业贡献者许可协议][corporate-cla].

## 报告问题

在提交问题之前,请先搜索存档,也许您的问题已经得到了解答。
如果您的问题看起来像是一个 bug,并且尚未被报告,请提交一个新的问题。为了帮助我们最大限度地利用时间来修复问题和添加新功能,请不要重复报告相同的问题。提供以下信息将有助于我们更快地处理您的问题:

* **使用场景** – 解释您的使用场景
* **问题概述** – 包括堆栈跟踪
* **版本** – 您正在使用哪个版本?
* **浏览器和操作系统** – 这是所有浏览器的问题吗?
* **重现错误** – 提供一个补丁来重现错误
* **相关问题** – 是否有类似的问题已被报告?
* **建议修复方案** – 您可以指出可能引起问题的代码行或提交

请确保在报告问题时不要发布任何敏感信息。

## 提交贡献

* [Fork仓库](https://help.github.com/articles/fork-a-repo/) the repo.
* 编码!
* 格式化 Java 代码以遵循 Google 代码格式。工具:
* Gradle 任务:`./gradlew spotlessApply`
* IDE 插件
* [Eclipse](https://github.com/google/google-java-format#eclipse)
* [IntelliJ](https://github.com/google/google-java-format#intellij)
* 您必须创建一个变更日志条目来描述更改。
请参阅 [请参阅changelogs文件夹中的README](https://github.com/axelor/axelor-open-suite/blob/master/changelogs/README.md)
,并按照说明操作。
* 将更改推送到您 fork 的仓库中的主题分支。

* 在开发分支上发起一个 [pull request](http://help.github.com/send-pull-requests/) .
例如,如果问题出现在`master`分支,则选择`dev` 分支;如果问题出现在`5.3`分支,则选择 `5.3-dev`, 依此类推。

## 行为准则

作为本项目的贡献者和维护者,为了营造一个开放、和谐的社区,我们承诺尊重所有通过报告问题、发布功能请求、更新文档、提交 pull request 或补丁以及其他活动为项目做出贡献的人。
我们致力于确保每个人都能在一个没有骚扰的环境中参与本项目,无论其经验水平、性别、性别认同和表达、性取向、残疾、外貌、体型、种族、民族、年龄、宗教或国籍如何。

参与者不可接受的行为示例包括:

* 使用带有性暗示的语言或图像
* 人身攻击
* 骚扰或侮辱/贬低性评论
* 公开或私下骚扰
* 发布他人的私人信息(如物理地址或电子地址),除非得到明确许可
* 其他不道德或不专业的行为

项目维护者有权和责任移除、编辑或拒绝不符合本行为准则的评论、提交、代码、wiki 编辑、问题和其他贡献,或者暂时或永久禁止其他被认为不合适、威胁、冒犯或有害的行为。
通过采用此行为准则,项目维护者承诺公平和一致地将这些原则应用于管理项目的各个方面。未遵守或执行行为准则的项目维护者可能会被永久从项目团队中移除。
此行为准则适用于项目空间内以及当个人代表项目或其社区在公共空间中的行为。
如果您遇到滥用、骚扰或其他不可接受的行为,可以通过[[email protected]][mail]. 联系项目维护者。所有投诉都将被审查和调查,并根据情况作出必要的和适当的回应。维护者有义务对事件举报人保持保密。

此行为准则是基于[ 贡献者公约][homepage],
版本 1.3.0,可访问
[http://contributor-covenant.org/version/1/3/0/][version]获取。

[mail]: mailto:[email protected]
[homepage]: http://contributor-covenant.org
[version]: http://contributor-covenant.org/version/1/3/0/
[individual-cla]: http://axelor.com/cla/individuel-cla/
[corporate-cla]: http://axelor.com/cla/corporate-cla/
34 changes: 34 additions & 0 deletions README_zh.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
Axelor开源套件
================================

Axelor开源套件减少了业务流程的复杂性并提高了响应速度。由于其模块化设计,您可以从少量功能开始,然后根据需要激活其他模块。
Axelor开源套件包含以下模块:

* 客户关系管理(CRM)
* 销售管理
* 财务和成本管理(F&CM)
* 人力资源管理(HR)
* 项目管理(PM)
* 库存和供应链管理(SCM)
* 生产管理(PMC)
* 多公司、多货币和多语言支持

Axelor开源套件是基于[Axelor开源平台](https://github.com/axelor/axelor-open-platform)

安装
================================

要从源代码编译和运行,您需要克隆 Axelor Open Suite 模块,这是一个
[git子模块](https://git-scm.com/book/en/v2/Git-Tools-Submodules)仓库,使用以下命令:

```bash
$ git clone [email protected]:axelor/open-suite-webapp.git
$ cd open-suite-webapp
$ git checkout master
$ git submodule init
$ git submodule update
$ git submodule foreach git checkout master
$ git submodule foreach git pull origin master
```

您可以在我们的文档中找到更详细的[安装说明](https://docs.axelor.com/abs/5.0/install/index.html)。
83 changes: 83 additions & 0 deletions changelogs/README_zh.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
## 变更内容

#### 概述

`unreleased` 文件夹包含所有尚未发布的变更内容。

在发布时,所有未发布的变更内容将合并到最终的 CHANGELOG.md 文件中。

#### 变更内容条目格式

在 `changelogs/unreleased` 下创建一个新文件。

该文件应为 YAML 格式,如下所示:

````yaml
---
title: 一些文本
type: feature
description: |
这里是一些描述 包含更多详细信息。

以及关于破坏性变更 和迁移步骤的说明。

```
$ find -iregex ".*domains.*.xml" | xargs -l sed -i 's|cachable="|cacheable="|g'
```
````

`title` 描述条目。

`type` 可以是:
* **feature** 表示新功能。
* **change** 表示现有功能的更改。
* **deprecate** 表示即将移除的功能。
* **remove** 表示已移除的功能。
* **fix** 表示任何 bug 修复。
* **security** 表示安全漏洞修复。

`description` 是可选的,应该提供关于更改的详细描述,包括迁移步骤(如果有)。

#### 如何判断是否需要新的变更内容条目

**除了少数特殊情况外,您无需为在 wip 分支中修复的问题添加变更内容条目。**

变更内容需要列出从上一版本到当前版本的更改。当版本处于开发阶段时,新功能可能会引入回归问题。如果我们在版本发布前修复了这些回归问题,那么这些 bug 将不会出现在任何已发布的版本中,因此修复记录不需要出现在变更内容中。但如果我们在修复已发布的版本中的 bug,则必须添加变更内容条目。

### 如何选择条目的类型

- **如果您在 dev 分支上,大多数情况下类型是 `fix` 或 `change`。**
- **如果您在 wip 分支上,类型可以是 `change` 或 `feature`(参见上文)。**

`change` 属于当前的“改进”部分:在现有类中添加一个简单字段不是新功能,而是更改。

dev分支上的新功能和wip分支上的修复等特殊情况下可能存在,但应仅在少数情况下发生。

### 变更内容关注应用程序的使用

**不要使用技术字段名称。** 您必须写明更改对应用程序用户的影响。
任何关于更改的技术信息可以在需要时写入提交消息,但在变更内容中应尽量避免。

例如,不要写:

> 当 statusSelect 等于 `STATUS_CANCELED` 时,将 typeSelect 的 hidden 属性更新为 true。

而应写:

> 在发票表单视图中,隐藏取消的发票类型。

#### 生成 CHANGELOG.md

要使用未发布的条目生成 `CHANGELOG.md`,请运行以下Gradle任务:
```
./gradlew generateChangeLog
```

未发布的条目也将自动从 `changelogs/unreleased` 中删除。

可以使用 `--preview` 参数预览生成的变更内容,而不删除或更新文件。

#### 参考资料

* [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
* [Gitlab: 如何解决CHANGELOG冲突](https://about.gitlab.com/2018/07/03/solving-gitlabs-changelog-conflict-crisis/)
5 changes: 5 additions & 0 deletions changelogs/unreleased/add-chinese-language.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
title: Add Chinese language
type: feature
description: |
Add Chinese language to README.md, *.csv, and other files.
6 changes: 6 additions & 0 deletions src/main/resources/i18n/messages_zh.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
"key","message","comment","context"
"Log in","登录",,
"Password","密码",,
"Please sign in","请登录",,
"Remember me","记住我",,
"User name","用户名",,