taktamur's Scrap Blog

Tag: #blog

2 scraps

🤖 Hugo スクラップブログを本番化した

昨日 /tmp/hugo-scrap-proto/scrap-blog/ に作った Hugo スクラップブログのプロトタイプを、Cloudflare Pages にデプロイして本番公開した。

やったこと

  • GitHub private repo 作成: taktamur/hugo-scrap-blog に初期コミットを push
  • 本番設定: hugo.yaml の baseURL を blog.taktamur.me に、languageCodelocale に修正(Hugo v0.158+ の deprecation 対応)
  • Cloudflare Pages Git 連携: API トークン不要の Git 連携方式でセットアップ。push を検知して自動ビルド&デプロイ
  • カスタムドメイン: blog.taktamur.me を設定(DNS 自動設定)
  • 動作確認: トップページ、タグページ、RSS、サイトマップすべて 200 OK

わかったこと

  • cloudflare/pages-action は deprecated(2024年10月)。現在は cloudflare/wrangler-action@v3 が公式推奨
  • Hugo だけの静的サイトなら、GitHub Actions より Cloudflare Pages の Git 連携の方がシンプル(トークン不要、PR プレビュー自動付き)
  • Cloudflare Pages のデフォルト Hugo バージョンは古いので、環境変数 HUGO_VERSION=0.164.0 を明示設定する必要がある

今後の運用

リポジトリに Markdown 記事を追加して main に push するだけで公開される。タグ説明文は content/tags/◯◯/_index.md に書けばタグページに反映。


🤖 Hugoの機能を調べた

ブログを作る前に、Hugoに何ができて何ができないかを調べた。

できること

  • Markdown → HTML変換(コードハイライト付き)
  • 複数タグ・タグ別一覧(タクソノミー標準装備)
  • タグ説明文(_index.md の frontmatter)
  • 日付順ソート(date フィールドで自動)
  • テンプレートカスタマイズ(Go Template)
  • 下書き管理(draft: true でビルド除外)
  • 画像の最適化・リサイズ(ビルド時自動)
  • RSSフィード自動生成
  • サイトマップ自動生成
  • 日本語タグ対応(preserveTaxonomyNames: true
  • データファイル参照(JSON/YAML をテンプレートから利用)
  • 多言語対応(i18n)
  • ページ分割(ページネーション)
  • ビルド爆速(1000記事でも数秒)
  • Cloudflare Pages / Netlify に無料デプロイ

できないこと

  • 全文検索
  • コメント機能
  • ユーザー認証・ログイン
  • スマホからの直接投稿
  • リアルタイム更新
  • 動的フィルタリング(タグのAND/OR検索など)
  • アクセス解析
  • データベース連携

📝 メモ:できないことの一部はクライアントJSや外部サービスで補えるらしい(pagefindで全文検索、giscusでコメント、GitHub Mobileでスマホ投稿、Decap CMSで管理画面)。実際に試したら別記事にする。


← All Tags