日本語サイトに、あとから英語のページを増やす
既存の日本語記事を残し、翻訳の作成・公開・言語切り替えを順番に準備します。
目次
日本語の記事を残したまま、それに結び付く英語版を追加できます。 制作担当者が英語版の設定と表示ページを用意し、編集担当者が原稿を翻訳して公開します。
このガイドは、日本語の記事がjaという言語として保存されているサイトを例にします。jaは日本語、enは英語を表す短い識別名です。本文が日本語でも、保存上はenになっている場合は、先に日本語と言語設定の違いを確認してください。
言語の設定と、翻訳の作成は別の作業
使う言語を設定した後、編集担当者が英語版の原稿を作ります。言語を設定するだけでは、文章は自動翻訳されません。
まず、次のような対応表を作ります。URLは説明用の例です。
| 内容 | 日本語 | 英語 |
|---|---|---|
| 言語コード | ja | en |
| 記事の住所 | /blog/coffee/ | /en/blog/coffee/ |
| 公開するタイミング | 現在の公開を続ける | 翻訳を確認してから公開 |
| 翻訳がない場合 | 日本語を表示 | 日本語の案内を出すか、ページを用意しないか決める |
設定は、コピーした環境で先に試す
先に確認用サイトを用意します。制作担当者が、そのプロジェクトをコードエディターで開き、package.jsonと同じ階層にあるastro.config.mjsの言語設定を編集します。次のコードは、日本語がすでに標準言語になっているサイトの、設定ファイルに加える部分だけを示しています。ファイル全体を置き換えず、既存の設定を残して編集します。
i18n: {
defaultLocale: 'ja',
locales: ['ja', 'en'],
},標準言語にも/ja/を強制する設定は、EmDashの管理画面を開けなくする場合があります。接頭辞とは、URLの先頭側に付く/ja/や/en/の部分です。日本語の住所は今までどおりにし、英語の住所で英語版を表示するページもテーマ側に用意します。言語設定だけを追加しても、その表示ページまで自動でできるわけではありません。詳しくは公式の言語設定(別タブで開く)を確認します。
1本だけ、英語版を作る
- 管理画面で、元になる日本語の記事を開く。
- 開いた記事の設定パネルで、**Translations(翻訳)**を開く。サイト全体のSettingsではありません。
- 英語に対する**Translate(翻訳版を作る)**を選ぶ。
- コピーされたタイトル・本文を英語へ書き直す。スラッグ(URLに使う短い名前)も確認する。
- **Save(保存)**を選び、英語の下書きを確認する。
この操作で作るのは、元の記事と結び付いた下書きです。同じ内容を別の記事として新規登録するだけでは、翻訳同士の関係が作られません。
日本語と英語では、公開状態、予約日時、履歴を別々に持ちます。英語を準備中にして、日本語の公開を続けられます。
切り替えボタンは、公開済みの翻訳へつなぐ
制作担当者は、getTranslations()で翻訳の候補を調べられます。この取得結果には下書きも含まれるため、読者向けの言語切り替えには、公開済みでURLを作れるものだけを出します。
また、英語のスラッグをcoffee-toolsへ変えた場合、日本語のURLに単に/en/を付けるだけでは正しい住所になりません。英語版が実際に持つスラッグでリンクを作ります。
翻訳がないときの「代わり」は、何でも探せるわけではない
別の言語を代わりに表示する仕組みをフォールバックと呼びます。単一の内容を取得するときと一覧を取得するときでは、働き方が違います。一覧に日本語の記事を自動で混ぜるものではありません。
取得するIDやスラッグをそのまま使って、別の言語を探す仕組みです。英語のcoffee-toolsから、日本語のcoffeeを自動的に発見するとは限りません。表示用のコードでは、翻訳の組み合わせをgetTranslations()などで調べます。
本文のほかにも、翻訳する場所がある
メニュー、カテゴリ名、画像の説明、検索、共有時のタイトルも確認します。言語間で共有している入力欄や、関連する記事などの選択は、ほかの翻訳にも影響する場合があります。商品番号など共通にする値と、言語別に変える文章を先に決めましょう。
最初は1組だけで、次を確認します。
| 時点 | 読者向け画面で確認すること |
|---|---|
| 英語版が下書きの間 | 日本語のURLと内容が変わっていない。未公開の英語版へ案内していない |
| 英語版を公開したあと | 英語への切り替えで、対応する英語版へ進める |
| 英語版から戻るとき | 対応する日本語版へ戻れる |
この1組で確かめてから、ほかのページへ広げます。