Vercel を使用して Hexo の静的なブログを無料でデプロイする
Hexo のインストール#
- 公式ドキュメントを参照してください ドキュメント | Hexo
- 理論的には、「概要」と「サイトの構築」の 2 つのステップを行えば十分です
- テーマのインストール：後述を参照してください
GitHub のリモートリポジトリを作成する#
- GitHub で新しいリポジトリを作成し、任意の名前を付けます。その他の設定は変更せず、プライベートに設定することもできます
- アカウント設定でパーソナルアクセストークンを生成し、適切に保管してください。
ローカルの git リポジトリを作成し、GitHub にプッシュする#
- Hexo のルートディレクトリに移動します
# gitリポジトリを作成する
git init
git add .
git commit -m "first commit"
git branch -M main
# GitHubに接続します。例：https://github.com/<ユーザー名>/<リポジトリ名>.git
git remote add origin <リモートリポジトリのアドレス>
# アカウントとパスワードを保存する設定を行います。--globalパラメータを削除すると、現在のパラメータのみが保存されます
git config --global credential.helper store
git push -u origin main
# アカウントとパスワードの入力が求められます。注意：パスワードは以前に生成したパーソナルアクセストークンであり、GitHubアカウントのパスワードではありません
Vercel を使用してデプロイする#
- GitHub アカウントで vercel.com にログインします
- GitHub からプロジェクトを追加し、作成したリポジトリを選択します
- 自動的に hexo プロジェクトとして認識され、設定を変更する必要はありません。そのまま確定してください
- その後、vercel が提供するドメインでアクセスできるようになります。また、独自のドメインを使用することもできます
- ローカルのプロジェクトに変更がある場合、「git add .」、「git commit」、「git push」を行うと、vercel が自動的に更新されます
注意事項#
テーマについて#
- 「git clone」と「git submodule add」のそれぞれには利点と欠点があります。詳細を理解した上で、自分で選択してください
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
# または
git submodule add https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
ファイル名について#
- 他の場所から貼り付けた md ファイルの場合、ファイル名から特殊文字を削除することを忘れないでください。そうしないと、ローカルでは動作するかもしれませんが、vercel では 404 エラーが発生します
- 「hexo new」で作成されたファイルの場合、特殊文字が含まれていても、ファイル名から自動的に削除されます（Front-matter は影響を受けません）。そのため、特殊文字を自由に使用できます