👉 https://mitsuyoshi-yamazaki.github.io/ja-jp/
リポジトリ👉 https://github.com/mitsuyoshi-yamazaki/mitsuyoshi-yamazaki.github.io

経緯

よく考えたら、デフォルトで組み込まれているツールを使うということは操作性を放棄するということ

よしHugoにしよう

みつよし

Quickstart

$ hugo new site docs
Congratulations! Your new Hugo site is created in /Users/Mitsuyoshi/Documents/Development/Projects/blog/docs.

Just a few more steps and you're ready to go:

1. Download a theme into the same-named folder.
   Choose a theme from https://themes.gohugo.io/ or
   create your own with the "hugo new theme <THEMENAME>" command.
2. Perhaps you want to add some content. You can add single files
   with "hugo new <SECTIONNAME>/<FILENAME>.<FORMAT>".
3. Start the built-in live server via "hugo server".

Visit https://gohugo.io/ for quickstart guide and full documentation.

変更した設定等

GitHub Pagesが読む docs/ 以下にHugoサイトを生成
テーマ
- https://github.com/adityatelange/hugo-PaperMod
  - 動くテーマを探すため最近のトレンドをググって見つけたもの
- ~~https://themes.gohugo.io/themes/doks/~~
  - このテーマは壊れていた（トラブルシューティングの項を参照

Reference

https://knowledge.sakura.ad.jp/22908/#i-3
- Hugoの挙動が説明されておりわかりやすい

トラブルシューティング

ホスティングしたが空のページが映る

初見殺し酷い

The problem is likely to be the theme - it is either missing or broken. Hugo does not come with any default/fallback theme if you fail to provide a working one.
https://stackoverflow.com/a/43693892

みつよし

TOML

型チェックが入ってるらしい。いいね
https://toml.io/ja/v0.5.0

みつよし

ディレクトリ構成

機械生成されるらしい docs/public/* と docs/resources/* をignore

みつよし

Hugoについて

Goで実装された静的サイトジェネレータである
ディレクトリ構成&機能 https://gohugo.io/getting-started/directory-structure/
- archetypes
  - 生成するコンテンツファイルのテンプレート

みつよし

チートシート

コンテンツ

作成

$ hugo new <CATEGORY>/<FILE>.<FORMAT>

みつよし

多言語対応

コンテンツ自体を多言語にするには？