主題

建立 Hexo 主題很簡單，您只需要建立一個新的資料夾。要開始使用您的主題，請修改您網站的 _config.yml 中的 theme 設定。一個主題應該具有以下結構

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

_config.yml

主題設定檔。與網站的主要設定檔不同，修改此檔不需要重新啟動伺服器。

languages

語言資料夾。請參閱國際化 (i18n)以取得更多資訊。

layout

版面配置資料夾。這個資料夾包含主題的樣板檔案，這些檔案定義了您網站的外觀。Hexo 預設提供 Nunjucks 樣板引擎，但您可以輕鬆安裝額外的外掛來支援其他引擎，例如 EJS 或 Pug。Hexo 會根據樣板的檔案副檔名選擇樣板引擎（就像文章一樣）。例如

layout.ejs   - uses EJS
layout.njk   - uses Nunjucks

請參閱樣板以取得更多資訊。

scripts

腳本資料夾。Hexo 會在初始化期間自動載入此資料夾中的所有 JavaScript 檔案。如需更多資訊，請參閱外掛。

source

資源資料夾。將您的資源（例如 CSS 和 JavaScript 檔案）放在這裡。Hexo 會忽略隱藏檔案以及以 _（底線）為前綴的檔案或資料夾。

Hexo 會處理所有可渲染的檔案並將其儲存到 public 資料夾。不可渲染的檔案將直接複製到 public 資料夾。

發布

當您完成建立主題時，您可以將其發布到主題列表。在此之前，您應該執行主題單元測試以確保一切正常運作。發布主題的步驟與更新文件的步驟非常相似。

1. Fork hexojs/site

2. 將儲存庫複製到您的電腦並安裝相依性。

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

3. 在 source/_data/themes/ 中建立一個新的 yaml 檔案，使用您的主題名稱作為檔案名稱

4. 編輯 source/_data/themes/<您的主題名稱>.yml 並新增您的主題。例如

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

5. 將螢幕截圖（與主題名稱相同）新增到 source/themes/screenshots。它必須是 800*500px 的 PNG 檔案。

6. 推送分支。

7. 建立一個 Pull Request 並描述變更。