主题

创建 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/<your-theme-name>.yml并添加您的主题。例如

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

5. 将截图（与主题同名）添加到source/themes/screenshots中。它必须是 800*500px 的 PNG。

6. 推送分支。

7. 创建一个拉取请求并描述更改。