Skip to content

index.md

Latest commit

 

History

History
111 lines (77 loc) · 5.92 KB

index.md

File metadata and controls

111 lines (77 loc) · 5.92 KB
title 概要

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

{% note warn Macをお使いの場合 %} コンパイル時に問題が発生した場合、まずApp StoreからXcodeをインストールしてください。その後、Xcodeを開きPreferences -> Download -> Command Line Tools -> Installよりcommand line toolsをインストールしてください。 {% endnote %}

Node.jsのインストール

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

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

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

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

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

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

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

Hexoのインストール

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

$ npm install -g hexo-cli

The Hexo installed using the commands above is globally effective. If the installation is successful, executing the following command will display the version information.

$ hexo --version

{% note info %} For advanced users familiar with npm, you can opt for a local installation of the hexo package instead of a global one. This approach can help avoid potential permission issues associated with global installations. For example, you can clone an existing Hexo blog repository, and after installing dependencies, execute Hexo commands using npx hexo.

$ git clone https://github.com/hexojs/hexo-starter
$ cd hexo-starter
$ npm install
$ npx hexo --version

If you choose a local installation of hexo, Linux users can add the node_modules directory in the Hexo directory to their PATH environment variable to directly use hexo <command>:

echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile

{% endnote %}

必要な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