MDN Web Doc 翻訳のご紹介

はじめに

この記事は 2023 年の MDN 翻訳 Advent Calendar 向けに作成したものです。

MDN Web Docs とは？

• MDN Web Docsは、ウェブ標準 及び Mozilla プロジェクトの開発文書のための Mozilla の公式ウェブサイトです。
• 2017年 に MDN Web DocsはGoogle、サムスン電子、 Microsoft 及び Mozilla のウェブ技術の統一文書となった Microsoft は MSDN から MDN へのページのリダイレクトを開始しました。
• MDN Web Docs from wiki

MDN Web Doc のあゆみ

以下翻訳エンジンのコードネームでの変遷になります。

• Netscape DevEdge
  • MediaWiki 最初の Wiki エンジン
• DekiWiki
  • 2 つ目の Wiki エンジン
• Kuma
  • 3 つ目の Wiki エンジン
• Yari
  • 現在のMDN Webドキュメントプラットフォーム
  • Wiki ベースの編集から Github, MarkDown 形式 編集へ変更

現在の Yari になり、格段に作業効率が向上しました。

MDN Web Doc 翻訳を始めるには？

• 2023.04.09 に「MDN 月例ミートアップ - 翻訳ガイド」が公開されました。
• 基本的には上記翻訳ガイドの沿って、翻訳を行います。

MDN Web Doc 翻訳の流れ

1. 準備するもの
   • GitHub アカウントの用意
   • Node.js / Yarn のインストール
2. 記事を選定する
3. 作業を宣言する
4. fork リポジトリを用意する
5. fork リポジトリを clone する
6. 日本語記事ページを新規作成する
7. 日本語記事ページを編集する
8. Pull Request を作成する
9. レビューで、修正事項があったら対応
10. レビューが approve(承認) されたら、翻訳記事がマージされます。
11. 全世界に翻訳記事が公開されます。

箇条書きで、翻訳するプロセスを紹介しました。
上記に記載されているリポジトリについては、以下をご覧下さい。

リポジトリ

上記 MDN Web Doc 翻訳の流れで、見る・使うリポジトリは下記の通りです。

1. 日本語の翻訳状況を管理・把握するリポジトリ
   • https://github.com/mozilla-japan/translation
2. 原文（英語）リポジトリ
   • https://github.com/mdn/content
3. 各言語翻訳リポジトリ
   • https://github.com/mdn/translated-content

L10N ガイドライン

翻訳するにあたり、様々なルールがあります。

• 表記ガイドライン
• L10N ガイドライン
• Mozilla 用語集
• 日本語の文体

最初から上記ガイドラインを網羅して、完璧にこなせる方はいません
まずは気軽に参加してみて、翻訳の流れを一緒にやってみませんか？

Mozilla Japan コミュニティ 参加希望の方は、下記のいずれからご参加下さい

※MDN Web Docs 翻訳コミュニティは、Mozilla Japan コミュニティのグループです。

• slack: https://mozillajp.slack.com
  • slack 参加後に #translation チャンネルにご参加下さい
• Door Keeper: https://mozilla.doorkeeper.jp/
  • 直近ミートアップイベント
    • https://mozilla.doorkeeper.jp/events/166059

MDN Web Doc 翻訳コミュニティは、英語に興味のある方、翻訳に興味のある方大歓迎です。
よろしくお願い申し上げます。