日本語サイトと言語設定を整える
日本語の本文、管理画面の表示、記事の言語、URLの言語設定を分けて考えます。新規サイトと既存サイトで確認すべき点も説明します。
目次
日本語サイトを作るとき、「日本語にする」と言っても、設定する対象はいくつかあります。日本語で記事を書くこと、画面の文字を日本語にすること、記事の言語を登録することは、それぞれ別です。
メニューやボタンだけを日本語にしたい場合は、管理画面を日本語に切り替えるへ進んでください。記事の言語やURLを変更する作業は必要ありません。
まず、どの日本語の話かを分ける
| 対象 | 例 | 確認する場所 |
|---|---|---|
| 本文の言語 | 記事を日本語で書く | 記事の内容 |
| 管理画面の表示言語 | ボタンやメニューの言語 | 管理画面で利用できる言語設定 |
| 記事のロケール | この原稿は ja の記事と記録する | 保存されている記事の言語 |
| URLの言語 | 日本語は通常のURL、英語は /en/ など | Astroで使う言語と、URLごとに表示するページの設定 |
ロケールは、ここでは記事や表示に使う言語の区分です。日本語は ja、英語は en といった識別名を使います。
日本語の文章を入力できても、記事の言語データが ja になっているとは限りません。
新しく作るサイトの言語を決める
ここからはサイトを作る人が設定ファイルを編集します。記事を書く人は、管理者が用意した日本語の記事を選んで入力します。ファイル操作が初めてなら、ファイル編集の練習を先に進めてください。
まず、日本語だけで使うか、複数言語を使うかを決めます。EmDashはAstroの i18n 設定から、使う言語、標準の言語、代わりに表示する言語の関係を読み取ります。
i18n は「国際化」を表す略し方です。ここでは「複数の言語を扱うための設定」と読んでください。
日本語だけを明示する場合、既存の astro.config.mjs の defineConfig() に渡す設定へ、次の項目を加える形を検討できます。これは追加する項目の抜粋です。EmDashやデータベースの設定を、この短い例で丸ごと置き換えないでください。
i18n: {
defaultLocale: 'ja',
locales: ['ja'],
},何も設定しない場合の単一言語動作と、言語を明示した動作は、公式の言語設定(別タブで開く)を確認して選びます。本文を日本語で書くだけなら、まず記事の本文欄に日本語を入力します。言語を管理する設定も変える必要があるかは、制作担当者と確認してください。
標準の言語にURLの接頭辞を強制しない
「日本語だから、すべてのURLを /ja/ から始めたい」と考えることがあります。しかし、標準言語のURLにも必ず /ja/ などを付けるAstroの設定は、EmDashの管理画面のURLを壊す場合があります。
公式資料では、prefixDefaultLocale: true や prefix-always を避け、標準言語のURLには /ja/ などを付けない設定を使うよう説明しています。管理画面は /_emdash/admin/ にあるためです。
/ja/_emdash/admin/ を手入力すれば直る、という問題ではありません。設定変更後は、通常ページだけでなく管理画面の入口も確認します。
既存の記事があるサイトは、設定変更だけで終わらない
すでに en などで記事を保存しているサイトで、標準言語だけを ja に変えると、記事を探す条件と保存されたデータが合わなくなる可能性があります。
変更する前に、対象を整理します。
- 記事に記録されている言語と、公開状態を確認する。
- カテゴリ、メニュー、設定などにも言語別の情報がないか調べる。
- 変更前のデータと画像、必要な鍵を保存する。
- 複製した検証環境で、データの移し替えと表示確認を行う。
- URL、公開記事、下書き、変更履歴が意図どおり残るかを比べる。
既存データの変更手順は、サイトごとに制作担当者が決めます。設定や項目の変更と同様に、先に何をバックアップし、問題があればどう戻すかを決めて進めてください。
翻訳版は、別々の公開状態を持つ
複数言語では、日本語記事と英語記事を関連付けて扱います。それぞれが別の本文、スラッグ、公開状態、履歴を持ちます。
たとえば日本語を公開し、英語を翻訳中の下書きにできます。片方を公開したら、すべての言語も公開になるという意味ではありません。
翻訳がないときに別の言語へ戻る仕組みを「フォールバック」と呼びます。単一記事の取得と、記事一覧の取得では扱いが違うので、言語が混じる原因を探す際にも区別します。
最後に確認する画面
日本語の記事を作成し、保存した言語、管理画面での再編集、記事一覧、記事詳細、検索を確認します。カテゴリやメニューのリンク先も、意図した言語へ進むかを見ます。
日本語の記事を書き、記事一覧や検索から探して開き、読めるところまで確認します。 それぞれで意図した言語が使われているかを確かめてください。