mirror of https://github.com/abpframework/abp.git
maliming
8 years ago
1 changed files with 58 additions and 31 deletions
@ -1,52 +1,79 @@ |
|||
## 贡献指南 |
|||
**草案**: 该文档已作为草稿创建. |
|||
请参见 https://help.github.com/en/articles/setting-guidelines-for-repository-contributors |
|||
|
|||
ABP是[开源](https://github.com/abpframework)和社区驱动项目. 本指南旨在帮助任何想要为项目做出贡献的人. |
|||
# 贡献于ASP.NET Boilerplate |
|||
|
|||
### 贡献代码 |
|||
ASP.NET Boilerplate是一个[开源](https://github.com/aspnetboilerplate/aspnetboilerplate)和社区驱动的项目. 本指南旨在帮助任何人想要为项目做出贡献. |
|||
|
|||
你可以将Pull request(拉取请求)发送到Github存储库. |
|||
## 代码贡献 |
|||
|
|||
- 从Github克隆[ABP存储库](https://github.com/abpframework/abp/). |
|||
- 进行必要的更改. |
|||
- 发送Pull request(拉取请求). |
|||
你始终可以将PR(Pull Request)发送到GitHub存储库. |
|||
|
|||
在进行任何更改之前,请在[Github问题](https://github.com/abpframework/abp/issues)上进行讨论. 通过这种方式, 其他开发人员将不会处理同一个问题, 你的PR将有更好的机会被接受. |
|||
- 从GitHub克隆[ASP.NET Boilerplate存储库](https://github.com/aspnetboilerplate/aspnetboilerplate/). |
|||
- 进行必要的更改. |
|||
- 发送PR(Pull Request). |
|||
|
|||
#### Bug修复 & 增强功能 |
|||
在进行任何更改之前，请在[GitHub Issue页面]（(ttps://github.com/aspnetboilerplate/aspnetboilerplate/issues)上进行讨论. 因此,其他开发人员不会处理相同的问题, 你的PR将有更好的机会被接受. |
|||
|
|||
你可能希望修复已知Bug或处理计划的增强功能. 请参阅Github上的[问题列表](https://github.com/abpframework/abp/issues). |
|||
### 修复BUG和增强功能 |
|||
|
|||
#### 功能请求 |
|||
你可能想要修复已知BUG或处理计划的增强功能. 请参阅GitHub上的[Issue列表](https://github.com/aspnetboilerplate/aspnetboilerplate/issues) |
|||
|
|||
如果你对框架或模块有功能的想法, 请在Github上[创建一个问题](https://github.com/abpframework/abp/issues/new)或参加现有的讨论. 如果它被社区所接受你就可以实现它. |
|||
### 功能请求 |
|||
|
|||
### 文件翻译 |
|||
如果你有一个关于框架或模块的功能想法,在GitHub上创建一个Issue(https://github.com/aspnetboilerplate/aspnetboilerplate/issues/new)或参加现有的讨论. 然后,如果它被社区所接受,你就可以实施它. |
|||
|
|||
你可能希望将完整的[文档](https://abp.io/documents/)(包括本文)翻译成你的母语. 请按照下列步骤操作: |
|||
## 文档贡献 |
|||
|
|||
* 从Github克隆[ABP存储库](https://github.com/abpframework/abp/). |
|||
* 要添加新语言,请在[docs](https://github.com/abpframework/abp/tree/master/docs)文件夹中创建一个新文件夹. 文件夹名称可以是" en","es","fr","tr"等(参见[所有文化代码](https://msdn.microsoft.com/en-us/library/hh441729.aspx)). |
|||
* 获取["en"文件夹](https://github.com/abpframework/abp/tree/master/docs/en)作为文件名和文件夹结构的参考. 如果要翻译相同的文档, 请保持相同的命名. |
|||
* 翻译任何文档后发送拉取请求(PR). 请翻译文件后及时发送PR. 不要等到完成所有文件的翻译. |
|||
你可能希望改进[文档](https://aspnetboilerplate.com/Pages/Documents). 如果是,请按照下列步骤操作: |
|||
|
|||
### 资源本地化 |
|||
* 从GitHub克隆[ABP存储库](https://github.com/aspnetboilerplate/aspnetboilerplate/). |
|||
* 文档位于 [/aspnetboilerplate/doc](https://github.com/aspnetboilerplate/aspnetboilerplate/tree/master/doc/WebSite)文件夹中. |
|||
* 修改文件并发送PR(Pull Request). |
|||
* 如果要添加新文档,还需要将其添加到导航文档中. 导航文档位于[doc/WebSite/Navigation.md](https://github.com/aspnetboilerplate/aspnetboilerplate/blob/master/doc/WebSite/Navigation.md). |
|||
|
|||
ABP框架具有灵活的[本地化系统](https://abp.io/documents/abp/latest/Localization). 你可以为自己的应用程序创建本地化用户界面. |
|||
## 资源本地化 |
|||
|
|||
除此之外,框架和预构建模块已经本地化了文本.请参阅[Volo.Abp.UI包的本地化文本](https://github.com/abpframework/abp/blob/master/framework/src/Volo.Abp.UI/Localization/Resources/AbpUi/en.json).你可以在[相同文件夹](https://github.com/abpframework/abp/tree/master/framework/src/Volo.Abp.UI/Localization/Resources/AbpUi)中创建一个新文件进行翻译. |
|||
ASP.NET Boilerplate框架有一个[本地化系统](https://aspnetboilerplate.com/Pages/Documents/Localization). 本地化资源位于[Abp\Localization\Sources\AbpXmlSource](https://github.com/aspnetboilerplate/aspnetboilerplate/tree/dev/src/Abp/Localization/Sources/AbpXmlSource). |
|||
你可以添加新翻译或更新现有翻译. |
|||
要添加缺少的翻译,请参阅[此示例请求](https://github.com/aspnetboilerplate/aspnetboilerplate/pull/2471) |
|||
|
|||
* 从Github克隆[ABP存储库](https://github.com/abpframework/abp/). |
|||
* 为本地化文本(json)文件(en.json文件同目录下)创建目标语言的新文件. |
|||
* 复制en.json文件中的所有文本. |
|||
* 翻译文本. |
|||
* 在Github上发送拉取请求(Pull request). |
|||
## 编写新模块 |
|||
|
|||
ABP是一个模块化框架. 所以有很多本地化文本资源, 每个模块都有一个. 要查找所有.json文件,可以在克隆存储库后搜索"en.json". 你还可以检查[此列表](Localization-Text-Files.md)以获取本地化文本文件列表. |
|||
该框架具有预构建模块, 你还可以添加新模块. [Abp.Dapper](https://github.com/aspnetboilerplate/aspnetboilerplate/tree/dev/src/Abp.Dapper)是一个贡献模块. 你可以检查Abp.Dapper模块来制作你自己的模块. |
|||
|
|||
### 博客文章和教程 |
|||
TODO：可以逐步添加模块开发指南. |
|||
|
|||
如果你发布了一些ABP框架的教程或博客帖子, 请通知我们(通过创建[Github问题](https://github.com/abpframework/abp/issues)), 我们可能会在官方文档中添加指向你的教程或博客帖子的链接和在[推特](https://twitter.com/abpframework)上公布. |
|||
## 博客文章和教程 |
|||
|
|||
### Bug 报告 |
|||
如果你想为ASP.NET Boilerplate编写教程或博客文章,请告诉我们(通过创建GitHub Issue)(https://github.com/aspnetboilerplate/aspnetboilerplate/issues), 以便我们添加链接到你的教程/帖子在官方文档中,我们在官方[Twitter帐户](https://twitter.com/aspboilerplate). |
|||
|
|||
如果你发现任何Bug, 请[在Github存储库上创建一个问题](https://github.com/abpframework/abp/issues/new). |
|||
## 报告BUG |
|||
|
|||
如果您想报告BUG, 请[在GitHub存储库上创建一个Issue](https://github.com/aspnetboilerplate/aspnetboilerplate/issues/new) |
|||
|
|||
你需要在发布BUG之前填写问题模板. |
|||
|
|||
```markdown |
|||
### GitHub Issues |
|||
|
|||
GitHub issues are for bug reports, feature requests and other discussions about the framework. |
|||
|
|||
If you're creating a bug/problem report, please include followings: |
|||
|
|||
* Your Abp package version. |
|||
* Your base framework: .Net Framework or .Net Core. |
|||
* Exception message and stack trace if available. |
|||
* Steps needed to reproduce the problem. |
|||
|
|||
Please write in English. |
|||
|
|||
### Stack Overflow |
|||
|
|||
Please use Stack Overflow for your questions about using the framework, templates and samples: |
|||
|
|||
https://stackoverflow.com/questions/tagged/aspnetboilerplate |
|||
|
|||
Use aspnetboilerplate tag in your questions. |
|||
|
|||
``` |
|||
|
|||
Loading…
Reference in new issue