メインコンテンツへスキップ

Hugoでブログを作る手順

·
目次
Windows環境でHugoとBlowfishテーマを使った日本語ブログの作成手順を、インストールから記事公開まで順を追ってまとめています。

環境
#

  • Windows 11
  • Git Bash
  • VS Code
  • Hugo v0.148.2

Hugoインストール
#

Bash
# Hugo Extended版をWindows Package Managerでインストール
winget install Hugo.Hugo.Extended

# インストールされたHugoのバージョンを確認
hugo version

サイト作成とGit初期化
#

Bash
# 作業ディレクトリへ移動
cd /c/repos

# 新しいHugoサイトを作成
hugo new site my-site

# サイトディレクトリへ移動
cd my-site

# Gitリポジトリを初期化
git init

# .gitignoreを作成してHugoが生成する不要ファイルを除外
tee .gitignore <<EOF > /dev/null
# Hugo generated files
/public/
/resources/_gen/

# Hugo temporary lock file
/.hugo_build.lock
EOF

Blowfishテーマ導入
#

Bash
# GitサブモジュールとしてBlowfishテーマを追加
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish

# デフォルト生成されたhugo.tomlを削除
rm hugo.toml

# 設定ディレクトリ作成&テーマの設定ファイルをコピー
mkdir -p config/_default/
cp -a themes/blowfish/config/_default/. config/_default/

サイト設定
#

config/_default/hugo.toml
theme = "blowfish"                  # 使用テーマ
baseURL = "https://example.com/"    # サイト基本URL
defaultContentLanguage = "ja"       # デフォルト言語を日本語に設定

言語設定(日本語)
#

Bash
# 英語用設定ファイルを日本語用にリネーム
mv config/_default/languages.en.toml config/_default/languages.ja.toml
mv config/_default/menus.en.toml config/_default/menus.ja.toml
config/_default/languages.ja.toml
languageCode = "ja"
languageName = "日本語"
weight = 1
title = "My Site"
hasCJKLanguage = true
timeZone  = "Asia/Tokyo"

[params]
  displayName = "JA"
  isoCode = "ja"
  rtl = false
  dateFormat = "2006-01-02"

コンテンツ追加
#

--editor=codeで新しい記事をVS Codeで開くことができます。
ただし初期状態ではHugoのセキュリティ制約により動作しません。

HugoでVS Codeを記事エディタに使う設定
·
Bash
# 新しい記事を作成してVS Codeで編集
hugo new posts/hello-world.md --editor=code
content/posts/hello-world.md
+++
date = '2025-08-19T20:00:00+09:00'
draft = false
title = 'Hello World'
+++

こんにちは世界。
draft = true のままだと下書き状態で公開されません。

サイト確認とビルド
#

Bash
# ローカルサーバーで表示確認
hugo server

# 本番用ビルド(不要ファイル削除、最適化、出力先クリーンアップ)
hugo --gc --minify --cleanDestinationDir

参考
#

prata0x
著者
prata0x
Game programmer

関連記事

hello, world