memo

個人的に忘れそうだったのでメモ

Hugoで記事に画像を添付する方法

Hugoで記事に画像を添付するには、主に2つの方法があります：

1. Page Bundle方式（推奨）

記事と画像を同じフォルダに配置する方法です。これが最も管理しやすい方法です：

1
2
3
4
5
6
7


content/
└── posts/
    └── my-post/
        ├── index.md  # 記事本文
        ├── image1.jpg  # 画像ファイル
        └── image2.png  # 画像ファイル
    

手順

まず記事用のディレクトリを作成
1

hugo new content/posts/my-post/index.md
同じディレクトリ内に画像を配置
Markdown内で相対パスで参照

本文

以下は画像です：

1
2
3
4
5


![画像の説明](image1.jpg "画像のタイトル")  

サイズ指定もできます：

![画像の説明](image2.png "画像のタイトル"){width=300px}

2. 静的ファイル方式

共通で使いたい画像を static ディレクトリに配置する方法：

1

# static/images/ ディレクトリに画像を配置

Markdown内での参照：

1

![画像の説明](/images/sample.jpg "画像のタイトル")

注意事項

画像ファイル名には日本語や特殊文字を避け、英数字とハイフンを使用するのが安全です
大きな画像は最適化してからアップロードしましょう
常に代替テキスト（alt属性）を設定しましょう

Blowfishテーマでは、Page Bundle方式が特に推奨されており、画像処理機能なども利用できます。

ディレクトリへテンプレートを使用して記事を作成するコマンド

週報用のテンプレート（アーキタイプ）を使ってディレクトリに新しい記事を作成するには、以下のコマンドを使用します：

**hugo new **–kind テンプレディレクトリ/記事タイトル

例えば、「2025年3月第1週」という週報を作成したい場合：

1

hugo new --kind weekly weekly/2025年3月第1週

このコマンドを実行すると、content/weekly/2025年3月第1週/index.mdが作成されます。

–kindオプションは「どのテンプレート（アーキタイプ）を使用するか」を指定するためのフラグです。

詳細説明

アーキタイプの選択

–kind weekly は weekly フォルダ内のテンプレートを使用する
–kind posts は posts フォルダ内のテンプレートを使用する

ディレクトリ構造の作成

単にファイルだけでなく、ディレクトリ構造も含めた複雑なテンプレートを適用

テンプレートの優先順位

–kind を指定しない場合、デフォルトテンプレート（archetypes/default.md）が使用される

普通の記事を作成したい場合

hugo new content post/AndroidStudioLanguageというコマンドは正しくありません。以下のように修正してください：

1

hugo new post/AndroidStudioLanguage.md

「content」という単語は不要で、ファイル拡張子（.md）を追加する必要があります。