01: Hugo による Web サイト作成

brew install hugo

sudo snap install hugo --channel=extended

winget install Hugo.Hugo.Extended

hugo new site my-website
cd my-website

git init
git submodule add https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod

git submodule update --init --recursive

.
├── .github/
│   └── workflows/
│       └── deploy.yml  # Github Actions による自動化スクリプト
├── archetypes/
│   └── default.md  # マークダウンファイルのテンプレを記入
├── assets/
├── content/  # サイトの内容を作成
│   ├── en/  # 英語用
│   │   │── _index.md  # 各セクションのトップページの説明
│   │   └── blog/
│   │       │── _index.md  # 各セクションのトップページの説明
│   │       └── 01-first-post.md  # そのページのコンテンツ
│   └── ja/  # 日本語用
│       ├── _index.md
│       └── blog/
│           │── _index.md  # 各セクションのトップページの説明
│           └── 01-first-post.md  # そのページのコンテンツ
├── data/
├── hugo.toml  # サイトの設定を記入
├── i18n/
├── layouts/
├── public/  # Hugo によりビルドされたファイル群
├── static/
└── themes/
    └── PaperMod/
        ├── ... (テーマのファイル)

---
date: '{{ .Date }}'
draft: true
title: '{{ replace .File.ContentBaseName "-" " " | title }}'
type: '{{ .Section }}'
tags: []
categories: []
---

baseURL = 'https://riichisugai.github.io/'  # サイトの公開URL
languageCode = 'en-us'  # サイトの主要言語
theme = "PaperMod"  # 使用するテーマデザイン
title = 'Riichi Sugai'  # サイトのタイトル

relativeURLs = false  # 相対URLを無効化
canonifyURLs = true   # 絶対URLを使用

# デフォルト言語を明示
defaultContentLanguage = "en"
defaultContentLanguageInSubdir = true

# 多言語対応の設定
[languages]
  # 英語ページの設定
  [languages.en]
    weight = 1
    languageName = "English"
    contentDir = "content/en"  # サイトのコンテンツが置かれているディレクトリを指定
    mainSections = ["blog"]
    
    # 英語ページのヘッダーメニュー設定
    [[languages.en.menu.main]]
      identifier = "blog"
      name = "Blog"   # サイトに表示するヘッダー名
      url = "/blog/"  # サイトのディレクトリ
      weight = 1      # 表示順序の優先度
  
  # 日本語ページの設定
  [languages.ja]
    weight = 2
    languageName = "日本語"
    contentDir = "content/ja"
    mainSections = ["blog"]
    
    # 日本語ページのヘッダーメニュー設定
    [[languages.ja.menu.main]]
      identifier = "blog"
      name = "Blog"
      url = "/blog/"
      weight = 1

[params]
  # ページ内のコードブロックにコピーボタンを表示
  ShowCodeCopyButtons = true
  author = "Riichi Sugai"

  ## プロフィールモードの設定
  #[params.profileMode]
  #  enabled = true # プロフィールモードを有効化
  
  # ホームページ情報の設定
  [params.homeInfoParams]
    ShowRecentPosts = true # 最近の投稿を表示
    RecentPostsCount = 3   # 表示する件数を3に設定
  
  # Validate Top page
  [outputs]
    home = ["HTML", "RSS", "JSON"]

hugo new content/en/_index.md
hugo new content/ja/_index.md

hugo new /content/ja/blog/_index.md

---
date: '2025-11-01T02:14:44+09:00'
draft: false
title: 'Blog'
type: 'blog'
tags: []
categories: []
---

hugo new /content/ja/blog/01-first-post.md

---
date: '2025-11-01T02:14:44+09:00'
draft: false
title: '<Title of blog>'
type: 'blog'
tags: []
categories: []
---

hugo server -D

# ワークフローの名前
name: Deploy Hugo site to GitHub Pages

# ワークフローが実行されるタイミング
on:
  push:
    branches:
      - main  # hugo-source の main ブランチにプッシュされた時のみ実行

# 実行される一連のジョブ
jobs:
  build-and-deploy:
    # ジョブを実行する仮想環境の種類: 自分の OS によらず以下でOK
    runs-on: ubuntu-latest

    # ジョブの各ステップ
    steps:
      # 1️⃣ ソースコードをチェックアウト
      - name: Checkout source code
        uses: actions/checkout@v4
        with:
          submodules: true  # PaperModテーマのようなサブモジュールも取得
          fetch-depth: 0    # Gitの履歴をすべて取得
          persist-credentials: false  # checkout 後の credentials を無効化

      # 2️⃣ Hugoの環境をセットアップ
      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v3
        with:
          hugo-version: 'latest' # 最新版のHugoを使用

      # 3️⃣ コミットメッセージ作成
      - name: Generate commit message
        id: commitmsg
        run: |
          # 直前のコミットとの差分を取得
          CHANGED_FILES=$(git diff --name-only HEAD~1 HEAD content 2>/dev/null)
          if [ -z "$CHANGED_FILES" ]; then
            echo "MESSAGE=Deploy site on $(date '+%Y-%m-%d %H:%M:%S')" >> $GITHUB_ENV
          else
            TITLES=$(echo "$CHANGED_FILES" \
                      | sed 's|content/||g' \
                      | sed 's|/_index.md||g' \
                      | sed 's|.md||g' \
                      | tr '\n' ', ')
            echo "MESSAGE=Update: ${TITLES} ($(date '+%Y-%m-%d %H:%M:%S'))" >> $GITHUB_ENV
          fi
          echo "Commit message: $MESSAGE"

      # 4️⃣ Hugoサイトをビルド
      - name: Build Hugo site
        run: hugo --cleanDestinationDir --minify # hugoコマンドでサイトをビルドし、ファイルを圧縮

      # 5️⃣ 公開用リポジトリにプッシュ
      - name: Deploy to GitHub Pages
        uses: peaceiris/actions-gh-pages@v3
        with:
          # ステップ1,2で設定したPATと公開先リポジトリを指定
          personal_token: ${{ secrets.GH_PAT }}
          external_repository: riichisugai/riichisugai.github.io  # ソース用リポジトリと公開用リポジトリが別の場合は external_repository: "ユーザー名/リポジトリ名" が必要
          
          # 公開するディレクトリとブランチを指定
          publish_dir: ./public
          publish_branch: gh-pages # riichisugai.github.io の gh-pages ブランチに公開
          
          # コミットメッセージとコミッター情報を設定
          commit_message: "Deploy: ${{ github.event.head_commit.message }}"
          user_name: 'github-actions[bot]'
          user_email: 'github-actions[bot]@users.noreply.github.com'