# Fumadocs (Framework Mode, Waku): 国際化
URL: /ja/docs/waku/internationalization
Source: https://raw.githubusercontent.com/fuma-nama/fumadocs/refs/heads/main/apps/docs/content/docs/(framework)/[framework]/internationalization.ja.mdx

Wakuのドキュメントを多言語に対応させます。

<Callout title="Fumadocs CLI">
`npx @fumadocs/cli init --i18n` を実行すると、i18n に対応した新しいドキュメントをセットアップできます。手動で設定する場合は、以下の手順に従ってください。
</Callout>

## 概要 [#overview]

Waku と Fumadocs の両方で i18n ルーティングを設定します。

Fumadocs が担当するのは、ドキュメントのコンテンツとサイドバーの i18n です。アプリのその他の部分は、独自の i18n 設定で国際化してください。

## セットアップ [#setup]

i18n の設定をファイルに定義します。このガイドでは、`@/lib/i18n` としてインポートします。

```ts title="src/lib/i18n.ts"
import { defineI18n } from 'fumadocs-core/i18n';

export const i18n = defineI18n({
  defaultLanguage: 'en',
  languages: ['cn', 'en'],
});
```

> i18n の設定で使用できるオプションについては、[こちら](/docs/headless/internationalization/config)を参照してください。

### ルーティング [#routing]

すべてのページに `[lang]` プレフィックスを追加します。

<Files>
<Folder name="src/pages" defaultOpen>
<Folder name="[lang]" defaultOpen>
<File name="(home)/_layout.tsx" />

<File name="(home)/index.tsx" />

<File name="docs/_layout.tsx" />

<File name="docs/[...slugs].tsx" />
</Folder>

<Folder name="_api" defaultOpen>
<File name="api/search.ts" />
</Folder>
</Folder>
</Files>

### 翻訳 [#translations]

翻訳は `lib/layout.shared.tsx` で定義します。公式の言語パックなど、詳しくは[翻訳](/docs/ui/translations)を参照してください。

また、`baseOptions()` に `locale` パラメーターを追加すると、ロケールごとにレイアウトオプションを切り替えられます。

```tsx title="src/lib/layout.shared.tsx"
// [!code ++:2]
import { i18n } from '@/lib/i18n';
import { uiTranslations } from 'fumadocs-ui/i18n';
import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';

// [!code ++:11]
export const translations = i18n
  .translations()
  .extend(uiTranslations())
  .add({
    en: {
      displayName: 'English',
    },
    cn: {
      displayName: 'Chinese',
    },
  });

export function baseOptions(): BaseLayoutProps { // [!code --]
export function baseOptions(locale: string): BaseLayoutProps { // [!code ++]
  return {
    nav: {
      title: 'My App',
      url: `/${locale}`, // [!code ++]
    },
  };
}
```

翻訳を `<RootProvider />` に渡します。

```tsx title="src/components/provider.tsx"
'use client';
import type { ReactNode } from 'react';
import { RootProvider } from 'fumadocs-ui/provider/waku';
// [!code ++:4]
import { i18nProvider } from 'fumadocs-ui/i18n';
import { useRouter } from 'waku/router/client';
import { i18n } from '@/lib/i18n';
import { translations } from '@/lib/layout.shared';

export function Provider({ children }: { children: ReactNode }) {
  // パスの最初のセグメント [!code ++:2]
  const lang = useRouter().path.split('/')[1] || i18n.defaultLanguage;

  return <RootProvider>{children}</RootProvider>; // [!code --]
  return <RootProvider i18n={i18nProvider(translations, lang)}>{children}</RootProvider>; // [!code ++]
}
```

### ロケールを渡す [#pass-locale]

ページとレイアウトで、ロケールを Fumadocs に渡します。`[lang]` 配下のレイアウトとページは、ロケールを prop として受け取ります。

```ts tab="src/lib/source.ts"
import { i18n } from '@/lib/i18n'; // [!code ++]

export const source = loader({
  source: docs.toFumadocsSource(),
  baseUrl: '/docs',
  i18n, // [!code ++]
});
```

```tsx tab="Home Layout" title="src/pages/[lang]/(home)/_layout.tsx"
export default function Layout({ children }: { children: ReactNode }) { // [!code --]
export default function Layout({ lang, children }: { lang: string; children: ReactNode }) { // [!code ++]
  return <HomeLayout {...baseOptions()}>{children}</HomeLayout>; // [!code --]
  return <HomeLayout {...baseOptions(lang)}>{children}</HomeLayout>; // [!code ++]
}
```

```tsx tab="Home Page" title="src/pages/[lang]/(home)/index.tsx"
import { i18n } from '@/lib/i18n'; // [!code ++]

// ...

export async function getConfig() {
  return {
    render: 'static',
    staticPaths: i18n.languages, // [!code ++]
  };
}
```

```tsx tab="Docs Layout" title="src/pages/[lang]/docs/_layout.tsx"
export default function Layout({ children }: { children: ReactNode }) { // [!code --]
export default function Layout({ lang, children }: { lang: string; children: ReactNode }) { // [!code ++]
  return (
    // [!code highlight]
    <DocsLayout {...baseOptions(lang)} tree={source.getPageTree(lang)}>
      {children}
    </DocsLayout>
  );
}
```

```tsx tab="Docs Page" title="src/pages/[lang]/docs/[...slugs].tsx"
export default function Page({ slugs }: PageProps<'/docs/[...slugs]'>) { // [!code --]
export default function Page({ lang, slugs }: PageProps<'/[lang]/docs/[...slugs]'>) { // [!code ++]
  const page = source.getPage(slugs); // [!code --]
  const page = source.getPage(slugs, lang); // [!code ++]
  if (!page) unstable_notFound();

  // ...
}

export async function getConfig() {
  const pages = source
    .generateParams()
    .map((item) => (item.lang ? [item.lang, ...item.slug] : item.slug)); // [!code highlight]

  return {
    render: 'static',
    staticPaths: pages,
  } as const;
}
```

### 検索 [#search]

使用している検索ソリューションで i18n を設定してください。

* **組み込み検索:** [国際化](/docs/headless/search/orama#internationalization)を参照してください。
* **クラウドソリューション(Algolia など):** 多くの場合、多言語対応が公式にサポートされています。

## ドキュメントの作成 [#writing-documents]

特定のロケール向けのページを作成する方法については、[i18n ルーティング](/docs/waku/page-conventions#i18n-routing)を参照してください。

### ナビゲーション [#navigation]

Fumadocs がナビゲーションを処理するのは、Fumadocs 自身のレイアウト(サイドバーなど)のみです。

それ以外の場所では、パスからロケールを取り出し、リンクの先頭に付加してください。

```tsx
import { Link, useRouter } from 'waku/router/client';

const router = useRouter();
const lang = router.path.split('/')[1];

<Link to={`/${lang}/about`}>About Us</Link>;
```

[`fumadocs-core/dynamic-link`](/docs/headless/components/link#dynamic-hrefs) コンポーネントは動的な href に対応しているため、Markdown/MDX コンテンツ内でロケールのプレフィックスを付加する際に利用できます。

```mdx title="content.mdx"
import { DynamicLink } from 'fumadocs-core/dynamic-link';

<DynamicLink href="/[lang]/another-page">This is a link</DynamicLink>
```