hexo+githubを使用して個人ブログを作成します。

前書き#

ブログを始める準備をしています。普段遭遇する問題を記録したり、将来の参照や検索に役立てることができます。
それなら、どのようにブログを作成するかを考える必要があります。以前、大学の時に CSDN と博客园にアカウントがありましたが、ほんの少ししか書いたことがありませんでした。また、自分でドメインを購入し、vps を使用して wordpress でブログを作成したこともあります。これは約 2 年間運営され、私が 1 年間働いた後に停止しました。当初の目的は技術ブログを書くことでしたが、学生の間は収益を得るために、徐々に運営が映画のリソースダウンロードサイトになりました。収益はまずまずでした。その間、ウェブサイトのテンプレートを変更するために少しの PHP を学びました。仕事を始めてからはあまり関心を持っていませんでしたが、著作権の問題や個人の成長に対する助けがほとんどないことを考慮して、閉鎖しました。閉鎖する時は少し寂しかったですが、自分で作ったウェブサイトを長い間運営してきたので。長々と話すことは技術ブログには少し情緒的な思いがあると言いたかったのです。それで、今自分でブログを始めて、技術記事を書くという考えが生まれました。
それでは、話を長くしすぎずに本題に入りましょう。
** この記事は Mac での設定ですが、他のシステムバージョンでもほぼ同じです **

Github pages を使用して個人サイトを作成する#

おそらく、プログラマーとして GitHub には馴染みがあると思います。GitHub は GitHub Pages 機能を提供しており、自分自身の個人サイトを GitHub Pages で作成することができます。

Github Pages は、ユーザー、組織、プロジェクト向けの公開静的ページホスティングサービスであり、サイトを無料で Github 上にホストすることができます。Github Pages のデフォルトのドメイン名 github.io を使用するか、カスタムドメイン名を選択することができます。

GitHub アカウントにログインし、右上の + ボタンをクリックして、New repository を選択し、自分のウェブサイトのコードを保存するための新しいリポジトリを作成します。
要件に従ってリポジトリ名を入力します。デフォルトのドメイン名 github.io を使用する場合、リポジトリ名はユーザー名である必要があります。命名規則は次のとおりですusername.github.io、その後、公開を選択し、Create Repository をクリックしてリポジトリを作成します。
これで GitHub 上にコードリポジトリができました。ローカルでコードを書き終えたら、デプロイすることができます。

Git のインストール#

最も簡単な方法は、Git 公式ウェブサイトからダウンロードしてインストールすることです。また、以下の方法でもインストールできます。

Linux#

Debian または Ubuntu Linux の場合、sudo apt-get install gitと入力するだけで Git のインストールが完了します。

Mac OS のインストール#

homebrew をインストールし、homebrew を使用して Git をインストールします。具体的な方法は、homebrew のドキュメントを参照してください：http://brew.sh/

Windows#

公式ウェブサイトからダウンロードすることをお勧めします。インストール後、コマンドラインでgit versionと入力してインストールが成功したかどうかを確認します。

Hexo を使用してブログを作成する#

Node.js のインストール
hexo は Node.js ベースの静的ブログフレームワークなので、まず Node.js をインストールする必要があります。
- 公式ウェブサイトからパッケージをダウンロードしてインストールします。
- 国内の制限のため、公式ウェブサイトにアクセスできない場合、homebrew を使用して node をインストールすることをお勧めします。
- bash コマンドでnode -vと入力してバージョン番号が表示されれば、インストールが成功しています。
Hexo のインストール
node のインストールが完了したら、npm を使用して hexo をインストールできます。hexo 公式ウェブサイト

NPM は NodeJS と一緒にインストールされるパッケージ管理ツールであり、NodeJS のコードデプロイに関連する多くの問題を解決することができます。新しいバージョンの nodejs には既に npm が統合されているため、以前に npm もインストールされているはずです。同様に、npm -vと入力してインストールが成功したかどうかをテストできます。

以下のコマンドを実行して hexo をインストールします：
npm install hexo-cli -g #-gはグローバルインストールを意味し、npmはデフォルトで現在のプロジェクトにインストールされます
次に、以下のコマンドを実行します：
hexo version
バージョン番号が表示されれば、インストールが成功しています。エラーが発生した場合は、次のコマンドを使用してインストールしてみてください：
npm install hexo --no-optional
次のコマンドを使用します：
hexo init blog //指定したディレクトリに初期化コマンドを実行します。ここではhexoフォルダです
cd blog
npm install
hexo generate //現在のディレクトリに静的ウェブページを生成します
hexo server // ローカルサーバーを起動します
ブラウザで http://localhost:4000 を開くと、効果が表示されます。これで hexo による静的ウェブサイトの生成が完了しました。

Github にデプロイする#

ブログディレクトリに移動し、_config.yml という設定ファイルを開き、以下の情報を変更します。

deploy:
  type: git
  repo: [email protected]:username/username.github.io.git
  branch: master

ここでの username は、以前に登録した GitHub のユーザー名です。
これでhexo dを実行して、GitHub にデプロイすることができます。ただし、問題が発生することがあります。次のエラーが表示される場合：

fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.

リモートリポジトリに接続できないことを意味します。通常、コンピューターの SSH キーを設定する必要があります。

GitHub はなぜ SSH キーが必要なのでしょうか？GitHub は、あなたがプッシュしたコミットが本当にあなたがプッシュしたものであることを確認する必要があります。Git は SSH プロトコルをサポートしているため、GitHub はあなたの公開鍵を知っていれば、あなた自身しかプッシュできないことを確認できます。
もちろん、GitHub では複数のキーを追加することができます。たとえば、複数のコンピューターで作業する場合、会社でコミットすることも自宅でコミットすることもできます。各コンピューターのキーを GitHub に追加するだけで、それぞれのコンピューターで GitHub にプッシュできます。

SSH の原理については、阮一峰先生の記事を参考にしてください：
http://www.ruanyifeng.com/blog/2011/12/ssh_remote_login.html
SSH キーの設定方法については、GitHub 公式ウェブサイトのチュートリアルを参照してください：
https://help.github.com/articles/generating-an-ssh-key/
手順を実行してテストが完了したら、hexo dを使用してデプロイできます。デプロイが完了したら、ブラウザで：http://username.github.io/ を開くと、効果が表示されます。