EmDashで日本語サイトを作る時、フォント・URL・管理画面で注意することは?

結論

管理画面は設定画面から日本語に切り替えられます。ただ、まだ訳されていない項目は英語で表示されます。公開サイトの日本語フォントはテンプレート側で自分で設定し、URLのスラッグは英数字でそろえるほうが扱いやすいでしょう。

EmDashへの移行更新日

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 プロジェクトの公式サイトではないと書いています。あくまで非公式の訳なので、設定の書き方や手順で迷った時は英語の原文も開いて見比べてください。

こんな聞き方も

  • EmDashのサイトで日本語フォント(Noto Sans JPなど)を使うにはどうしますか?
  • EmDashの日本語ドキュメントや解説はありますか?
  • EmDashで困った時に日本語でサポートを受けられますか?
  • EmDashのエディタで日本語入力(IME)は問題なく使えますか?
  • EmDashの管理画面を日本語に切り替えるにはどうしますか?
  • EmDashの日本語訳が不完全で英語が混ざる時はどうすればいいですか?
  • EmDashのGitHub Issueに日本語で質問してもいいですか?
  • EmDashの日本語解説はQiitaやZennにありますか?
  • emdash 日本語
  • emdash 管理画面 日本語化

あわせて知りたい(関連する疑問)

QEmDashのエディタで日本語入力(IME)は問題なく使えますか?

日本語で記事を書く人がまず気にするのは、変換の途中で文字が消えたり、確定した文字が二重に入ったりしないかでしょう。EmDashの公式リポジトリにあるとおり、EmDashの本文エディターは TipTap という編集の仕組みを使い、本文を Portable Text という形式で保存しています。

この TipTap には、日本語入力の不具合が過去に報告されています。Tiptap 2.4.0の報告は、複数行を選んだ状態で日本語を打とうとすると、IMEで入力できなくなるというものでした。報告はTiptap 2.4.0についてのもので、いまのEmDashでも同じことが起きるとは限りません。一方で、日本語IMEでの動作を約束した説明もないため、本番の記事を書き始める前に手元で試すのがいちばん早いです。

試す操作は次のとおりです。

  • 文章を変換して確定する
  • 確定した直後に改行する
  • 見出しブロックの直後に続けて入力する
  • 複数行を選んだ状態で日本語を打つ
  • 段落の横の追加ボタン、または「/」を打ってブロックを入れた直後に入力する

「/」はブロック名を検索して挿入する操作なので、日本語の変換中に「/」を打った時の動きもあわせて見ておきます。

QEmDashのGitHub Issueに日本語で質問してもいいですか?

英語が苦手で、GitHubに日本語で書いて大丈夫か迷う人は多いと思います。日本語で書いてよいかは、EmDashの規則からは読み取れません。許可するとも禁止するとも書かれていないためです。

ただ、プロジェクトの正式な貢献方針を定めたドキュメントであるCONTRIBUTING.mdを確認すると、疑問点の質問や機能の提案はDiscussionsへ、明確な不具合の報告はIssuesへと役割が明確に分けられています。公式サイトのFAQは Issue も質問先に挙げていますが、「使い方がわからない」という相談なら Discussions のほうが合っています。

英語での記述に不安がある場合、翻訳ツールの活用が現実的な選択肢。英語の文章づくりについては、AI利用の方針で、自分で書いた文章のつづりや文法、翻訳を手伝ってもらうことはどこでも認められています。ただし、手伝いが文章の書き直しにまで広がるのはだめです。自分の言葉で日本語の文を書き、翻訳ツールで英語にして投稿する使い方なら、この範囲に収まりますね。

もうひとつ、画面のことを書く Issue には、その状態を写したスクリーンショットを付ける決まりがあります。英語の説明が短くても、画像があれば何が起きているかは伝わります。

QEmDashで困った時、日本語で相談できるところはありますか?

導入作業や日々のサイト運用で行き詰まった際、日本語で相談に応じてもらえる場所はあるのでしょうか。公式の案内では、EmDashの公式サイトのFAQが、開発チームやコミュニティと話せる Discord と、GitHub の Issue を質問先に挙げています。どちらも日本語専用の窓口ではなく、日本語で返事が来るとも書かれていません。Cloudflare の紹介記事には emdash@cloudflare.com という連絡先も載っていますが、プロジェクトへの要望を伝えるための宛先で、使い方の質問に答える窓口ではありません。

仕様や不具合の確認は、英語で Discord や GitHub に送ることになるでしょう。日本語で読める資料なら、先に挙げたEmDash情報局の訳があります。

QEmDashの管理画面だけ英語のままにできますか?

管理画面のメニューや設定項目は、公開するWebサイトが日本語であっても英語のまま保持できます。EmDashでは、一般の読者が目にする公開コンテンツの言語設定と、運用者が操作する管理画面の言語設定が完全に切り離されています。公開側の言語振り分けやURLルーティングは基盤であるAstroの多言語機能が制御し、管理画面側の表示言語はブラウザー側のCookieを使って個別に制御されているからです。

管理画面の言語を英語に保ちたい時は、管理画面内のSettingsページから言語設定を開き、一覧から「English」を選択します。言語を切り替える処理を見ると、選んだ言語はブラウザーの emdash-locale という Cookie に入ります。ここで注意しておきたいのは、この設定がユーザーアカウントのデータベースに紐づくのではなく、あくまで端末のブラウザー環境に保存される点です。同じパソコンの同じブラウザーを複数の担当者で共有している場合は、1人が言語を切り替えると他の人にも同じ言語設定が反映されてしまいますね。別のパソコンやブラウザーからログインした時は、もう一度選び直すことになるでしょう。

さらに、プロジェクトの設定ファイルで管理画面の表示言語を制御するadmin.localesを指定している環境でも、英語は常に利用できます。設定ファイル側で言語の候補を限定したとしても、英語である「en」はフォールバック言語として自動的に含まれる仕様になっています。そのため、設定によって英語の選択肢が塞がれてしまう心配はありません。チームの中で日本語と英語を使い分けたい時は、admin.locales に ja を残したまま、それぞれのブラウザーで切り替えてもらう形になります。

出典

この内容をChatGPTで相談

無料診断