実現したいこと テーマをthemes/配下に置いただけのサイトでも、Hugoは内部的にプロジェクトとテーマを1つの依存関係グラフとして扱っている。この依存関係を確認したい。

実現したいこと draft: trueの下書き記事や、publishDateを未来にして予約投稿した記事は、素のhugoコマンドではビルドに含まれない。執筆中にプレビューで見た目を確認したい場合でも、そのままでは記事が出力されない。

実現したいこと HugoはSCSSのコンパイル結果などをresources/_gen/にキャッシュとして保存する。キャッシュのファイル名には内容などから計算したハッシュ値が入っており、キャッシュの元になった内容が変わるとハッシュ値も変わる。ビルドを繰り返すうちに、以前のハッシュ値のまま参照されなくなったキャッシュファイルが残り続ける。

実現したいこと Hugoの拡張版バイナリにはLibSassが同梱されているが、Dart Sassは同梱されておらず別途インストールする必要がある。手元の環境で実際にどのDart Sassが使われているかを確認したい。

実現したいこと config.tomlに書いた値だけが実際の設定のすべてではない。Hugoの既定値や、CLIフラグ・環境変数による上書きも加わったうえで、最終的にビルドで使われる設定値が決まる。

実現したいこと 記事ごとにfrontmatterの引用符の付け方やキーの並び順がばらついていても、hugoは特に気にせずビルドする。統一されていなくても動くからこそ、後から手作業で揃えるのは手間である。

実現したいこと ビルドが遅いと感じても、hugoはどのテンプレートに時間がかかっているかを教えてくれない。 --templateMetricsを付けると、ビルド時にテンプレートごとの累積の実行時間や呼び出し回数を一覧表示できる。

実現したいこと テーマやlayouts/配下にテンプレートを追加・変更していくと、実際にはどこからも呼び出されなくなった古いテンプレートが埋もれていく。hugoは存在するテンプレートファイルを黙って読み込むだけで、使われていないものを教えてくれない。

実現したいこと hugoコマンドは出力先ディレクトリに生成物を上書きするだけで、既存のファイルを削除しない。記事のslugを変更したり記事を削除したりしてからビルドすると、古い記事のHTMLが出力先に残り続ける。

xcrun simctlは、iOSシミュレータをコマンドラインから制御するツールである。1つのサブコマンドが担う役割は小さく分かれているため、目的に応じたサブコマンドを個別に把握しておくと使いやすい。ここではsimctlの主要なサブコマンドを目的別に整理し、それぞれの使い方を解説した記事へリンクする。