重装システム後、環境設定の知識をすべて忘れてしまったことに気づきました。将来の自分に向けてチュートリアルを作成し、他の人にも役立てればなお良いです。
この記事は、Argvchs のHexo 博客搭建教程 Iを大いに参考にしています。実際、この記事のタイトルも参考にしています。
また、Kaitaku の从零搭建 hexo 博客も参考にしています。
0. 前言#
Hexo は、高速でシンプルかつ強力なブログフレームワークです。Hexo は Markdown(または他のレンダリングエンジン)を使用して記事を解析し、美しいテーマを使用して静的ウェブページを数秒で生成することができます。
以下は、Markdown に関連するチュートリアルです。
- Markdown 官方教程
- github 官方文档:基本撰写和格式语法
1. 本地安装 Git & Node.js & Hexo CLI#
- Git
https://git-scm.com/downloads
インストールが完了したら、デスクトップまたは任意のフォルダで右クリックし、「git bash here」をクリックして git ターミナルを開き、git --version
コマンドで確認します。
(以下、特に指定がない限り、すべてのコマンドは git ターミナルで実行します) - Node.js
https://nodejs.org
通常、LTS(Long Term Support)バージョンを選択し、インストールを進めます。
Node.js の公式インストーラを使用する場合は、Add to PATH オプションにチェックを入れてください(デフォルトでチェックされています)。
インストールが完了したら、node -v
とnpm -v
の 2 つのコマンドで確認します。 - Hexo CLI
コマンドnpm install hexo-cli -g
を入力します。
そして、hexo -v
で確認します。 - プラグインのインストール
デプロイプラグイン:pnpm add hexo-deployer-git
を実行し、インストール後にhexo -d
コマンドを使用してブログを Github にデプロイできます。
2.Github 相关设置#
- Github SSH キーの設定
ssh-keygen -t rsa -C "[email protected]"
コマンドを使用して SSH キーを生成します(注意:Github に登録したメールアドレスを入力してください)。
notepad %USERPROFILE%\.ssh\id_rsa.pub
コマンドを使用して、ローカルの SSH キーファイルを開き、コピーします。もちろん、テキストエディタで開くこともできます
Github のページの右上にあるアイコンをクリックして Settings ページに移動し、左側の SSH and GPG keys をクリックします。右上の New SSH key をクリックし、SSH キーを key に貼り付けます。Title は入力しなくても構いません。Add SSH key をクリックしてキーを追加します。
ローカルで以下のコマンドを入力して、Git と Github をバインドします。git config --global user.name "<user>" git config --global user.email "<email>"
- ブランチの設定
Github でブログのリポジトリとして使用するリポジトリを作成し、リポジトリ名を<user>.github.io
とします。例えば、私のユーザー名は janblank499 なので、リポジトリ名はjanblank499.github.io
になります。また、このリポジトリが公開(pubilc)になっていることを確認してください。
ブランチの設定を開き、最初の入力欄にはデフォルトのブランチ(旧バージョンでは master、新バージョンでは main)が表示されます。
ブログのルートディレクトリの_config.yml
を開き、パラメータを設定します。branch:
はデフォルトのブランチと一致していることに注意してくださいdeploy: type: 'git' repository: ** branch: **
以上で、ブログの構築前の設定はすべて完了しました。次のステップは、ローカルでブログを生成してデプロイすることです。
次の記事:Hexo Blog 搭建教程 Ⅱ