mozilla
Your Search Results

    MDN 技術ドキュメントの翻訳について

    このページでは、MDN にある技術ドキュメント (以下、MDN ドキュメント) の翻訳手順についての情報を提供します。MDN ドキュメント翻訳に特有な作業手順の解説の他に、翻訳作業時に有用な Tips、翻訳作業中に困ったときの相談先などを紹介します。

    Note:このページは日本語版独自です。基本的な手順は英語版の翻訳であるMDNページの翻訳をご覧ください。日本語版での作業で相談がある場合は、Mozilla 翻訳グループ へお願いします。このページの内容は、古くからあるページ(Firefox OS より以前)を更新、翻訳するときには役に立つかもしれません。日本語版独自の手順、案内などについては、翻訳版に足すか、別ページにまとめて翻訳版からリンクする予定です。

    注意:新システム(Kuma)への移行にともない、以前と翻訳手順が変わっています。「翻訳作業の DekiWiki からの変更点」を参照してください。

    翻訳作業手順のアウトライン

    翻訳するドキュメントを決めた後のおおまかな翻訳作業手順は以下の通りです。

    1. 英語版から新しい日本語版ページを作る
    2. 英語版ドキュメントを翻訳する

    英語版から新しい日本語版ページを作る

    注意:現在、言語間リンクが正しく移植されていないページがあります。新規翻訳の際は、日本語版が存在していないか先に確認してください。

    新規翻訳の開始方法には次の二通りの方法があります。

    • 英語版の languages メニューの "add translation" を選び、言語リストから日本語を選択する
    • 存在しない日本語版のページを開いたときにヘッダに表示される "是非 MDN に登録し、私たちの力になって下さい。" のリンクテキストをクリックする

    翻訳は、専用の 2 ペインの編集画面で行います。右側の編集可能エリアを翻訳してください。ページ上部のボタンから保存やプレビューが行えます。

    英語版ドキュメントを翻訳する

    Noteethertank さんによる MDN Code Cleaner という編集作業支援ツール(Web 上で実行可能)があります。以下では翻訳するときの基本的な作業を説明しています。

    翻訳開始時の編集エリアは、英語版ドキュメントがそのままコピーされた状態なので、ドキュメント内の他の MDN ドキュメントへのリンクを英語版から日本語版に置き換える必要があります。リンクを編集(リンク上を右クリックしてコンテキストメニューから、または、リンク上で Ctrl + K)し、英語版(/en-US/docs/ページ名、古いページの場合、/en/ページ名)から、日本語版(/ja/docs/ページ名)へのリンクに変更してください。

    Tips: リンクが多く存在する場合、テキストエディタを用いたソースコードの一括置換により、迅速な作業が可能です。編集エディタの Source ボタンを押すとソースを表示できます。それを一旦テキストエディタにコピー & ペーストし、href="/en/href="/ja/docs/ に、href="/en-US/href="/ja/に一括置換するなどの操作を行ってください。文書の状態によっては、この方法が完全でない場合もあります。

    外部の英文のサイトに該当する日本語訳ページが存在する場合は、「Mozilla Firefox 3.5 Release Notes日本語訳)」のような形で追加してください。

    各セクション毎へのリンク(ページ内リンク)はセクション名を日本語に訳した場合、通常は、保存時に URL エンコーディングされた id 属性の値が自動的に生成されます。ソースモードで見出し要素の id 属性の値と同じ値を持つ name 属性を追加すると、 保存後のセクションの id 属性の値をその値にすることができます。この方法を用いることで、セクション名が日本語になっている場合でも、英語版のセクション名のままリンクすることができます。

    「原語併記」テンプレートなど、日本語版には翻訳用のテンプレートがいくつか用意されています。カスタムテンプレートのページを参照してください。

    Tips: 翻訳途中のページを保存する際には、「翻訳中」テンプレートが有用です。{{translationinprogress}} というコードをページの冒頭に貼り付けてください。

    その他の作業方法や Tips

    ページの移動方法

    MDN 日本語版は、基本的にロケール部分を除いて原文と URL を揃えています。原文の URL 変更や、新規翻訳時のスラッグ設定ミス等により、ページ移動が必要になることがあります。ページ移動の機能は現在、権限を与えられた貢献者のみが行う事が出来ます。権限が付与されている場合、ページ右上の「このページ」のドロップダウンより、「このページを移動」を押下し、ページ移動専用の編集画面でかかる操作を行う事ができます。

    新システム Kuma ではリダイレクトの設定方法が変更されています。『リダイレクト - Kuma 入門 | MDN 』を参照して下さい。

    オンラインエディタの使い方

    有用な Tips を『編集エディタ利用時の Tips 』にまとめています。他にも Tips があれば自由に追記してください。WYSIWYG エディタでは細やかな編集は行えないのため、「ソース」ボタンを押下してのソース直接編集が多くなるでしょう。その場合、使い慣れたエディタにソースをコピーして編集するのもいいでしょう。

    記事の更新について

    フィードリーダーでフィードを購読し、原文の更新内容などを追跡する事が出来ます。『Feeds | MDN』で MDN のフィード取得用 API について解説されています。任意のフィードの形式、対象言語などでフィードを取得可能です。

    困ったときは / レビュー依頼

    困ったときや翻訳レビュー依頼(レビュー依頼は必須ではありません)は、 Mozilla 翻訳グループ へ投稿ください。

     

    ドキュメントのタグと貢献者

    タグ: 
    Contributors to this page: Taken, Morishoji, ethertank, Shimono, RxOrca, Potappo, Btm, Okome
    最終更新者: Potappo,