贡献

开发

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

开始之前

请遵守以下准则：

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

工作流程

1. Fork hexojs/hexo
2. 把库（repository）复制到电脑上，并安装所依赖的插件。

        $ git clone https://github.com//hexo.git  
    $ cd hexo  
    $ npm install  
    $ git submodule update --init  

1. 新增一个功能分支。

        $ git checkout -b new_feature  

1. 开始开发。

2. 推送（push）分支。

        $ git push origin new_feature  

1. 对 master 分支建立一个新的合并申请（pull request）并描述变动。

注意事项

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

$ npm test

更新文件

Hexo 文件开放源代码，您可以在 hexojs/site 找到源代码，若要修改文件：

1. Fork hexojs/site
2. 把库（repository）复制到电脑上，并安装所依赖的插件。

        $ git clone https://github.com//site.git  
    $ cd site  
    $ npm install  

1. 开始编辑文件，您可以通过服务器预览变动。

$ hexo server

1. 推送（push）分支。

2. 对 master 分支建立一个新的合并申请（pull request）并描述变动。

翻译文件

翻译文件的流程与上述的文件更新非常相似，如果要新增语言的话，请遵照以下步骤：

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

反馈问题

当您在使用 Hexo 时遇到问题，您可以尝试在 问题解答 中寻找解答，或是在 GitHub 或 Google Group 上提问。提问时请务必附上以下信息：

1. 以 调试模式 再执行一次。

2. 检查版本信息。

3. 把调试信息和版本信息都贴到 GitHub。