このセクションでは、Hugoの基本的な使い方から応用まで、ステップバイステップで学べるチュートリアルを公開しています。

このセクションについて

  • 初心者から中級者向け
  • 実践的なサンプルコード付き
  • 日本語で分かりやすく解説

目次

入門編

  1. Hugoを始めよう - インストールと最初のサイト作成
  2. テーマを追加する - テーマの選び方と設定
  3. 記事を作成する - Markdownでの記事作成

実践編

  1. 新しい記事を追加する - 記事追加の詳細ガイド
  2. 開発サーバーとホットリロード - 効率的な開発環境
  3. タグとタクソノミー - コンテンツの分類方法

応用編

  1. 画像の扱い方とリサイズ - 画像処理機能の活用
  2. 記事の並び順を制御する - ソートとweight
  3. ページバンドルを理解する - ファイル構造の整理
  4. 記事プレビューの設定 - 要約の長さ調整

デプロイ

  1. Cloudflare Pagesにデプロイする - 無料で高速なホスティング
  2. GitHub Pagesにデプロイする - GitHub Actionsで自動デプロイ

トラブルシューティング

  1. Hugoでハマりやすいポイント - よくある問題と解決法
チュートリアル

Hugoを始めよう

Hugoとは

Hugoは、Go言語で作られた高速な静的サイトジェネレーターです。

インストール方法

macOS (Homebrew)

brew install hugo

Windows (Chocolatey)

choco install hugo-extended

最初のサイトを作成

hugo new site mysite
cd mysite

次のチュートリアルでは、テーマの設定方法を学びます。

read more
チュートリアル

テーマを追加する

テーマの選び方

Hugoには多くの無料テーマがあります。

公式テーマサイト: https://themes.gohugo.io/

テーマのインストール

Git submoduleを使う方法が一般的です：

git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke

設定ファイルを編集

hugo.toml にテーマを指定します：

theme = 'ananke'

これでテーマが適用されます！

read more
チュートリアル

記事を作成する

新しい記事を作成

Hugoコマンドを使って記事を作成します：

hugo new content posts/my-post.md

フロントマター

記事の先頭にはメタデータを記述します：

+++
date = '2025-12-17T10:00:00+09:00'
draft = true
title = '記事タイトル'
tags = ['タグ1', 'タグ2']
+++

Markdownで本文を書く

フロントマターの下に、Markdown形式で本文を書きます。

  • 太字 は **太字**
  • 斜体 は *斜体*
  • リンク は [リンク](URL)

以上で基本的な記事作成は完了です！

read more