Hugo テーマ 2. まずは作ってみる
2026-06-15 00:11:30 Hugo内容が古くなっている可能性があるのでご注意ください。
テーマを作りプロジェクトに適用するところまでを解説します。
テーマを作成する
テーマの作成にもコマンドがあります。 これは単純にテーマに必要なファイルを作成してくれるコマンドです。
公式ドキュメントhugo new theme ☐↗
ここでは “derty” という名前で作成します。
> hugo new theme derty
Creating new theme in (省略)/themes/derty
Note
実行するコマンドは “>” に続けて記載します。 出力例は続く行に “>” なしで記載します。
上記のコマンドを実行すると、以下のようにファイルが作成されます。
作成されたファイル (長いので折り畳み)
\---themes
\---derty
| hugo.toml
|
+---archetypes
| default.md
|
+---assets
| +---css
| | | main.css
| | |
| | \---components
| | footer.css
| | header.css
| |
| \---js
| main.js
|
+---content
| | _index.md
| |
| \---posts
| | post-1.md
| | post-2.md
| | _index.md
| |
| \---post-3
| bryce-canyon.jpg
| index.md
|
+---data
+---i18n
+---layouts
| | baseof.html
| | home.html
| | page.html
| | section.html
| | taxonomy.html
| | term.html
| |
| \---_partials
| | footer.html
| | head.html
| | header.html
| | menu.html
| | terms.html
| |
| \---head
| css.html
| js.html
|
\---static
favicon.ico
余分なファイルを削除する
archetypes
hugo new content を実行した際に、セクション (ざっくり解説: content 内のサブフォルダー) ごとにコンテンツのひな形を定義しています。
テーマ側がセクションの構造を指定するような場合にはあった方が親切な場合もありますが、今回作成するテーマでは取り扱わないため、削除します。
content
すでに自身のプロジェクトにコンテンツがある場合、themes/derty/content の方は不要ですので削除しましょう。
コンテンツがまったくない状況であれば、残しておくと動作確認には便利です。 いずれにしても、最終的には削除しましょう。
Warning
content 内のファイルを残しておくと、このテーマを利用したサイトに、これらのコンテンツが混在することになります。
(static/favicon.ico)
プロジェクトで favicon.ico を作っている場合そちらが優先されますが、ない場合にこのファイルが使われます。
使う側の混乱を避けるため削除しましょう。
プロジェクトにテーマを適用する
プロジェクトの設定ファイルを編集し、作成したテーマを適用します。
設定ファイルは、プロジェクトのルートディレクトリーに config.toml といった名前で存在するはずです。
Warning
編集しようとしているのはテーマの設定ファイルではありませんので、ご注意ください。
🙅
themes/derty/hugo.toml
👍config.toml
theme = "derty"
編集が終わったら、以下のようにコマンドを実行してプレビューします。
> hugo serve -D
サイトのトップページ 個別の記事のページ(コンテンツページ) セクションページ


- 📄 Hugo テーマ 9. Pagefind でサイト内検索機能を付ける2026-06-15 00:11:30静的なインデックスを使った検索 UI を提供する Pagefind を組み込みます。
- 📄 Hugo テーマ 8. Shortcodes と Render hooks2026-06-15 00:11:30Markdown で記述したコンテンツ (テーマの利用側) に対して Hugo が用意した HTML 変換の仕組みを解説します。
- 📄 Hugo テーマ 7. layouts/baseof.html をいじる2026-06-15 00:11:30サイト全体に共通する、ページのレイアウト定義を編集します。
- 📄 Hugo テーマ 6. layouts/home.html をいじる2026-06-15 00:11:30トップページのレイアウト定義を編集します。
- 📄 Hugo テーマ 5. layouts/section.html をいじる2026-06-15 00:11:30content 内のディレクトリーに対応するレイアウト定義を編集します。
- 📄 Hugo テーマ 4. layouts/page.html をいじる2026-06-15 00:11:30コンテンツに対応するページのレイアウトを編集します。
- 📄 Hugo テーマ 3. 作られたファイル2026-06-15 00:11:30前回作ったテーマを構成するファイルを解説します。
- 📄 Hugo テーマ 2. まずは作ってみる2026-06-15 00:11:30テーマを作りプロジェクトに適用するところまでを解説します。
- 📄 Hugo テーマ 1. はじめに2026-06-15 00:11:30連載「Hugo テーマ」を行う背景とその方針を説明します。
- 📄 vvin2026-05-30 16:58:07Windows のウィンドウサイズを操作する CLI アプリ