Tag: Hugo
関連ページ†
参考情報†
インストール†
基本的な使用方法†
- HUGOで静的サイトを作成してみた - Qiita
- サイトの作成(demoというサイトが作られる)
hugo new site demo
- テーマの追加。
cd demo
git init
# anankeの場合
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke
# robustの場合
git submodule add https://github.com/dim0627/hugo_theme_robust.git themes/hugo_theme_robust
echo 'theme = "ananke"' >> config.toml
- 記事の追加。content/post下に記事が作成される。
hugo new post/my-first-post.md
- hugo server
hugo server -D
- 記事の公開。静的サイトジェネレータ「Hugo」〜公開方法〜 - SIS Lab。
- hugoコマンドを実行するとpublicディレクトリの下にhtmlが書き出される。それをscpなりで公開する。
Tips†
Hugoの記法†
サブディレクトリで公開†
カテゴリ†
コンテンツ管理†
- ディレクトリを「001-about」(/about)「002-home」(/home)のように設定していけばセクションの順番をフォルダ名で管理できる…と思ったがセクションにslugは設定できないようだ。
- 対して記事に「url」を指定してパーマリンクを設定すると、ディレクトリ部分まで含めてすきなURLを設定できるが(例: /t/hoge.html)、「/t/」に対応したセクションが存在しないと記事一覧は取得できない。
- 結局about、homeのようなディレクトリを設定し、weightを設定するhugo公式ドキュメントサイトのような方式が一番素直なのか。?
ツリー構造†
サイト変数†
- typeってなに?
- デフォルトで最初のフォルダ?contents/posts/aa.mdの場合postsがtype似に設定されるらしい。
シンタックスハイライト†
テーマ†
おすすめテーマ†
テーマのカスタマイズ†
ページリソースをサムネイルとして使用したい。†
hugo_theme_robustの使用†
参考情報†
エディタ†
Visual Studio Code†
hugofy†
- サーバーの開始と終了だけ使う。
- Command+Shift+Pでコマンドを選ぶ
''トラブルシューティング
- 「Default theme not set. Please set one」が発生。「Hugofy: Set Theme」を実行してテーマを設定すれば良いらしい。
トラブルシューティング†
scssが変換できないとかどうとかのエラー†
Error: add site dependencies: load resources: loading templates: walk: Readdir: decorate:†
- hugo server -Dでエラー。
- layoutフォルダ内にEmacsのロックファイルが残っていたのが原因。
- ドットから始まるファイルがないか確認する。
found no layout file for "HTML" for kind "page"†
- hugo server -Dを実行すると以下の警告メッセージが表示される。
- 「 found no layout file for "HTML" for kind "page": You should create a template file which matches Hugo Layouts Lookup Rules for this combination.」
- 原因はテーマを指定していないこと。
- config.tomlで指定。
theme = "mytheme"
public以下にファイルが書き出されない†
- コンテンツがdraftになっていないか確認。
- 「hugo server -D」で確認していて「hugo」でコンパイルするとドラフトが表示されない。
情報が反映されない?†
新規追加したエントリーが表示されない†
- Hugoは標準で未来の日付のエントリーが表示されないようになっている。
- これを変更するには「buildFuture = true」をconfig.tomlに追加する必要あり。
- Front Matterのdateで「2021-11-26T14:24:32+00:00」のようにタイムゾーンを間違えていると意図せず未来の日付になっている可能性がある(日本だと+90:00が正解)。
Last-modified: 2022-08-17 (水) 00:03:45