MDN Web Docsをスペイン語に翻訳する方法

こんにちは！ドキュメントを様々な言語に翻訳することは、これまで以上に重要になっています。スペイン語を話すWeb開発者が増える中、最新のリソースにアクセスできるようにすることは不可欠です。この記事では、これらのリソースをよりアクセスしやすくすることを目的とした最近の取り組みに基づいて、MDN Web Docsをスペイン語に翻訳するプロセスをご案内します。

MDN Web Docsを理解する

MDN Web Docsは、HTML、CSS、JavaScriptなどのWeb技術を文書化した人気のあるプラットフォームです。これはオープンソースプロジェクトであり、誰でも貢献することができます。2026年5月の時点で、MDNには英語で約14,000ページが含まれており、スペイン語を含む複数の言語で翻訳が提供されています。この取り組みは、世界中の開発者をサポートするための幅広い努力の一環です。

なぜMDN Web Docsを翻訳するのか？

MDN Web Docsのスペイン語版は、英語版ほど頻繁には更新されていません。このドキュメントを翻訳することで、スペイン語を話す開発者が最新情報にアクセスし、スキルを向上させる手助けができます。この取り組みは個人に利益をもたらすだけでなく、グローバルな開発者コミュニティを強化します。

はじめに

ステップ 1：ガイドラインに慣れる

翻訳を始める前に、MDNの執筆および翻訳ガイドラインを理解することが不可欠です。これらのガイドラインは、ドキュメントの一貫性と品質を保証します。主要なリソースは以下の通りです：

• 執筆ガイドライン：これらは、何をドキュメント化するか、そしてどのように書くかを網羅しています。
• MDN ページの翻訳：このガイドは、コンテンツを翻訳するためのステップバイステップのプロセスを提供します。

ステップ 2：開発環境をセットアップする

貢献するためには、開発環境をセットアップする必要があります。その方法は以下の通りです：

1. リポジトリをフォークする： mdn/translated-content の個人的なコピー（GitHub上のリポジトリ）を作成します。

2. リポジトリをクローンする：Gitを使用してローカルマシンにリポジトリをダウンロードします。これは次のコマンドで実行できます：

   git clone https://github.com/YOUR_USERNAME/translated-content.git

3. 必要なツールをインストールする：テキストエディタ（Visual Studio Codeなど）とGitがコンピュータにインストールされていることを確認してください。

ステップ 3：コンテンツを翻訳する

翻訳する際は、以下のベストプラクティスに従ってください：

• ファイルパス：ファイルパスは翻訳しないでください。これらはすべての言語で同じままである必要があります。
• フロントマター： title と short-title フィールドを翻訳し、 slug と l10n.sourceCommit フィールドは変更しないでください。
• リンク：内部リンクの場合、ロケールのプレフィックスを /en-US/ から /es/に変更します。外部リンクは変更しないでください。
• テキストのフォーマット：太字や斜体のテキストの元のフォーマットは保持してください。
• 画像：スペイン語のフォルダに画像をコピーしないでください。ビルドプロセスが英語のフォルダからそれらを取得します。代替テキストのみを翻訳してください。
• コールアウト： [!NOTE] や [!WARNING]などのコールアウトマーカーは翻訳せず、その中のコンテンツのみを翻訳してください。

ステップ 4：コミュニティと関わる

MDN Web Docsには活発な貢献者コミュニティがあります。このコミュニティと関わることで、サポートを得たり、翻訳の取り組みを向上させたりすることができます。MDNコミュニティポータルを通じて、ディスカッションを見つけたり他の貢献者と繋がったりすることができます。

ステップ 5：貢献を提出する

コンテンツを翻訳した後、GitHubのプルリクエスト（PR）を通じて変更を提出します。マージする前に、PRがMDNの貢献ガイドラインに従っており、すべてのチェックに合格していることを確認してください。

結論

MDN Web Docsをスペイン語に翻訳することは、開発者コミュニティに貢献する価値のある方法です。これらのステップに従うことで、スペイン語を話す開発者にとってWeb開発リソースをよりアクセスしやすくする手助けができます。

メリット

• スペイン語を話す開発者に最新のリソースを提供します。
• グローバルな開発者コミュニティを強化します。
• コラボレーションとオープンソースへの貢献を促進します。

デメリット

• 高品質な翻訳を保証するために時間と労力を要します。
• 英語版が変更されるのに伴い、継続的な更新が必要になる場合があります。

注意

この記事は教育目的で書かれています。貢献する際は、プレースホルダーの値を実際のコンテンツに置き換えることを忘れないでください。情報に依存する前に、常に元のソースと照らし合わせて確認してください。

よくある質問

• MDN Web Docsに貢献するにはどうすればよいですか？ — 提供されているガイドラインに従って、既存のドキュメントを翻訳したり新しいドキュメントを作成したりすることで貢献できます。
• MDN Web Docsを翻訳するにはどんなツールが必要ですか？ — 貢献を管理するために、コンピュータにテキストエディタとGitがインストールされている必要があります。
• 翻訳に関する特定のガイドラインはありますか？ — はい、一貫性を保つため、MDNには詳細な執筆および翻訳ガイドラインがあります。
• ドキュメント内の画像を翻訳してもよいですか？ — いいえ、画像をコピーしないでください。代替テキストのみを翻訳してください。
• 内部リンクはどうすればよいですか？ — 内部リンクの場合、ロケールのプレフィックスを /en-US/ から /es/ に変更してください。
• 翻訳を提出するにはどうすればよいですか？ — ガイドラインを満たしていることを確認した後、GitHubのプルリクエストを通じて翻訳を提出してください。

タグ

#mdn #translation #opensource #webdevelopment #documentation #spanish #programming #community #contribution #guidelines