テーマ | Hexo

Hexoのテーマを作るのは簡単です。新しいフォルダを作成するだけです。テーマを使用するには、サイトの_config.ymlのtheme設定を変更してください。テーマには以下の構造が必要です:

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

_config.yml

テーマ設定ファイル。サイトの全体の設定ファイルと異なり、変更してもサーバーの再起動は必要ありません。

languages

言語フォルダ。詳細については、国際化 (i18n)を参照してください。

layout

レイアウトフォルダ。このフォルダには、ウェブサイトの外観を定義するテーマのテンプレートファイルが含まれます。HexoはデフォルトでNunjucksテンプレートエンジンを提供しますが、EJSやPugなどの他のエンジンをサポートするプラグインも簡単にインストールできます。Hexoは（記事と同様に）テンプレートのファイル拡張子に基づいてテンプレートエンジンを選択します。例:

layout.ejs   - EJSを使用
layout.njk   - Nunjucksを使用

詳細は、テンプレートを参照してください。

scripts

スクリプトフォルダ。Hexoは初期化中にこのフォルダ内のすべてのJavaScriptファイルを自動的に読み込みます。詳細は、プラグインを参照してください。

source

ソースフォルダ。アセット（例: CSSやJavaScriptファイル）を配置します。Hexoは隠しファイルや_（アンダースコア）で始まるファイルやフォルダを無視します。

Hexoは、すべてのレンダリング可能なファイルを処理しpublicフォルダに保存します。レンダリング不可能なファイルは直接publicフォルダにコピーされます。

公開

テーマを構築したらテーマリストに公開できます。その前に、テーマユニットテストを実行して、すべてが正常に機能することを確認する必要があります。テーマを公開する手順は、ドキュメントの更新と非常に似ています。

hexojs/siteをフォークします。
リポジトリをコンピュータにクローンし、依存関係をインストールします。
$ git clone https://github.com/<username>/site.git
$ cd site
$ npm install
テーマ名と同じファイル名でsource/_data/themes/に新しいyamlファイルを作成します。

source/_data/themes/<your-theme-name>.ymlを編集し、テーマを追加します。例:

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

スクリーンショット（テーマと同じ名前）をsource/themes/screenshotsに追加します。800*500pxのPNGでなければなりません。
ブランチをプッシュします。
プルリクエストを作成し、変更を説明します。