Hugo：Go製の高速静的サイトジェネレータ

Goで書かれた静的サイトジェネレータ

READMEはHugoを、Goで書かれた高速で柔軟な静的サイトジェネレータと説明し、速度と柔軟性を強調しています。高度なテンプレートシステムと高速なアセットパイプラインにより、完全なサイトを数秒以内にレンダリングします。プロジェクトは一般的な用途として、企業、政府、非営利、教育、ニュース、イベント、プロジェクトサイト、ドキュメントサイト、画像ポートフォリオ、ランディングページ、ブログ、履歴書やCVを挙げています。内蔵のWebサーバーを使用すると、開発中にコンテンツ、構造、動作、プレゼンテーションの変更を即座に確認し、結果をホストにデプロイするか、Gitプロバイダーにプッシュして自動ビルドできます。

gohugoioの確認では、READMEに記載されたコマンド、設定名、出力を一つずつ対応付けます。実行した版と入力を記録し、未記載の挙動は推測で補いません。ログに現れたエラー、生成物のファイル名、終了状態を保存すると、同じ条件で再確認できます。これは一般論ではなく、gohugoioの導入経路を追うための具体的な記録です。

アセットパイプラインとテンプレート

Hugoのアセットパイプラインは、CSS、画像、JavaScript、Sass、Tailwind CSSをカバーしています。CSS処理では、バンドル、変換、ミニファイ、ソースマップ生成、SRIハッシュ、PostCSS連携が可能です。画像処理は、変換、リサイズ、クロップ、回転、色調整、フィルター、テキストや画像のオーバーレイ、メタデータ抽出をサポートします。JavaScriptバンドルはTypeScriptとJSXをJavaScriptにトランスパイルし、バンドル、ツリーシェイキング、ミニファイ、ソースマップ生成、SRIハッシュを行います。Sass処理はSassをCSSに変換し、Tailwind CSS処理はユーティリティクラスを標準CSSにコンパイルします。READMEはこれらを高速なアセットパイプラインの一部としています。

エディションと直接デプロイ

Hugoには標準、デプロイ、拡張、拡張/デプロイの4つのエディションがあります。標準版はコア機能を含みます。デプロイ版はGoogle Cloud Storage、AWS S3、Azure Storageへの直接デプロイを追加します。拡張版はSassをCSSに変換するLibSassサポートを追加しますが、READMEは組み込みLibSassがv0.153.0で非推奨となり将来削除されるため、Dart Sassトランスパイラの使用を推奨しています。拡張/デプロイ版は両方を組み合わせます。READMEは、追加機能が必要でない限り標準版を使用するようアドバイスしています。

ソースからのビルドとインストール

インストールは、プリビルドバイナリ、パッケージマネージャ、またはパッケージリポジトリから行えます。macOS、Linux、Windows、BSDファミリー向けに個別の手順があります。ソースからビルドするには、GitとGoバージョン1.26.0以降が必要です。標準版はCGO_ENABLED=0 go install github.com/gohugoio/hugo@latestでインストールします。デプロイ版はwithdeployタグを追加し、拡張版はGCCやClangなどのCコンパイラを必要とし、CGO_ENABLED=1とextendedタグを使用します。拡張/デプロイ版はextendedとwithdeployの両方を使用します。正確なコマンドはREADMEに記載されています。

Hugo Modulesによるコンテンツ共有

Hugo Modulesは、コンテンツ、アセット、データ、翻訳、テーマ、テンプレート、設定を、公開またはプライベートのGitリポジトリを介してプロジェクト間で共有できます。これは、ファイルをコピーするのではなくコンポーネントを再利用する方法として提示されています。READMEはHugo Modulesに関するドキュメントセクションへのリンクを提供していますが、モジュールシステム自体はコア機能です。README自体には詳細な設定情報はありません。

サポート、ドキュメント、コントリビュート

READMEは、質問やトラブルシューティングにイシューキューを使用しないことを明記し、サポートはフォーラムを利用するよう指示しています。フォーラムはアクティブなコミュニティで、20,000以上のトピックがあり、最初の質問前にヘルプリクエストガイドを読むことを勧めています。ドキュメントはHugoのウェブサイトにあり、ドキュメントの問題やプルリクエストは別のドキュメントリポジトリに送ります。コントリビュートには、フォーラムでの回答、ドキュメントの改善、イシューキューの監視、テーマの作成や改善、バグ修正が含まれます。機能アイデアについては、フォーラムのFeatureカテゴリでトピックを作成し、十分な関心があれば提案を作成し、プロジェクトリーダーが承認するまでプルリクエストを送信しないという流れです。

ライセンスと依存関係

HugoのソースコードはApache License 2.0の下で提供されています。READMEはまた、一部のライブラリがバイナリまたはWASM形式でバンドルされていると述べています。libwebpはBSD-3-Clause、KaTeXはMIT、QuickJSは独自ライセンスで、リンクが提供されています。完全な依存関係リストを見るには、hugo env --logLevel infoを実行します。リポジトリメタデータはHugoがGoで書かれ、デフォルトブランチがmasterであることを示していますが、これはREADMEではなくGitHubメタデータからの情報です。

編集部の結論

HugoのソースコードはApache 2.0でライセンスされ、READMEはサポートをフォーラムへ、ドキュメントの問題をドキュメントリポジトリへ誘導します。 gohugoioでは、READMEのコマンドと設定を小さな検証環境で確認し、出力と失敗ログが用途の条件を満たすかを見てから採用範囲を決めます。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes