Touchez du bois ブログ執筆ガイド

このガイドは、Touchez du boisのブログ記事を効率的に執筆するための手順をまとめたものです。

執筆フロー

1. 新規記事作成（2つの方法）

方法A: Obsidianで作成（推奨）

1. Obsidianでcontent/blog-page/をVaultとして開く
2. カテゴリフォルダ内に新規フォルダ作成（記事タイトル名）
3. フォルダ内にindex.mdを作成
4. テンプレートを挿入（Cmd+P → Insert template → blog-post-template）

方法B: Hugoコマンドで作成

hugo new blog-page/カテゴリ名/記事タイトル/index.md

2. Front Matterの設定

記事のメタデータを設定します。

---
title: "記事タイトル"  # 必須：30文字以内が理想
type: "post"  # 固定値
layout: "blog-page"  # 固定値
popular: false  # 人気記事フラグ（true/false）
thumbnail: "thumbnail.jpg"  # サムネイル画像ファイル名
date: "2025-11-18T10:00:00+09:00"  # 公開日時（ISO 8601形式）
draft: true  # 下書き（公開時はfalseに変更）
tags:  # タグ（複数指定可）
- "イベント"
- "新商品"
pageTitle: "カスタムページタイトル（省略可）"  # 空欄の場合はtitleが使用される
pageDescription: "カスタムページ説明文（省略可）"  # SEO用の説明文
---

重要な項目:

• title: 記事のタイトル（30文字以内推奨）
• thumbnail: サムネイル画像ファイル名（同じフォルダ内に配置）
• date: 公開日時（ISO 8601形式で指定）
• draft: true=下書き、false=公開
• tags: 記事に関連するタグ（配列形式）

3. 画像の配置

記事フォルダ内に画像を配置します。

記事フォルダ/
├── index.md
├── thumbnail.jpg  ← サムネイル（必須、推奨サイズ: 1200x630px）
├── photo1.jpg     ← 本文画像
└── photo2.jpg     ← 本文画像

Markdown内での画像参照:

![画像の説明文](photo1.jpg)

Hugoが自動的に相対パスを解決するため、ファイル名のみで参照できます。

画像最適化のポイント:

• サムネイル: 1200x630px（SNSシェア対応）
• 本文画像: 幅800px程度
• ファイル形式: 写真はJPG、図やイラストはPNG
• ファイル名: 日本語OK、スペース不可（ハイフンやアンダースコア使用）

4. プレビュー

ローカルサーバーを起動して、執筆中の記事をリアルタイムプレビューできます。

hugo server -D

• -Dオプション: 下書き（draft: true）の記事も表示
• ブラウザでhttp://localhost:1313にアクセス
• ファイルを保存すると自動的にリロードされます

Obsidianとの併用:

1. Obsidianで記事を執筆・保存
2. ブラウザで即座に変更を確認
3. 見た目を確認しながら執筆を進める

5. 公開

記事の執筆が完了したら、以下の手順で公開します。

1. draft: falseに変更
2. dateを公開日時に設定（未来の日時も設定可能）
3. ファイルを保存
4. Gitでコミット・プッシュ

git add .
git commit -m "ブログ記事追加: 記事タイトル"
git push

Markdownスタイルガイド

見出し

## 大見出し（h2）
### 中見出し（h3）
#### 小見出し（h4）

注意: #（h1）は記事タイトルで自動的に使用されるため、本文では##（h2）から使用してください。

リスト

- アイテム1
- アイテム2
  - サブアイテム2-1
  - サブアイテム2-2
- アイテム3

1. 番号付きリスト1
2. 番号付きリスト2
3. 番号付きリスト3

強調

**太字**
*斜体*
~~取り消し線~~

リンク

