文書サーバー SEO 改善と再構築

2026-05-30

本日、2つの軸で更新を公開しました。コンテンツレンダラーをページタイプ間で統一し、その上に完全なSEO整備を実施しています。

レンダリングのリファクタリング

  • ボード、リスト、ボードグループ、ボードリストが単一のカードレンダラーを共有:内側余白、背景、シャドウ、角の丸みがタイプ間で完全に一致します。リストのタイトルもボードと同じ h5 体裁になりました。
  • 各ページに <h1> を1つだけ、パンくず最後の項目に配置 — 自然な位置で、追加の視覚スペース不要、ページ見出しの唯一の情報源となります。
  • 全面的なHTMLエスケープ:ユーザー入力に由来するすべての文字列(名前、説明、パンくずラベル、canonical URL、OG画像URL)が html_escape を経てテンプレートに渡されます。Q&A: when to use "file" のような名称が属性を壊すことはなくなりました。
  • 細部の調整:カード行のアイコンとテキストの間隔、リストとボードの角の丸みの統一、リストタイトルの上下余白をボードカードに合わせて整えました。

SEOと多言語URL

  • /zh/... および /ja/... URL:各ページが、各言語ごとのクロール可能な独立URLでアクセス可能になりました。素のURL(例: /policies/)は引き続きデフォルト言語(英語)を提供します。
  • 各ページに <link rel="alternate" hreflang="...">:Googleがユーザーの言語に応じて正しいバージョンを表示できます。
  • canonical、Open Graph、Twitter Card、JSON-LD BreadcrumbList タグを全ページに完備。SNSのリンクプレビューでタイトル・説明・画像が正しく表示されます。
  • /sitemap.xml:バックグラウンドで毎時自動生成・更新。すべてのページと各言語のhreflang代替URLを含みます。
  • /op/switch_lang/<code>:URLとCookieを同期させる新しい言語切替エンドポイント。「中文」をクリックすると /zh/<現在のページ>/ に移動します。

理由

レンダリングのリファクタリングは、長年ページタイプごとに重複していた実装を整理するものです。SEO・多言語対応により、ドキュメントが発見可能でシェア可能になります:メインサイトのユーザーには言語設定を維持しつつ、検索エンジンには各言語を独立したクロール可能なページとしてインデックスさせます。