作成日: 2026/04/17

現行システム仕様#

このページは、現在のブログ実装の仕様と運用方法をまとめたものです。

1. 技術構成#

  • Static Site Generator: Hugo
  • Theme: hugo-book
  • 設定ファイル: hugo.toml
  • コンテンツ: content/**
  • カスタムテンプレート: layouts/**
  • カスタムスタイル: assets/_custom.scss

2. 現在の主要設定#

hugo.toml の現状:

  • baseURL = 'https://blog-dyb.pages.dev'
  • theme = "hugo-book"
  • サイドバーに Home を固定表示 (menu.before)
  • BookSection = '*' で全セクションをメニュー対象化
  • BookSearch = true で検索有効
  • unsafe = true で本文内 HTML 記述を許可

3. 記事ページの日付表示仕様#

layouts/single.html で、記事右上に日付を表示するように上書きしています。

  • 表示位置: 記事本文の右上
  • 表示形式: YYYY/MM/DD
  • 表示ルール:
    • 作成日 (date) は表示
    • 更新日 (lastmod) は、作成日と異なる日付のときのみ表示
    • 作成日と更新日が同日なら、作成日のみ表示

見た目は assets/_custom.scss の .book-article-date-top で調整しています。

4. 記事の front matter 運用#

最低限の推奨例:

---
title: "記事タイトル"
date: 2026-04-17T10:00:00+09:00
lastmod: 2026-04-17T10:00:00+09:00
draft: false
weight: 1
---

注意:

  • 更新日は lastmod を使う
  • lastemod は誤記のため反映されない

5. 画像と Amazon リンク#

画像に Amazon リンクを付与する基本形:

[![画像説明](画像URL)](https://www.amazon.co.jp/dp/ASIN)

HTML を使う場合 (unsafe = true 前提):

<a href="https://www.amazon.co.jp/dp/ASIN" target="_blank" rel="noopener">
  <img src="画像URL" alt="画像説明" class="book-cover-responsive" />
</a>

6. Search Console / favicon の現行方針#

  • Search Console メタタグは layouts/partials/docs/inject/head.html に配置
  • favicon はテーマ既定のままではなく、static/favicon.ico などで上書き運用する

7. 日常運用コマンド#

ローカル確認:

hugo server --minify --theme hugo-book

公開用ビルド:

hugo --minify

8. 変更時チェックリスト#

  1. front matter の draft が false か
  2. date / lastmod のキー名に誤字がないか
  3. ローカルで表示崩れがないか
  4. hugo --minify が成功するか