Skip to content
sakura86.com
戻る

WordPressからAstroへ移行した話(9)日本語のカテゴリ名・タグ名とカテゴリ階層

WordPressでは当たり前にあった「カテゴリ」が、AstroPaperにはありません。

あるのは記事の tags だけです。
しかもタグの表示は、pc-windows のようなスラッグそのまま。日本語のブログでこれはちょっと困ります。

前回は見た目を Luxeritas に寄せました。
今回は、カテゴリとタグを日本語の名前で出して、カテゴリの親子関係も持たせた話です。

カテゴリもタグとして持たせる

AstroPaper にカテゴリの仕組みはないので、カテゴリもタグとして持たせることにしました。

記事の tags に、カテゴリのスラッグを混ぜて書きます。
たとえばこのシリーズの第7回の記事は、こうです。

tags:
  - wordpress
  - astro
  - tips
  - blog-related

この中で blog-related が「ブログ関連」カテゴリで、残りは普通のタグです。
カテゴリのページも、タグと同じ /tags/blog-related/ になります。

方針は2つです。

  • URL はスラッグ(英数字)のまま。表示名だけ日本語にする
  • 表示名と階層は、src/data/ の TypeScript ファイルに書く

URL をスラッグのままにしておけば、表示名を直してもリンク先は変わりません。

3つのファイル

カテゴリの表示名:categoryLabels.ts

// src/data/categoryLabels.ts
export const CATEGORY_LABELS: Record<string, string> = {
  "game": "ゲーム",
  "pc-windows": "PC・Windows",
  "smartphone": "スマートフォン",
  "pc": "PC",
  "blog-related": "ブログ関連",
  "pc-hard": "PCハード",
  "diary": "四方山話",
  "homebuyers": "宅建士試験",
  "engei": "園芸",
  "bike": "オートバイ",
};

カテゴリの階層:categoryHierarchy.ts

// src/data/categoryHierarchy.ts
export const CATEGORY_HIERARCHY: {
  slug: string;
  parent?: string;
}[] = [
  { slug: "game" },
  { slug: "pc" },
  { slug: "pc-windows", parent: "pc" },
  { slug: "pc-hard",    parent: "pc" },
  { slug: "smartphone" },
  { slug: "diary" },
  { slug: "homebuyers", parent: "diary" },
  { slug: "blog-related" },
  { slug: "engei" },
  { slug: "bike" },
];

親子関係は、ツリー状のオブジェクトにはしませんでした。
フラットな配列に parent を持たせたほうが単純です。親は pc と diary の2つだけですしね。

タグの表示名:tagLabels.ts

// src/data/tagLabels.ts(抜粋)
export const TAG_LABELS: Record<string, string> = {
  "astro": "Astro",
  "windows": "Windows",
  "wsl2": "WSL2",
  "darksouls": "ダークソウル",
  "smartphone": "スマートフォン",
  // ... 約60件
};

こちらは数が多いので、手で書くのはやめました。
extract-tag-labels.mjs というスクリプトで、WordPress の DB ダンプからタグのスラッグと日本語名の組を取り出しています。

3つとも、使うときは LABELS[slug] ?? slug の形で読みます。
定義にないスラッグが来ても、スラッグのまま表示されるだけでサイトは壊れません。

画面での使われ方

  • ヘッダーの「カテゴリ」メニュー:CATEGORY_HIERARCHY の順に並べて、子カテゴリは └ を付けてインデント
  • サイドバーのカテゴリ一覧:親カテゴリの下に子カテゴリをぶら下げて、記事数を表示
  • サイドバーのタグクラウド:カテゴリ以外のタグを、記事数が多いほど大きく表示。名前は TAG_LABELS

親カテゴリにも子の記事を出す

階層を定義しただけでは、親カテゴリのページに子カテゴリの記事は出ません。
たとえば /tags/pc/ には、pc のタグが付いた記事だけが並びます。

そこで、add-parent-tags.mjs というスクリプトで、子カテゴリのタグを持つ記事に親のタグも書き足しました。

const PARENT_MAP = {
  'pc-windows': 'pc',
  'pc-hard':    'pc',
  'homebuyers': 'diary',
};

実際、pc-windows の記事には pc も一緒に入っています。

tags:
  - pc-windows
  - windows
  - windows10
  - pc

気になった点

  • タグ名を日本語にしているのは、サイドバーのタグクラウドだけ。タグのページのタイトルや、記事の下に出るタグは、今もスラッグのまま(Tag: pc-windows のような表示)
  • 親子関係が2か所にある。categoryHierarchy.ts と add-parent-tags.mjs の PARENT_MAP
  • 親タグを書き足すのは、移行のときに流したスクリプト。新しい記事は、親のタグも自分で書く必要がある
  • カテゴリを1つ増やすなら、記事のタグ、categoryLabels.ts、categoryHierarchy.ts と、親があれば PARENT_MAP の4か所を触る
  • 階層は親と子の2段まで

おわりに

名前を日本語にして階層を足しただけなので、仕組みとしてはかなり単純です。
そのぶん、あちこちに定義が散っているのが気になるところですが。

タグのページの表示は、今のところスラッグのままです。

次回は、静的サイトにお問い合わせフォームを置いた話です。
WordPressからAstroへ移行した話(10)PHPのお問い合わせフォームとスパム対策



シリーズ目次
WordPressからAstroへ移行した話 まとめ