EmDashの管理画面を日本語に切り替えるにはどうしますか?
管理画面のメニューや設定項目を日本語で操作するには、どこを変更すればよいのでしょうか。実際の切り替え作業は、管理画面内のSettingsページで行います。設定画面に用意された言語選択の項目から日本語を選ぶと、即座に画面のラベルや各メニューの表記が切り替わります。日本語は言語の一覧に「日本語」(コードは ja)として最初から登録されているので、別に何かを入れる必要はありません。
ただし、一覧に日本語が出てこないこともあります。EmDash 1.2.0で、管理画面に組み込む言語を絞れる admin.locales という設定が加わりました。ここに書いた言語だけが切り替えの選択肢になり、英語はいつでも含まれます。何も書いていなければ、これまでどおりすべての言語が残ります。
制作会社やテンプレートから引き継いだサイトで日本語が見つからない時は、設定ファイルの admin.locales を開いてみてください。en や別の言語だけが並んでいて ja がなければ、そこに ja を足してビルドし直すと選べるようになります。
切り替えたあとは、記事の一覧や編集画面など、ふだん使う画面を一度ひととおり開いて表示を見てください。英語のまま残っている所があれば、この時点で目に入ります。
EmDashの日本語訳が不完全で英語が混ざる時はどうすればいいですか?
たとえば、メニューは日本語なのに、設定画面の説明文やエラーの文言だけが英語で出てくる。EmDashの管理画面では、こうした混ざり方が起きます。翻訳ファイルで訳文の欄(msgstr)が空のままの項目は、未翻訳として英語で表示されるためです。
公式翻訳ダッシュボードの数値を見ると、日本語は全3,520項目中2,896項目が翻訳済みとなっており、進捗率は82%で、未翻訳の項目が624項目存在しています。
もし業務で頻繁に使う項目の英語表記が気になるなら、自分で翻訳を追加して公式リポジトリへ貢献する手段が用意されていますね。公式の翻訳追加手順では、対象言語のPOファイルを編集し、ローカルで実際に動いている管理画面でレイアウト崩れなどがないかを確認したうえで、mainブランチ宛てにプルリクエストを送信します。すべての未翻訳項目を一気に埋める必要はなく、部分的な翻訳の提案も受け付けられています。過去の変更履歴でも、日本語管理画面における「ブラウザ」「エディタ」という表記を「ブラウザー」「エディター」に統一する修正が取り込まれていました。
もうひとつ気をつけたいのが、AIで作った訳の扱いです。AIを活用して翻訳文を作成して提出する際は、その言語に堪能な人物が全項目を精査し、動作中の管理画面で正しく表示されるか確かめなければなりません。監督者の確認がない機械翻訳の出力は受け付けられない規定となっています。
EmDashのサイトで日本語フォント(Noto Sans JPなど)を使うにはどうしますか?
公開サイトの文字を読みやすい日本語書体で整えるには、どのような手順でフォントを設定すればよいのでしょうか。EmDashのフロントエンド側でWebフォントを適用する場合、利用しているテンプレートや基盤となるAstroの設定を直接編集します。たとえば公式のmarketingテンプレートでは、astro.config.mjs内のfonts項目に読み込みたいフォントを定義します。Astroのフォント設定案内に示されている通り、定義したフォントはページのhead要素内にFontコンポーネントとして挿入され、CSS変数経由で全体の装飾に反映される仕組みです。
一般的なGoogle Fontsを利用してNoto Sans JPなどを導入したい時は、HTMLのhead内にフォント用のスタイルシートリンクを追加し、CSSのfont-familyで指定する方法も取れます。その際、CSSの末尾にはsans-serifなどの代替フォントを必ず添えておきます。
ただ、気をつけたいのは読み込みの重さです。Webフォントは表示速度に響き、読み込むフォントを増やすほどページの表示が遅くなることがあります。Astroでは使う太さやスタイルを指定できるので、実際にページで使う太さだけを読み込むようにしましょう。
もし外部フォントを読み込まず端末のシステムフォントで軽快に表示させたい場合は、marketingテンプレートのtheme.cssにある--font-bodyや--font-headingの変数を上書きします。
ちなみに、EmDashの設定にも fonts という項目がありますが、こちらは管理画面用です。scripts に japanese を加えると管理画面の日本語の書体を補え、false にするとフォントの読み込みをやめてシステムフォントで表示します。名前が同じでも公開サイトの設定とは別の場所です。
EmDashで日本語のURL(スラッグ)は使えますか?
「音楽」や「お知らせ」のような日本語のタイトルで記事を作り、スラッグを自動で入れてもらうと、空欄になってしまうことがありました。EmDash 0.31.1で、日本語だけのラベルからスラッグを作ると空文字になる不具合がGitHubのIssueで報告され、0.32.0でも再現しています。Issueはすでに閉じられていますが、使っている版で同じことが起きないか、試しに記事を1本作って見るのが早いです。
日本語のスラッグを手で入れたとしても、URLの中では日本語は %E3… のような記号の並びに置き換えられます(パーセントエンコード)。リンクの href に書く時も、日本語などの非ASCII文字はエンコードするのが決まりです。コピーした時やSNSに貼った時の見え方は環境によって変わるので、英数字のスラッグにしておくほうが扱いに困りにくいでしょう。
Studioから移ってくる場合は、スラッグの扱いがもう少しややこしくなります。Studioの仕様に目を向けると、スラッグの案内には半角英数字とハイフン、アンダーバーのみ入力可能という記述と、日本語や記号も技術的には使用可能という記述の双方が並んでいます。さらに、Studioの公開URLは動的ページのパスと各記事のスラッグを組み合わせた形です。移行前に、旧URLと新URLの対応表を作ってから作業に入りましょう。
EmDashの日本語ドキュメントや日本語サポートはありますか?
CMSの仕様を調べたりセットアップ手順を確認したりする際、日本語で読める公式の手引や問い合わせ窓口はあるのでしょうか。EmDashの公式READMEや公式入門ドキュメントは、基本的に英語で提供されています。EmDash 1.0 の公開は2026年9月28日です。
日本語で読みたい人には、EmDash情報局があります。公式ドキュメント94ページを日本語に訳して公開していて、並び順も公式のサイドバーと同じです。英語の原文と行き来しながら読めるので、設定名を探す時にも使いやすいですね。
ただ、このサイトは自ら、Cloudflare や EmDash プロジェクトの公式サイトではないと書いています。あくまで非公式の訳なので、設定の書き方や手順で迷った時は英語の原文も開いて見比べてください。