HexoとGithub pagesで自分のブログをつくる

Part 0: 素材の準備


Part 1: インストールHexo


  1. もしWindows 11のWindows PowerShellを利用するの方、多分npmに関するのコメントを実行するのときunauthorizedaccessの問題が発生する、
    その原因はWindows PowerShellのExecutionPolicyデフォルト設定はRestrictedので、以下のコメントを実行すれば解決できる。
    ※Run as Administratorが必要です。詳細
1
Set-ExecutionPolicy RemoteSigned
  1. CLIを使って、以下のコメントを入力、Hexoをインストールする
1
npm install hexo-cli #-g を付けたらグローバル設定になるので自分の環境次第
  1. hexo init [フォルダネーム] を入力してhexoの初期設定をする
1
npx hexo init blog #もし上のコメント-g付けてないなら、hexoに関するコメントの前全部npx付けないといけない
  1. npm installを実行する、Hexoが必要なものをインストールします
1
npm install

以上基本のインストールが大部終わりました、詳しくの内容さすがにオフィシャルサイトの方がおすすめ 詳細

Part 2: パブリックアンギット


  1. 新しRepositoryをつくる
    新しRepository

  2. Repositoryの名前を[username].github.io、前の[username]は自分のusername
    RepositoryName

  3. アップロード必要なツールhexo-deployer-git詳細をインストール
    hexo-deployer-gitの中身がgit push --forceを使用したのでもし使っているのは既存Repositoryの時要注意

1
npm install hexo-deployer-git 
  1. _config.ymlの設定
    Deploymentの部分deployの設定は下のように、詳しく調べたいなら詳細
1
2
3
4
5
deploy:
type: git
repo: https://github.com/<username>/<project>
# example, https://github.com/hexojs/hexojs.github.io
branch: main
  1. deployコメントを実行
1
2
3
4
hexo cl # cl == clean 生成された静的サイトを削除する
hexo g # g == generate .mdファイルと_config.ymlの設定ファイルをもとに静的サイトを生成する
hexo s # s == server Node.jsを使用してローカル環境でブログをテスト表示する
hexo d # d == deploy 内容をGitにデプロイする