メインコンテンツまでスキップ

英語の技術ドキュメント、どこから読む?

· 約3分

英語のドキュメントを開いて、最初の一段落で止まってしまう。そんなときは、読む順番を変えてみましょう。今回は、このサイトの読み上げにも関係する Web Speech API を入り口にします。

おすすめの英文ページ​

MDN: SpeechSynthesis は、ブラウザーの音声合成を操作するインターフェイスについての英語ドキュメントです。

この API では、発話の開始や停止、利用可能な音声の取得などを扱えます。利用可否はブラウザーだけでなく、端末に用意されている音声にも左右されます。

これはリンク先の独自の要約であり、逐語訳ではありません。最新の仕様と対応状況は原文を確認してください。

1. まずは見出しとコード例​

最初からすべてを訳す必要はありません。メソッド名、引数、コード例を先に見ると、何ができる API なのか見えてきます。

const utterance = new SpeechSynthesisUtterance('Hello, world!');
utterance.lang = 'en-US';
speechSynthesis.speak(utterance);

これは学習用の最小例です。実際のサイトでは、対応状況の確認やエラー処理、再生の停止も用意します。

2. 動詞を見つける​

ドキュメントには return、create、cancel、represent といった動詞が何度も登場します。「何が・何をするか」に注目してみましょう。

3. 短い英文を訳してみる​

The browser reads the text using an available voice.

ブラウザーは利用可能な音声を使ってテキストを読み上げます。

速度 1.0 / 自動選択 / en-US

using ... は、ここでは「〜を使って」という方法を補足しています。

Check browser support before using this feature in production.

この機能を本番環境で使う前に、ブラウザーの対応状況を確認してください。

速度 1.0 / 自動選択 / en-US

読み終わったら、一文だけメモ​

知らない単語をすべて調べるよりも、必要な機能を理解して、自分の言葉で一文にまとめてみましょう。読めたという小さな経験が、次のドキュメントを開く力になります。

他の記事を紹介・翻訳するときも、出典を明示し、ライセンスや許諾の範囲を確認しましょう。