日本語サイトと言語設定を整える

日本語の本文、管理画面の表示、記事の言語、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 に変えると、記事を探す条件と保存されたデータが合わなくなる可能性があります。

変更する前に、対象を整理します。

  1. 記事に記録されている言語と、公開状態を確認する。
  2. カテゴリ、メニュー、設定などにも言語別の情報がないか調べる。
  3. 変更前のデータと画像、必要な鍵を保存する。
  4. 複製した検証環境で、データの移し替えと表示確認を行う。
  5. URL、公開記事、下書き、変更履歴が意図どおり残るかを比べる。

既存データの変更手順は、サイトごとに制作担当者が決めます。設定や項目の変更と同様に、先に何をバックアップし、問題があればどう戻すかを決めて進めてください。

翻訳版は、別々の公開状態を持つ

複数言語では、日本語記事と英語記事を関連付けて扱います。それぞれが別の本文、スラッグ、公開状態、履歴を持ちます。

たとえば日本語を公開し、英語を翻訳中の下書きにできます。片方を公開したら、すべての言語も公開になるという意味ではありません。

翻訳がないときに別の言語へ戻る仕組みを「フォールバック」と呼びます。単一記事の取得と、記事一覧の取得では扱いが違うので、言語が混じる原因を探す際にも区別します。

最後に確認する画面

日本語の記事を作成し、保存した言語、管理画面での再編集、記事一覧、記事詳細、検索を確認します。カテゴリやメニューのリンク先も、意図した言語へ進むかを見ます。

日本語の記事を書き、記事一覧や検索から探して開き、読めるところまで確認します。 それぞれで意図した言語が使われているかを確かめてください。

公式の参照元

関連ガイド

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

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