ページメタデータの翻訳

問題

ユーザーがスペイン語でページを閲覧すると、表示されているコンテンツはすべて正しく翻訳されています。しかし、ブラウザのタブと検索エンジンの結果スニペットには、依然として英語のタイトルと説明が表示されています。このメタデータの不一致は、ユーザーエクスペリエンスを混乱させ、検索で無関係な情報を表示することでSEOに悪影響を与えます。

解決策

ページとレイアウト内でNext.jsのgenerateMetadata関数を使用します。このサーバーサイド関数は、langパラメータに基づいて正しい翻訳を読み込み(コンポーネントと同じ辞書読み込みロジックを使用)、ローカライズされたタイトルと説明を含む動的なmetadataオブジェクトを返すことができます。

手順

1. 辞書を読み込む関数を作成する

サーバー上でフラットな翻訳ファイルを読み込む方法が必要です。このためのヘルパー関数を作成します。

// app/get-dictionary.ts
import 'server-only';

type Messages = Record<string, string>;

const dictionaries: { [key: string]: () => Promise<Messages> } = {
  en: () => import('@/dictionaries/en.json').then((module) => module.default),
  es: () => import('@/dictionaries/es.json').then((module) => module.default),
};

export const getDictionary = async (lang: string) => {
  const load = dictionaries[lang];
  if (load) {
    return load();
  }
  return dictionaries.en();
};

2. ページでメタデータを定義する

ページファイル(例:app/[lang]/about/page.tsx)で、generateMetadataというasync関数をエクスポートします。Next.jsはページをレンダリングする際に自動的にこれを呼び出します。

// app/[lang]/about/page.tsx
import { getDictionary } from '@/app/get-dictionary';
import type { Metadata } from 'next';

type Props = {
  params: { lang: string };
};

// This function generates metadata
export async function generateMetadata({ params }: Props): Promise<Metadata> {
  // Load the dictionary for this page
  const dict = await getDictionary(params.lang);

  return {
    title: dict['about.title'], // e.g., "About Us" or "Sobre Nosotros"
    description: dict['about.description'],
  };
}

// The rest of your page component
export default function AboutPage() {
  return (
    <div>
      {/* Page content */}
      <h1>...</h1>
    </div>
  );
}

3. ルートレイアウトでタイトルテンプレートを設定する

すべてのタイトルでサイト名を繰り返さないようにするため、ルートレイアウトでテンプレートを設定できます。

// app/[lang]/layout.tsx
import { getDictionary } from '@/app/get-dictionary';
import type { Metadata } from 'next';

type Props = {
  params: { lang: string };
  children: React.ReactNode;
};

// You can generate metadata in layouts too
export async function generateMetadata({ params }: Props): Promise<Metadata> {
  const dict = await getDictionary(params.lang);

  return {
    // This provides a base title and a template
    title: {
      default: dict['site.name'], // e.g., "My Awesome Site"
      template: `%s | ${dict['site.name']}`, // e.g., "About Us | My Awesome Site"
    },
    description: dict['site.description'],
  };
}

export default async function RootLayout({ children, params }: Props) {
  // ... rest of your layout (loading providers, etc.)
  return (
    <html lang={params.lang}>
      <body>{children}</body>
    </html>
  );
}