開發(fā)

我們非常歡迎您加入 Hexo 的開發(fā)，這份文件將幫助您了解開發(fā)流程。

開始之前

請遵守以下準(zhǔn)則：

遵守 Google JavaScript 代碼風(fēng)格 使用 2 個(gè)空格縮排。 不要把逗號放在最前面。

工作流程

1. Fork hexojs/hexo
2. 把庫（repository）復(fù)制到電腦上，并安裝所依賴的插件。

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

1. 新增一個(gè)功能分支。

        $ git checkout -b new_feature  

1. 開始開發(fā)。

2. 推送（push）分支。

        $ git push origin new_feature  

1. 對 master 分支建立一個(gè)新的合并申請（pull request）并描述變動(dòng)。

注意事項(xiàng)

• 不要修改 package.json 的版本號。
• 只有在測試通過的情況下您的合并申請才會(huì)被批準(zhǔn)，在提交前別忘了進(jìn)行測試。

$ npm test

更新文件

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

1. Fork hexojs/site
2. 把庫（repository）復(fù)制到電腦上，并安裝所依賴的插件。

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

1. 開始編輯文件，您可以通過服務(wù)器預(yù)覽變動(dòng)。

$ hexo server

1. 推送（push）分支。

2. 對 master 分支建立一個(gè)新的合并申請（pull request）并描述變動(dòng)。

翻譯文件

翻譯文件的流程與上述的文件更新非常相似，如果要新增語言的話，請遵照以下步驟：

1. 在 source 資料夾中建立一個(gè)新的語言資料夾（全小寫）。
2. 把 source 資料夾中相關(guān)的文件（Markdown 和模板文件）復(fù)制到新的語言資料夾中。
3. 在 source/_data/language.yml 中新增語言。
4. 在 themes/navy/languages 復(fù)制 en.yml 并命名為語言名稱（全小寫）。

反饋問題

當(dāng)您在使用 Hexo 時(shí)遇到問題，您可以嘗試在 問題解答 中尋找解答，或是在 GitHub 或 Google Group 上提問。提問時(shí)請務(wù)必附上以下信息：

1. 以 調(diào)試模式 再執(zhí)行一次。

2. 檢查版本信息。

3. 把調(diào)試信息和版本信息都貼到 GitHub。