最近サーバーの期限が切れそうだから、VRC BlogをGitHubに移行しようと思ってさ。それでいいテーマがないか探してたんだよね。最初は今使ってるTypechoのテーマがJekyllから移植されたものだったから、それを探してたんだけど、半年前に 検索したときには見つからなくて。最近またHexoにも興味が出てきたから、いろいろ探してたら、前にお気に入りだったArgonのHexo版があることを思い出して、この記事を書くことにしたよ。

環境

Node.js 10.13以上が必要。12.0以上がおすすめ。

Gitのインストールも必要だよ。

インストール

コマンドを実行：

1

npm install -g hexo-cli

インストールが成功したか確認：

1

hexo -h

新しいブログを作る

インストールしたいフォルダに移動して：

1

hexo init <folder_name>

フォルダに入る：

1

cd <folder_name>

依存関係をインストール：

1

npm i

作成が終わったら ./_config を編集して設定できるよ。

テーマのインストール

テーマサイト で好きなテーマを選ぼう。テーマによってインストール方法が違うから、詳しくは各テーマのドキュメントを参考にしてね。

ここではArgonテーマのインストール方法を紹介するよ。

テーマのクローン

まずは ./themes フォルダでテーマのリポジトリをクローンする。

1

git clone https://github.com/solstice23/hexo-theme-argon.git

クローンしたフォルダの名前を argon に変更してね。

ejsレンダラーをインストール：

1

npm install hexo-renderer-ejs

./_config.yml ファイルの theme を argon に変更しよう。

設定ファイル

./themes/argon/_config.yml を編集して設定を変えられるよ。

検索機能の設定

ルートディレクトリで実行：

1

npm install hexo-generator-search --save

それから ./_config.yml にオプションを追加する。

1
2
3
4

search:
  path: search.xml
  field: post
  content: true

執筆

新しい記事を作成：

1

hexo new [layout] <title>

[layout] はオプションで、内容はこんな感じ：

作成できたら記事を書いていこう。

プレビュー：

1

hexo s

localhost:4000 にアクセスして確認してみてね。

静的ファイルの生成

コマンドを実行：

1

hexo generate

このコマンドを実行すると差分があるものだけビルドされるんだけど、一度元のファイルを削除してからビルドし直すほうが確実だよ。

参考記事

https://hexo.io/docs/

https://github.com/solstice23/hexo-theme-argon