チュートリアル / 技術ドキュメント
MDNの英語技術ドキュメントを対訳読書
LangBox ·
MDN の「What is JavaScript?」ページの実際の文を例に、Web ページの対訳表示とダブルクリック辞書を使って開発者向けドキュメントを英語で読む手順を解説します。
読む前の準備
- 下記の MDN ドキュメントへのリンク。ページが更新される場合があるため、冒頭の「implement complex features」を含む文を今回の教材として使用します。
MDN のページを LangBox で読む手順
Append 翻訳をオンにして MDN の記事を開く
デスクトップ版 Chrome で MDN の「What is JavaScript?」ページを開き、英語の段落の下に翻訳が表示されるよう Append 翻訳を有効にします。
「implement」をダブルクリックして意味を比較
「allows you to implement complex features on web pages」の中の「implement」をダブルクリックし、名詞ではなく「実装する・構築する」という意味の動詞であることを確認します。
英語の原文を読み直し、重要表現をメモ
翻訳に頼らずにもう一度英語の原文を読み、「implement features」のような役立つ「動詞+名詞」のコロケーションを復習用に記録します。
技術ドキュメントを読む際の注意点
- 開発者向けサイト上で実際にこの手順を行うには、デスクトップ版 Chrome の LangBox 拡張機能が必要です。本ページの解説枠は説明用のサンプルであり、実際のスクリーンショットではありません。
- API の識別子、変数名、コードの構文は翻訳された用語に頼らず、元の英語のまま把握するようにしてください。
- 翻訳や辞書のメモは読解の補助です。コマンドやコードを使用する前には、必ず公式ドキュメントの原文をご確認ください。
原文と読解ノート
JavaScript is a scripting or programming language that allows you to implement complex features on web pages […]
JavaScript は、Web ページ上で複雑な機能を実装できるようにするスクリプト言語またはプログラミング言語です。
原文の抜粋は MDN contributors によるもので、CC BY-SA 2.5 の下で提供されています。本ページの訳文および構文解説は編集部が作成したものであり、同一のライセンス下で提供されます。 MDN · CC BY-SA 2.5
- a scripting or programming language
- JavaScript がどの分類の言語かを説明しています。or で結ばれているのは 2 通りの表現であり、2 つの異なる製品を並べているわけではありません。
- that allows you to…
- 直前の language を修飾し、その言語によって何ができるようになるかを説明しています。まず主節の骨格を把握してから、後ろに続く機能の説明を読み解きます。
- implement complex features
- 「複雑な機能を実装する」の意。ここでの implement は動詞です。技術ドキュメントにおける features は人の特徴ではなく「機能」を指します。
読み終わったあとの確認(2 問)
この文は JavaScript の用途を説明していますか? それともインストール手順を説明していますか?
解答例を確認する
用途を説明しています。JavaScript を言語として定義し、Web ページ上で複雑な機能を実装するために使えることを示しています。
辞書に implement の名詞の意味が載っていた場合、そのまま当てはめてよいですか?
解答例を確認する
そのまま当てはめてはいけません。ここでは allows you to implement となっており、to の後ろに動詞の原形が来ています。さらに complex features と連動していることから「機能を実装する」と判断します。
トラブルシューティング
訳文が技術的な意味と食い違っている
API 名、識別子、コード部分は原文のまま保持し、ドキュメント前後の文脈と照らし合わせて確認してください。訳文はあくまで補助です。コードの実行や設定の変更を行う前に、必ず公式ドキュメントの原文を基準にしてください。