Hugoで作るWebサイト（GitHub Pages編）

Hugo#

• wingetでHugo.Hugo.Extendedをインストールする
  • 通常版は機能が足りなくてビルド時にエラーが出た
• Hugoのチュートリアル通りに進める
  • hugo new site サイト名
  • git initで同フォルダをGitリポジトリにする
  • git submodule addでthemesフォルダ以下に好きなテーマのリポジトリを追加する
  • hugo.tomlにtheme = 'テーマ名'を書き加える
  • hugo serverでローカルサーバーを立ち上げて結果を確認する
• contentフォルダ以下にMarkdownファイルを追加する
  • Frontmatterにdraft = trueがあると、通常ではページが生成されない
  • hugo server -Dでdraftを含めて結果を確認できる

GitHub Pages#

• チュートリアル通りに進める
  • hugo.tomlにcaches項を追加する
  • .github/workflows/hugo.tomlを作る
• GitHubにプッシュする
• GitHub ActionsでPagesをビルドするよう設定を変える

gitignore#

生成されるものを管理対象外にするよう.gitignoreを書き換える。

public/
resources/
.hugo_build.lockCopy