日本語サイトに、あとから英語のページを増やす

既存の日本語記事を残し、翻訳の作成・公開・言語切り替えを順番に準備します。

目次

日本語の記事を残したまま、それに結び付く英語版を追加できます。 制作担当者が英語版の設定と表示ページを用意し、編集担当者が原稿を翻訳して公開します。

このガイドは、日本語の記事がjaという言語として保存されているサイトを例にします。jaは日本語、enは英語を表す短い識別名です。本文が日本語でも、保存上はenになっている場合は、先に日本語と言語設定の違いを確認してください。

言語の設定と、翻訳の作成は別の作業

使う言語を設定した後、編集担当者が英語版の原稿を作ります。言語を設定するだけでは、文章は自動翻訳されません。

まず、次のような対応表を作ります。URLは説明用の例です。

内容日本語英語
言語コードjaen
記事の住所/blog/coffee//en/blog/coffee/
公開するタイミング現在の公開を続ける翻訳を確認してから公開
翻訳がない場合日本語を表示日本語の案内を出すか、ページを用意しないか決める

設定は、コピーした環境で先に試す

先に確認用サイトを用意します。制作担当者が、そのプロジェクトをコードエディターで開き、package.jsonと同じ階層にあるastro.config.mjsの言語設定を編集します。次のコードは、日本語がすでに標準言語になっているサイトの、設定ファイルに加える部分だけを示しています。ファイル全体を置き換えず、既存の設定を残して編集します。

i18n: {
  defaultLocale: 'ja',
  locales: ['ja', 'en'],
},

標準言語にも/ja/を強制する設定は、EmDashの管理画面を開けなくする場合があります。接頭辞とは、URLの先頭側に付く/ja/や/en/の部分です。日本語の住所は今までどおりにし、英語の住所で英語版を表示するページもテーマ側に用意します。言語設定だけを追加しても、その表示ページまで自動でできるわけではありません。詳しくは公式の言語設定(別タブで開く)を確認します。

1本だけ、英語版を作る

  1. 管理画面で、元になる日本語の記事を開く。
  2. 開いた記事の設定パネルで、**Translations(翻訳)**を開く。サイト全体のSettingsではありません。
  3. 英語に対する**Translate(翻訳版を作る)**を選ぶ。
  4. コピーされたタイトル・本文を英語へ書き直す。スラッグ(URLに使う短い名前)も確認する。
  5. **Save(保存)**を選び、英語の下書きを確認する。

この操作で作るのは、元の記事と結び付いた下書きです。同じ内容を別の記事として新規登録するだけでは、翻訳同士の関係が作られません。

日本語と英語では、公開状態、予約日時、履歴を別々に持ちます。英語を準備中にして、日本語の公開を続けられます。

切り替えボタンは、公開済みの翻訳へつなぐ

制作担当者は、getTranslations()で翻訳の候補を調べられます。この取得結果には下書きも含まれるため、読者向けの言語切り替えには、公開済みでURLを作れるものだけを出します。

また、英語のスラッグをcoffee-toolsへ変えた場合、日本語のURLに単に/en/を付けるだけでは正しい住所になりません。英語版が実際に持つスラッグでリンクを作ります。

翻訳がないときの「代わり」は、何でも探せるわけではない

別の言語を代わりに表示する仕組みをフォールバックと呼びます。単一の内容を取得するときと一覧を取得するときでは、働き方が違います。一覧に日本語の記事を自動で混ぜるものではありません。

取得するIDやスラッグをそのまま使って、別の言語を探す仕組みです。英語のcoffee-toolsから、日本語のcoffeeを自動的に発見するとは限りません。表示用のコードでは、翻訳の組み合わせをgetTranslations()などで調べます。

本文のほかにも、翻訳する場所がある

メニュー、カテゴリ名、画像の説明、検索、共有時のタイトルも確認します。言語間で共有している入力欄や、関連する記事などの選択は、ほかの翻訳にも影響する場合があります。商品番号など共通にする値と、言語別に変える文章を先に決めましょう。

最初は1組だけで、次を確認します。

時点読者向け画面で確認すること
英語版が下書きの間日本語のURLと内容が変わっていない。未公開の英語版へ案内していない
英語版を公開したあと英語への切り替えで、対応する英語版へ進める
英語版から戻るとき対応する日本語版へ戻れる

この1組で確かめてから、ほかのページへ広げます。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。