Hexo 主題

主題

創(chuàng)建 Hexo 主題非常容易，您只要在 themes 文件夾內(nèi)，新增一個(gè)任意名稱的文件夾，并修改 _config.yml 內(nèi)的 theme 設(shè)定，即可切換主題。一個(gè)主題可能會(huì)有以下的結(jié)構(gòu)：

    .
    ├── _config.yml
    ├── languages
    ├── layout
    ├── scripts
    └── source  

_config.yml

主題的配置文件。和 Hexo 配置文件不同，主題配置文件修改時(shí)會(huì)自動(dòng)更新，無需重啟 Hexo Server。

languages

語言文件夾。請(qǐng)參見 本地化 (i18n)

layout

布局文件夾。用于存放主題的模板文件，決定了網(wǎng)站內(nèi)容的呈現(xiàn)方式，Hexo 內(nèi)建 Swig 模板引擎，您可以另外安裝插件來獲得 EJS、Haml 或 Jade 支持，Hexo 根據(jù)模板文件的擴(kuò)展名來決定所使用的模板引擎，例如：

    EJS: layout.ejs
    Swig: layout.swig  

您可參考 模板 以獲得更多信息。

scripts

腳本文件夾。在啟動(dòng)時(shí)，Hexo 會(huì)載入此文件夾內(nèi)的 JavaScript 文件，請(qǐng)參見 插件 以獲得更多信息。

source

資源文件夾，除了模板以外的 Asset，例如 CSS、JavaScript 文件等，都應(yīng)該放在這個(gè)文件夾中。文件或文件夾開頭名稱為 _（下劃線線）或隱藏的文件會(huì)被忽略。

如果文件可以被渲染的話，會(huì)經(jīng)過解析然后儲(chǔ)存到 public 文件夾，否則會(huì)直接拷貝到 public 文件夾。

發(fā)布

當(dāng)您完成主題后，可以考慮將它發(fā)布到 主題列表，讓更多人能夠使用您的主題。在發(fā)布前建議先進(jìn)行 主題單元測(cè)試，確保每一項(xiàng)功能都能正常使用。發(fā)布主題的步驟和更新文件 非常類似。

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

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

1. 編輯 source/_data/themes.yml，在文件中新增您的主題，例如：

        - name: landscape  
      description: A brand new default theme for Hexo.  
      link: https://github.com/hexojs/hexo-theme-landscape  
      preview: http://hexo.io/hexo-theme-landscape  
      tags:  
        - official  
        - responsive  
        - widget  
        - two_column  
        - one_column  

1. 在 source/themes/screenshots 新增同名的截圖檔案，圖片必須為 800x500 的 PNG 文件。

2. 推送（push）分支。
3. 建立一個(gè)新的合并申請(qǐng)（pull request）。