[リンクテキスト](https://example.com)

外部リンク例:

[Instagram](https://www.instagram.com/patisserie_touchez_du_bois/)
[ECサイト](https://patisserietouchezdubois.shop/)

引用

> これは引用文です。
> 複数行にまたがることもできます。

コード（必要に応じて）

`インラインコード`

\`\`\`
コードブロック
複数行のコード
\`\`\`

カテゴリとタグの使い分け

カテゴリ（フォルダ名）

記事を大きく分類するために使用します。現在のカテゴリ:

• イベント: イベント情報、お知らせ
• スタッフの雑談: スタッフのコラム、裏話
• 季節・時候: 季節のお菓子、時候の話題

よく使うタグ

記事の内容に応じて、複数のタグを設定します。

お知らせ系:

• お知らせ
• 営業時間変更
• 臨時休業

商品系:

• 新商品
• クッキー缶
• ケーキ
• 焼菓子
• プティガトー
• パン
• ドリンク

サービス系:

• イートイン
• オンラインショップ
• 店頭受け取り

イベント系:

• バレンタイン
• ホワイトデー
• クリスマス
• 母の日
• 父の日

場所・雰囲気系:

• 上新庄
• 大桐
• カフェ
• 喫茶

その他:

• レシピ
• 食材
• シェフの想い

SEO対策

タイトルの付け方

• 30文字以内が理想
• キーワードを含める（地域名、商品名など）
• 【】で目を引く

良い例:

【バレンタイン2025】大切な人に贈るチョコレートギフト
【上新庄カフェ】イートインスペースでゆっくり過ごす時間

避けるべき例:

新商品のお知らせ  ← 抽象的すぎる
クッキー缶  ← 短すぎる、情報不足

pageDescriptionの設定

記事の内容を100〜150文字で要約します。検索結果に表示されるため、魅力的な文章にしましょう。

pageDescription: "大阪上新庄のケーキ屋Touchez du boisのバレンタイン限定商品をご紹介。こだわりのチョコレートギフトで大切な人に想いを伝えませんか。"

Obsidian設定ガイド

Vaultの設定

1. Obsidianを起動
2. “Open folder as vault"を選択
3. /Users/akirakano/WebstormProjects/brindille/content/blog-page/を選択
4. Vault名: TouchezDuBois Blog

推奨プラグイン

Templatesプラグインの設定

1. Settings → Core plugins → Templates（有効化）
2. Settings → Templates → Template folder location
3. .obsidian/templatesを指定
4. Date format: YYYY-MM-DDTHH:mm:ssZZ

テンプレートの使用方法

1. 新規ノート作成（Cmd+N）
2. コマンドパレット（Cmd+P）
3. “Insert template"を実行
4. blog-post-templateを選択

トラブルシューティング

画像が表示されない

原因: 画像ファイルのパスが間違っている

解決方法:

• 画像ファイルがindex.mdと同じフォルダにあるか確認
• ファイル名が正確か確認（大文字小文字も区別されます）
• ファイル名にスペースが含まれていないか確認

ビルドエラーが出る

原因: Front Matterの形式が間違っている

解決方法:

• YAMLの形式が正しいか確認（インデント、コロン、ハイフンなど）
• ---で囲まれているか確認
• 日付の形式がYYYY-MM-DDTHH:mm:ss+09:00になっているか確認

記事が表示されない

原因: draft: trueのまま、またはdateが未来

解決方法:

• draft: falseに変更
• hugo server -Dで下書きも含めてプレビュー
• dateが現在または過去の日時になっているか確認

執筆のコツ

読みやすい記事を書くために

1. 見出しを効果的に使う: 記事を構造化し、読者が内容を把握しやすくする
2. 段落を短く: 1段落3〜5行程度に抑える
3. 画像を適切に配置: 文章の途中に画像を挟んで、視覚的に楽しめるようにする
4. リスト形式を活用: 箇条書きで要点を明確にする

エンゲージメントを高めるために

1. 冒頭で興味を引く: 最初の段落で読者の関心を掴む
2. ストーリーを語る: 商品の背景やエピソードを共有する
3. 行動を促す: 記事の最後に「ぜひお店でお試しください」などのCTAを入れる
4. タグを適切に設定: 関連記事が表示されやすくなる

サンプル記事構成

新商品紹介の場合

## この商品が生まれた背景

シェフの想いやこだわりを語る...

## 商品の特徴

- 特徴1
- 特徴2
- 特徴3

![商品画像](product.jpg)

## おすすめの楽しみ方

具体的な食べ方や楽しみ方を提案...

## ご購入方法

店頭またはオンラインショップでお求めいただけます。

[オンラインショップ](https://patisserietouchezdubois.shop/)

イベント告知の場合

## イベント概要

- 期間: 2025年2月1日〜2月14日
- 対象商品: バレンタイン限定ギフト
- 予約: [こちら](https://touchezdubois.take-eats.jp/...)

## 今年のバレンタインの特徴

![バレンタイン商品](valentine.jpg)

## ご予約・お問い合わせ

お電話またはオンラインでご予約を承っております。

まとめ

このガイドに従って、魅力的なブログ記事を執筆してください。

不明な点があれば、仕様書（requirements/01-conversion-tracking-implementation.md）も参照してください。

Happy Writing!