概要

Hexoのドキュメントへようこそ。利用中に問題に遭遇した場合は、トラブルシューティングをご覧になるか、GitHubでIssueを報告したり、Google Groupでトピックを開始してください。

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を開きPreferences -> Download -> Command Line Tools -> Installよりcommand line toolsをインストールしてください。

Node.jsのインストール

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

それ以外のインストール方法:

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

MacとやLinuxではパーミッション問題を避けるためnvsを推奨します。

Windows

公式インストーラを使用する場合は、Add to PATHがチェックされていることを確認してください（デフォルトでチェックされています）。

Mac / Linux

Hexoをインストールしようとした際にEACCESパーミッションエラーに遭遇した場合は、npmjsによって提供されたワークアラウンドに従ってください。root/sudoでの上書きは強く非推奨です。

Linux

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

Hexoのインストール

すべての要件がインストールされたら、npmでHexoをインストールできます:

$ npm install -g hexo-cli

高度なインストール方法

Node.jsに慣れたユーザーであれば、代わりにhexoパッケージをインストールして使用することを好むかもしれません。

$ npm install hexo

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

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

その後、hexo <command>を使用してHexoを実行します。

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

古いNode.jsを使用している場合は、Hexoの過去のバージョンをインストールすることを検討してください。

Hexoの過去のバージョンへはバグ修正を提供していないことに注意してください。

可能な限り、常にHexoの最新バージョンと推奨されるバージョンのNode.jsをインストールすることを強く推奨します。

Hexoバージョン 最小 (Node.jsバージョン) 未満 (Node.jsバージョン)
7.0+ 14.0.0 latest
6.2+ 12.13.0 latest
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 unknown
3.0 - 3.1 0.10 or iojs unknown
0.0.1 - 2.8 0.10 unknown
Next