Atsulog#009

2026/11/18 12:02
2026/11/18 14:05
Contents
  1. 機械向けに配信しているもの
  2. Atom フィード
  3. サイトマップ
  4. robots.txt
  5. OGP と Twitter Card

機械向けに配信しているもの#

人が読む HTML のページとは別に,プログラムが読むためのファイルもいくつか配信しています.

  • /feed.xml:新着記事を フィードリーダー に知らせる Atom フィード
  • /sitemap.xml:検索エンジンに公開ページの一覧を伝える サイトマップ
  • /robots.txt:クローラーに巡回してほしくない場所を伝えるファイル
  • 各ページの <meta> タグ:SNS でリンクを共有したときのカード表示(OGP)

フィードリーダーとは,複数のサイトの更新をまとめて購読できるアプリやサービスのことです.クローラー とは,検索エンジンなどがページを自動で巡回して集めるためのプログラムです.

Atom フィード#

フィード とは,サイトの新着情報を決まった形式で並べた XML ファイルです.形式には RSS と Atom があり,Atsulog では Atom(RFC 4287)を使っています.Atom は日付の書き方や必須の要素が仕様で厳密に決められているので,リーダーによる解釈の違いが起きにくい形式です.

/feed.xml は Next.js の Route Handler で作っています.Route Handler とは,ページではなく任意のレスポンスを返す API のようなものです.フォルダ名を feed.xml にすると,そのまま /feed.xml という URL になります.

// app/feed.xml/route.ts
export async function GET() {
  // 公開済みの記事を新しい順に 20 件,本文ごと取得する
  const entries = await getLatestArticleDetails(siteConfig.feedEntriesCount);

  return new NextResponse(buildAtomFeed(entries), {
    headers: { "Content-Type": "application/atom+xml; charset=utf-8" },
  });
}

フィードの中身は,app/lib/feed/atom-feed.ts で文字列を組み立てて作っています.1 記事分の <entry> は次のような形になります.

<entry>
  <id>https://atsulog.com/articles/20261101222711</id>
  <title>Atsulog#004</title>
  <link rel="alternate" type="text/html" href="https://atsulog.com/articles/20261101222711"/>
  <published>2026-11-01T13:27:11.091Z</published>
  <updated>2026-11-02T13:52:27.149Z</updated>
  <category term="Security"/>
  <category term="Cookie"/>
  <category term="JWT"/>
  <category term="Next.js"/>
  <content type="html">&lt;blockquote&gt;...</content>
</entry>
  • <id>:記事を一意に表す ID.記事の URL をそのまま使う
  • <published> と <updated>:Atom が要求する RFC 3339 形式の日時.保存している日時を Date で読み直し,toISOString() で形をそろえる
  • <category>:記事のカテゴリとタグ.重複は取り除く
  • <content>:記事の本文を HTML にしたもの.リーダーの中で全文を読めるように,要約ではなく本文全体を入れている

フィード全体の <updated> は,含まれる記事の更新日時のうち最も新しいものにしています.どれか 1 つの記事が更新されれば,フィードも更新されたことになります.

実際の /feed.xml をブラウザで開くと,次のようになります.<content> の中の本文は,次に説明するエスケープによって &lt;h2&gt; のような形になっています.

XML のエスケープ#

タイトルや本文を XML に埋め込むときは,エスケープ が必要です.エスケープとは,< や & のように XML で特別な意味を持つ文字を,&lt; や &amp; のような別の表記に置き換えることです.

/** Characters XML 1.0 does not allow, even when escaped. */
const INVALID_XML_CHARS =
  /[\u0000-\u0008\u000B\u000C\u000E-\u001F￾￿]/g;

