本次チュートリアルのデモ環境は mac システムで、windows システムは基本的に同じ手順ですので、ここでは詳しく説明しません。
インストール準備#
hexo をインストールする前に、必ず以下の 2 つのソフトウェアがコンピュータにインストールされていることを確認してください:
- node.js
- git(インストールを促されるので、同意すれば大丈夫です)
インストール開始#
- ターミナルツールを開き、以下のコマンドを入力して管理者権限に入ります:
sudo su
- npm をインストールします。国内の特別な事情により、npm のインストールは遅くなることがありますので、ここでは淘宝の cnpm を使用してインストールします:
npm install -g cnpm --registry=https://registry.npm.taobao.org
- hexo をインストールします:
cnpm install -g hexo-cli
-
ユーザーディレクトリであるか確認します。そうであれば操作を続け、そうでなければユーザーディレクトリ(通常はユーザー名のフォルダ)に入る必要があります。
-
新しいディレクトリを作成します。ここでは blog という名前にします:
mkdir blog
- blog ディレクトリに入ります:
cd blog
- ブログを初期化します:
sudo hexo init
提示:INFO Start blogging with Hexo! は成功を示します
- ローカルテスト:
hexo s
表示
INFO Start processing
INFO Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.
- ブラウザで上記のアドレスを開くと hexo ブログを確認できます
新しい記事を公開#
- 新しい記事を作成します
hexo n "記事タイトル"
INFO Created: /Users/ching/blog/source/_posts/ 記事タイトル.md
-
記事に入ります(ここでは vim コマンドを直接使用して編集しますが、他の Markdown エディタを使用することもできます)
-
i を押して、Enter を押して編集を開始します。ここでは適当にいくつかの内容を入力し、編集が完了したら、esc を押して、と入力して保存します。
-
blog ディレクトリに戻り、クリーンアップを行います:
hexo clear
- ウェブサイトの内容を生成します
hexo g
- 再度 hexo s コマンドを使用してローカルテストを開始し、公開が成功したか確認します
ローカルサイトをネットワークに公開#
今日はウェブサイトを github に公開する方法をデモします。
- github にログインします
- 新しいリポジトリを作成します
- 右上の + ボタンをクリックして new repository を選択
- リポジトリ名:github ユーザー名 + github.io
- 説明を記入します
- create repository をクリックして作成します
- ローカルターミナルに戻り、プラグイン hexo-deployer-git をインストールします:
cnpm install --save hexo-deployer-git
- 設定ファイルを開きます:
vim _config.yml
- ドキュメントの末尾に移動し、編集を行います:
deploy:
type: git
repo: https://github.com/ ユーザー名 / カスタムアドレス.github.io.git
branch: master
- github にデプロイします:
hexo d
github アカウントのパスワードを入力し、表示 INFO Deploy done: git は成功を示します
- 私たちのウェブサイトにログインして確認します