Powered by GitBook

贡献

开发

我们非常欢迎您加入 Hexo 的开发，这份文件将帮助您了解开发流程。

开始之前

请遵守以下准则：

遵守 Google JavaScript 代码风格。
使用 2 个空格缩排。
不要把逗号放在最前面。

工作流程

Fork hexojs/hexo

把库（repository）复制到电脑上，并安装所依赖的插件。

$ git clone https://github.com/&lt;username&gt;/hexo.git
$ cd hexo
$ npm install
$ git submodule update --init

新增一个功能分支。
```
$ git checkout -b new_feature
```
开始开发。
推送（push）分支。
```
$ git push origin new_feature
```
建立一个新的合并申请（pull request）并描述变动。

注意事项

不要修改 package.json 的版本号。
只有在测试通过的情况下您的合并申请才会被批准，在提交前别忘了进行测试。
```
$ npm test
```

更新文档

Hexo 文档开放源代码，您可以在 hexojs/site 找到源代码。

工作流程

Fork hexojs/site

把库（repository）复制到电脑上，并安装所依赖的插件。

$ git clone https://github.com/&lt;username&gt;/site.git
$ cd site
$ npm install

开始编辑文件，您可以通过服务器预览变动。
```
$ hexo server
```
推送（push）分支。
建立一个新的合并申请（pull request）并描述变动。

翻译

在 source 资料夹中建立一个新的语言资料夹（全小写）。
把 source 资料夹中相关的文件（Markdown 和模板文件）复制到新的语言资料夹中。
在 source/_data/language.yml 中新增语言。
将 en.yml 复制到 themes/navy/languages中并命名为语言名称（全小写）。

反馈问题

当您在使用 Hexo 时遇到问题，您可以尝试在问题解答中寻找解答，或是在 GitHub 或 Google Group 上提问。如果你没有找答案，请在 Github 报告它。

在调试模式中重现问题。
运行 hexo version 并检查版本信息。
把调试信息和版本信息都贴到 GitHub。