テーマ | Hexo

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フォルダにコピーされます。

公開

テーマの作成が完了したら、テーマリストに公開できます。公開する前に、テーマ単体テストを実行して、すべてが正常に機能することを確認する必要があります。テーマを公開する手順は、ドキュメントの更新の手順と非常によく似ています。

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

source/_data/themes/<あなたのテーマ名>.ymlを編集し、あなたのテーマを追加します。例：

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

スクリーンショット（テーマと同じ名前）をsource/themes/screenshotsに追加します。800*500pxのPNGファイルである必要があります。
ブランチをプッシュします。
プルリクエストを作成し、変更を記述します。