ドキュメント

Hexo のドキュメントへようこそ。Hexo の使用中に問題が発生した場合は、トラブルシューティングガイドを参照するか、GitHubで問題を報告するか、Google グループでトピックを開始してください。

Hexo とは？

Hexo は、高速でシンプルかつ強力なブログフレームワークです。Markdown（またはその他のマークアップ言語）で投稿を作成し、Hexo は数秒で美しいテーマを含む静的ファイルを生成します。

インストール

Hexo の設定は数分しかかかりません。問題が発生し、ここで解決策が見つからない場合は、GitHub の issue を提出してください。お手伝いいたします。

必要条件

Hexo のインストールは非常に簡単で、事前に以下のものだけが必要です。

  • Node.js (Node.js 10.13 以上が必要です。12.0 以上を推奨します)
  • Git

コンピューターにこれらのソフトウェアが既にインストールされている場合は、おめでとうございます！Hexo のインストール手順にスキップできます。

インストールされていない場合は、以下の手順に従って必要なソフトウェアをすべてインストールしてください。

Git のインストール

  • Windows：git をダウンロードしてインストールします。
  • Mac：Homebrew、MacPorts、またはインストーラーを使用してインストールします。
  • Linux (Ubuntu、Debian)：sudo apt-get install git-core
  • Linux (Fedora、Red Hat、CentOS)：sudo yum install git-core
Mac ユーザー向け

コンパイル時に問題が発生する可能性があります。まず App Store から Xcode をインストールしてください。Xcode がインストールされたら、Xcode を開き、**環境設定 -> ダウンロード -> コマンドラインツール -> インストール** に移動して、コマンドラインツールをインストールします。

Node.js のインストール

Node.js は、ほとんどのプラットフォームで公式インストーラーを提供しています。

代替インストール方法

  • Windows：nvs（推奨）またはnvmを使用してインストールします。
  • Mac：HomebrewまたはMacPortsを使用してインストールします。
  • Linux (DEB/RPM ベース)：NodeSourceを使用してインストールします。
  • その他：それぞれのパッケージマネージャーを使用してインストールします。Node.js が提供するガイドを参照してください。

権限の問題を回避するために、Mac と Linux でも nvs をお勧めします。

Windows

公式インストーラーを使用する場合は、**PATH に追加** が選択されていることを確認してください（デフォルトで選択されています）。

Mac / Linux

Hexo のインストール中にEACCES権限エラーが発生した場合は、npmjs が提供する回避策に従ってください。root/sudo で上書きすることは強くお勧めしません。

Linux

Snap を使用して Node.js をインストールした場合は、ブログを初期化するときに、ターゲットフォルダーでnpm installを手動で実行する必要がある場合があります。

Hexo のインストール

必要なソフトウェアがすべてインストールされたら、npm を使用して Hexo をインストールできます。

$ npm install -g hexo-cli

高度なインストールと使用方法

上級ユーザーは、代わりにhexoパッケージをインストールして使用することを好むかもしれません。

$ npm install hexo

インストール後、Hexo は 2 つの方法で実行できます。

  1. npx hexo <コマンド>
  2. Linux ユーザーは、node_modules/フォルダーの相対パスを設定できます。
echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile

その後、hexo <コマンド>を使用して Hexo を実行します。

必要な Node.js のバージョン

古い Node.js を使用している場合は、以前のバージョンの Hexo のインストールを検討できます。

以前のバージョンの Hexo に対するバグ修正は提供していませんのでご注意ください。

可能であれば、常に最新バージョンの Hexoと推奨バージョンの Node.jsをインストールすることを強くお勧めします。

Hexo バージョン 最小 (Node.js バージョン) 未満 (Node.js バージョン)
7.0+ 14.0.0 最新
6.2+ 12.13.0 最新
6.0+ 12.13.0 18.5.0
5.0+ 10.13.0 12.0.0
4.1 - 4.2 8.10 10.0.0
4.0 8.6 8.10.0
3.3 - 3.9 6.9 8.0.0
3.2 - 3.3 0.12 不明
3.0 - 3.1 0.10 または iojs 不明
0.0.1 - 2.8 0.10 不明
次へ