function escapeXml(value: string): string {
  return value
    .replace(INVALID_XML_CHARS, "")                       // XML で使えない文字を消す
    .replace(/[&<>"']/g, (char) => XML_ESCAPES[char]);    // 特殊な 5 文字を置き換える
}

XML 1.0 には,エスケープしても使えない文字があります.タブや改行を除く制御文字などで,これが 1 文字でも混ざるとフィード全体が読めなくなります.そこで,置き換えの前にこれらの文字を取り除いています.本文の HTML も,この関数でエスケープしてから <content type="html"> に入れています.

フィード用のレンダリング#

フィードの本文は,サイトの記事ページとは少し違う設定で HTML にしています.フィードリーダーでは,サイトの CSS も JavaScript も読み込まれないからです.

  • 数式:KaTeX の見た目は CSS とフォントに頼っているので,フィードでは MathML だけを出力する.MathML とは,数式を表すための HTML の要素で,ブラウザが自力で描画できる
  • リンクカード:カードの見た目も CSS に頼っているので,フィードではただのリンクにする
  • 見出しのリンク:記事ページでは見出しの横に # のリンクを付けているが,フィードではこれが文字としてそのまま見えてしまうので付けない
  • 相対 URL:/images/... のような相対 URL は,リーダーではどのサイトのものかわからない.記事の URL を基準に https://atsulog.com/images/... のような絶対 URL に直す
export function renderFeedMarkdown(content: string, baseUrl: string): string {
  feedProcessor ??= createProcessor({
    katex: { output: "mathml" }, // 数式は MathML だけにする
    linkCards: false,            // リンクカードを作らない
    headingLinks: false,         // 見出しに # を付けない
  });
  // baseUrl を渡すと,相対 URL が絶対 URL に直される
  return render(feedProcessor, content, undefined, baseUrl).html;
}

サイトマップ#

サイトマップ とは,サイトにあるページの URL と更新日時を並べた XML ファイルです.検索エンジンは,リンクをたどるだけでは見つけにくいページもこれで知ることができます.

Next.js では,app/sitemap.ts で URL の配列を返すと,それを /sitemap.xml として配信してくれます.

export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
  // "published" keeps the about page, which "public" leaves out.
  const { items } = await searchArticles({}, "published");

  return [
    { url: siteConfig.url },                 // トップページ
    { url: `${siteConfig.url}/articles` },   // 記事一覧
    { url: `${siteConfig.url}/privacy` },    // プライバシーポリシー
    ...items.map((article) => ({
      url: `${siteConfig.url}/articles/${article.slug}`,
      lastModified: article.modifiedAt,      // 記事の更新日時
    })),
  ];
}

配信される /sitemap.xml は次のようになります.記事のページには,<lastmod> として更新日時が付きます.

robots.txt#

app/robots.ts から /robots.txt を作っています.

export default function robots(): MetadataRoute.Robots {
  return {
    rules: { userAgent: "*", allow: "/", disallow: ["/admin", "/login"] },
    sitemap: `${siteConfig.url}/sitemap.xml`, // サイトマップの場所も伝える
  };
}

配信される /robots.txt は次のようになります.

User-Agent: *
Allow: /
Disallow: /admin
Disallow: /login

Sitemap: https://atsulog.com/sitemap.xml

管理画面 /admin とログイン画面 /login は,検索結果に出る意味がないので巡回の対象から外しています.ただし,robots.txt はクローラーへのお願いにすぎず,アクセスを禁止するものではありません.管理画面は,ログインしていなければ開けないようにして別に守っています.

OGP と Twitter Card#

OGP(Open Graph Protocol)とは,ページのタイトル,説明,画像などを <meta> タグで示しておき,SNS やチャットにリンクを貼ったときにカードとして表示させるための仕組みです.X(旧 Twitter)では,同じ目的の Twitter Card という独自のタグも読みます.

Next.js では,ページごとに metadata を返すと,これらのタグを <head> に出力してくれます.公開ページで共通の項目は,app/lib/page-metadata.ts の buildPageMetadata にまとめています.

  • タイトルと説明は,ページごとに渡す
  • 共有用の画像は,すべてのページで share-image.png(1200 × 630)を使う
  • Twitter Card は,大きな画像を表示する summary_large_image にする
  • 記事ページでは,種類を article にし,公開日時も入れる

X にトップページのリンクを貼ると,次のようなカードで表示されます.

記事ページの generateMetadata では,下書きの記事のタイトルが漏れないようにしています.

const detail = await getArticleBySlug(slug);

// A draft must not leak its title, even though the page itself 404s.
if (!detail || !detail.metadata.published) {
  return { title: `Article Not Found | ${siteConfig.title}` };
}

下書きのページ自体は 404 になりますが,メタデータはページ本体とは別に作られます.ここで記事が存在するかどうかしか見ていないと,404 のページの <title> に下書きのタイトルが出てしまうので,公開済みかどうかも確かめています.