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のお問い合わせフォームとスパム対策