Hexoでブログを作る

4619 ワード
GitHubActions github-pages Hexo github-pages テキストリンク

TEMPLATE BLOG

直接使えるtemplateもgithub上で用意しています。
ご参考になればと思います。

CODE
BLOG URL

自分のrepoを使う時に、変更する必要のある場所は
1. Deploy Setting
2. Github Pages Setting
3. Set Github Page URL

Hexo とは

  1. Node.js製の静的サイトジェネレータ
  2. markdown形式で書いた記事は、最終的にはHTML形式に出力される

node.js

Node.js製の静的サイトジェネレータなので、 Node.jsをインストールする必要がある

nvm

nvmでNode.jsをインストールする

Install

npm install -g hexo-cli

Commands

$ hexo init [folder]
$ hexo server

Deploy to Github

hexo-deployer-gitをインストール

$ npm install hexo-deployer-git --save

Deploy Setting

_config.yamlのdeploy設定を設置

branchを pages に設置

_config.yaml
deploy:
  type: git
  repo: <repository ssh> # [email protected]:<user>/<repository name>.git
  branch: pages

Deploy Command

hexo clean && hexo deploy

Github Pages Setting

Branchはpagesを選択

Folderはrootを選択

Set Github Page URL

_config.yaml
# URL
## Set your site url here. For example, if you use GitHub Page, set url as 'https://username.github.io/project'
url: https://username.github.io/project

Github Actions

main branchをpushするたびに、自動的にpage branchにdeployする

.github/workflows/pages.ymlを追加

deploying branchはpagesを設置

.github/workflows/pages.yml
publish_branch: pages # deploying branch