英文スタイルガイド解説(12):UI要素の書き方3

本記事は「プログラミング英語検定ニュースレター #12」(2020年10月30日発行)からの一部抜粋です。同ニュースレターでは、検定のクーポン情報や英語解説などを定期的に発信しています。登録はこちらから。

Googleが公開している開発者向け英文スタイルガイドから項目を1つ取り上げて紹介します。スタイルガイドは基本的には書く際に利用されますが、読む際にも参考になります。

UI要素の書き方3

URL:https://developers.google.com/style/ui-elements#ui-terms (2020-10-29閲覧)

開発者であれば、ちょっとした操作説明を英語で書く機会があります。今回は、操作説明におけるUI要素の書き方の3回目です(第1回2回)。なお英語例文はGoogleのものです。

テキスト・ボックス(text box)

ユーザーが入力できるUIです。それ自体は「text box」ですが、例文のように「the ◯◯ box」と表現するとしています。動詞は「enter」(入力する)がよく用いられます。

  • ◯: In the Owner box, enter your name.

リスト・ボックス(list box)

項目をリストで表示するUIです。ドロップダウン式の場合、「the ◯◯ drop-down list」と表現するとしています。この場合の動詞は「select」(選択する)です。

  • ◯: In the Item drop-down list, select Desktop.

コンボ・ボックス(combo box)

テキスト・ボックスとリスト・ボックスが組み合わさったUIです。「the ◯◯ box」と表現します。動詞は「type or select」または「enter」を使うとしています。なおtypeは「(キーボードで)入力する」という意味です。名詞の「型」や「タイプ」ではないので注意しましょう。

  • ◯:  In the Font box, type or select the font you want to use.

チェックボックス(checkbox)

チェックボックスは「checkbox」と1語であり、「check box」と2語ではない点に注意してください。

また、チェックボックスにチェックを入れる(オンにする)と表現する場合、動詞は「check」よりも「select」を使うとしています。またオフにするのは「clear」という動詞を使います。

  • ◯: Select the Automatically check for updates checkbox.
  • ◯: Clear the Bookmarks checkbox.

なお、オフでは「deselect」や「uncheck」という動詞も候補になりますが、これらも使わないとしています。

ラジオボタン(radio button)

ラジオボタンの選択肢を表現する場合、例文のようにラベルをそのまま書くとしています(「the ◯◯ radio button」のようにはしない)。

  • ◯: Click Do not remember passwords.

トグル(toggle)

オンとオフを切り替えるUIです。toggleという英単語は名詞としてUI自体を指しますが、「切り替える」という動詞でもあります。以下の1つ目の例文が動詞、2つ目が名詞です。

  • ◯: You can toggle Magic Mode in the Settings window.
  • ◯: To enable, click the Wi-Fi toggle.

(ライセンス表示: Portions of this page are modifications based on work created and shared by Google and used according to terms described in the Creative Commons 4.0 Attribution License.)


[筆者について]
西野竜太郎。IT分野の英語翻訳者/リンギスト。訳書に「血と汗とピクセル」、著書に「アプリケーションをつくる英語」(第4回ブクログ大賞)、「ITエンジニアのための英語リーディング」、「ソフトウェア・グローバリゼーション入門」、「アプリ翻訳実践入門」など。ブログTwitter

頻出英語表現(3):たとえば

プログラミング関連のドキュメントで頻出する英語表現を紹介します。とりわけAPIリファレンスやマニュアルでよく用いられる表現を取り上げます。


今回は「たとえば」と例示をする際の表現です。

▼ such as

何かしら名詞を提示した後に、具体的な例として出す際に使われます。例:

  • You need devices such as PCs, tablets, and smartphones.
    • たとえばPC、タブレット、およびスマートフォンといったデバイスが必要です。

なお、such asのあとに例を複数列挙する場合、andなのかorなのか迷うことがあります。辞書や文法書に使い分けが明示されていることはあまりなく、確立したルールはなさそうです。ただ、コーパス(言語資料)で使用傾向を見ると、上記例のように「devices」と名詞複数形の場合には「and」、単数形の場合には「… a device such as a PC, a tablet, or a smartphone」と「or」を使うケースが目に付くように感じます。

such as以外

上記「such as」が最も多く出現するのですが、同じように使われる言葉もあります。likeincludinge.g.です。例:

  • Components like buttons and fields
    • ボタンやフィールドのようなコンポーネント
    • ※この場合のlikeは前置詞の扱い
  • All assets, including audios, videos, and images will be downloaded.
    • オーディオ、ビデオ、画像を含むすべてのアセットがダウンロードされます。
    • ※この場合のincludingは前置詞の扱い
  • Month must be two digits (e.g., 09)
    • 月は2桁でなければならない(たとえば、09)
    • ※ラテン語のexempli gratiaの略

▼ for example

文頭で「たとえば、〜」と書く場合、「For example, …」がよく用いられます。例:

  • For example, you can create another account.
    • たとえば、別のアカウントを作成できます。

「for example」と似たような使い方ができるのが「for instance」です。「for example」を基本で使いつつ、マニュアルなどを書く際に表現が単調になるのを避けるのに使えます。例:

  • For instance, the username or the password is invalid.
    • たとえば、ユーザー名かパスワードが無効です。

[筆者について]
西野竜太郎。IT分野の英語翻訳者/リンギスト。訳書に「血と汗とピクセル」、著書に「アプリケーションをつくる英語」(第4回ブクログ大賞)、「ITエンジニアのための英語リーディング」、「ソフトウェア・グローバリゼーション入門」、「アプリ翻訳実践入門」など。ブログTwitter

頻出英語表現(2):◯◯にあるとおり

プログラミング関連のドキュメントで頻出する英語表現を紹介します。とりわけAPIリファレンスやマニュアルでよく用いられる表現を取り上げます。


APIリファレンスやマニュアルでは、読者に別の情報を参照してもらうケースがよくあります。頻出表現の第1回では「詳細は◯◯を参照してください」という表現を紹介しました。

今回は同じく、別の情報を参照してもらいたい場合に使える「◯◯にあるとおり」という表現です。

▼ as described in …

これが最もよく見られる基本的な形です。describeは「記述する」や「説明する」という動詞です。「…」の部分に場所が示されます。例:

  • As described in the previous section, you need to change your password.
    • 前のセクションにあるとおり、お使いのパスワードを変更する必要があります。
  • Edit your profile as described in this documentation.
    • このドキュメントにあるとおりにプロフィールを編集します。

describe以外の動詞

describe以外の動詞を使うことで、表現に変化を付けたり、ニュアンスを変えたりできます。

define(定義する)、discuss(論じる)、explain(説明する)、show(見せる)、specifiy(指定する)といった動詞です。例:

  • Returns a string as defined in RFC xxx.
    • RFC xxxに定義されているような文字列を返す。
  • Add a README file as discussed in #154
    • #154で議論したとおりにREADMEファイルを追加(※コミットメッセージ)
  • Specify a destination as explained in Step 3.
    • ステップ3で説明したとおりに宛先を指定します。
  • An error dialog appears, as shown in Figure 5.
    • 図5で示すように、エラー・ダイアログが表示されます。
  • [Parameters] attrs: Attributes as defined in XML file.
    • [パラメーター]attrs:XMLファイルに定義されている属性。

in以外の前置詞や副詞

ほかの応用として、前置詞inの部分を別の言葉に置き換える方法もあります。

たとえばabove(上に、上記)、earlier(以前)、here(ここに)です。例:

  • HTTPS should be used as described above.
    • 上記のとおりHTTPSを使うことが望ましい。
  • As described earlier, user accounts cannot be deleted automatically.
    • 前述したように、ユーザー・アカウントは自動的に削除できません。
  • Our services are as described here: www.example.com.
    • 弊社サービスはここに記載されているとおりとなります: www.example.com

[筆者について]
西野竜太郎。IT分野の英語翻訳者/リンギスト。訳書に「血と汗とピクセル」、著書に「アプリケーションをつくる英語」(第4回ブクログ大賞)、「ITエンジニアのための英語リーディング」、「ソフトウェア・グローバリゼーション入門」、「アプリ翻訳実践入門」など。ブログTwitter

頻出英語表現(1):詳細は◯◯を参照してください

プログラミング関連のドキュメントで頻出する英語表現を紹介します。とりわけAPIリファレンスやマニュアルでよく用いられる表現を取り上げます。


今回は「詳細は◯◯を参照してください」という表現です。その文章内では説明しきれないような場合に、別のページや外部サイトへのアクセスを促すのに使います。

▼ For more information, see …

これが最も基本的な形です。「…」の部分にリンク先やURLなどが入ります。例:

  • For more information, see our website.
    • 詳細は弊社ウェブサイトを参照してください。
  • For more information, see the following documents:
    • 詳細は以下のドキュメントを参照してください:

information about/on

何についての情報かという点を詳しく説明したい場合、前置詞にaboutやonを使います。例:

  • For more information about these commands, see Commands.
    • これらのコマンドに関する詳細は「コマンド」を参照してください。
  • For more information on this file, see our documentation.
    • このファイルに関する詳細は、当社ドキュメントを参照してください。

information about how to / 動詞ing

マニュアルであれば何かをする方法の説明を書くこともよくあります。「〜する方法についての情報」には「information about how to 〜」や「information about 動詞ing」が使われます。例:

  • For more information about how to create an account, see How to create an account.
    • アカウントを作成する方法の詳細は「アカウントの作成方法」を参照してください。
  • For more information about installing the app, see Installing an app.
    • アプリをインストールする方法の詳細は「アプリをインストールする」を参照してください。

see以外の動詞

「参照してください」の部分にはseeが最もよく用いられますが、同じ動詞ばかりだと単調です。その場合、go toreadrefer tovisitといった動詞も使われます。例:

  • For more information, go to the next section.
    • 詳細は、次のセクションに移動してください。
  • For more information, read this page.
    • 詳細は、このページをお読みください。
  • For more information, refer to Uploading a file.
    • 詳細は「ファイルをアップロードする」を参照してください。
  • For more information, visit our website.
    • 詳細は、弊社のウェブサイトにアクセスしてください。

For details / For information

文頭の「more information」は、文字通りには「さらなる情報」であるため、日本語では「詳細」という言葉がよく当てられます。ここを変更することもできます。

まずdetails(複数形である点に注意)を使った「For details」や「For more details」です。例:

  • For details, visit www.example.com.
    • 詳細は、www.example.comにアクセスしてください。
  • For more details, see this section.
    • 詳細は、このセクションを参照してください。

なお「for details」は文末に置かれることもあります。例:

  • To install the app, see our website for details.
    • アプリをインストールするには、弊社ウェブサイトで詳細を参照してください。

次にmoreを除いた「For information」という形です。moreではないので、それまでに登場していない別の情報を紹介する際に使えます。例:

  • For information about how to upgrade your account, see this page.
    • アカウントのアップグレード方法についての情報は、こちらのページをご覧ください。

▼ To learn more, see …

よく使われるのが上記の「For more information, see …」という基本形です。この冒頭部分を変更することで、表現に変化をつけられます。代表的なのが「To learn more, see …」です。文字通りには「もっと知るには〜を参照してください」という意味ですが、やはり「詳細は〜を参照してください」という日本語がよく当てられます。例:

  • To learn more, see Removing a user.
    • 詳細は「ユーザーを削除する」を参照してください。

この「To learn」でも、前述のように「about how to」などを付けたり、動詞をsee以外にしたり、moreを削除したりといった応用ができます。例:

  • To learn about how to use this device, visit our website.
    • このデバイスを使う方法については、当社ウェブサイトをご覧ください。

[筆者について]
西野竜太郎。IT分野の英語翻訳者/リンギスト。訳書に「血と汗とピクセル」、著書に「アプリケーションをつくる英語」(第4回ブクログ大賞)、「ITエンジニアのための英語リーディング」、「ソフトウェア・グローバリゼーション入門」、「アプリ翻訳実践入門」など。ブログTwitter

英文スタイルガイド解説(11):UI要素の書き方2

本記事は「プログラミング英語検定ニュースレター #11」(2020年9月29日発行)からの一部抜粋です。同ニュースレターでは、検定のクーポン情報や英語解説などを定期的に発信しています。登録はこちらから。

Googleが公開している開発者向け英文スタイルガイドから項目を1つ取り上げて紹介します。スタイルガイドは基本的には書く際に利用されますが、読む際にも参考になります。

UI要素の書き方 ― 2

URL:https://developers.google.com/style/ui-elements#ui-terms (2020-09-28閲覧)

開発者であれば、ちょっとした操作説明を英語で書く機会があります。今回は、操作説明におけるUI要素の書き方の2回目です(第1回はこちら)。なお英語例文はGoogleのものです。

ウィンドウなどの画面区画

画面の区画を指す英単語がいくつかあります。以下のように使い分けます。

window:あるアプリ全体のウィンドウに加え、そのアプリの一部になっているツールなどのウィンドウを指すのにも使う

page:主にウェブ・ページを指すのに使う

dialog:メインのアプリケーション・ウィンドウの手前に表示され、独立した小さなウィンドウを指すのに使う

  • ✕:In the Welcome pop-up window, click OK.
  • ◯:In the Welcome dialog, click OK.

pane:ウィンドウの中にある区画を指すのに使う。発音は「ペイン」で、一般英語としては「窓のガラス1枚」を指す(「田」の形の窓なら4枚のペインがある)。

前置詞は基本的に「in」ですが、pageの場合だけは「on」を使います。

  • ◯:In the Task window, click Start.
  • ◯:On the Create an instance page, click Add.

また「In 〜」のように、操作の場所を先に書くようにしましょう。そうすると、読者の視線の移動に合います。

メニュー・バー

ウィンドウや画面の最上部にあるのがメニュー・バー(menu bar)です。

メニュー・バーでは「ファイル」→「保存」のように、下位項目を連続して選択する操作がよくあります。この連続操作では「>」を使って示します。

  • ◯:Select View > Tools > Developer Tools.

Googleのスタイルガイドでは、この「>」を使った表記方法はメニュー・バーのみに使うとしています。また「>」自体もUIと同じくボールドとしています。

ボタンとアイコン

ボタンを指し示す際は、ボタンのラベルを使います。

  • ✕:Click the “OK” button.
  • ◯:Click OK.

ボタンがアイコンの場合、ツールチップに表示される名前(マウス・カーソルを置いたときにポップアップで出る名前)を書き、その直後にアイコン画像を表示します。

  • ✕:Click the + icon.
  • ◯:Click Add +. (※「+」は画像)

また、UI要素に三点リーダー(エリプシス)がある場合は含めません。

  • ✕:Click Browse ….
  • ◯:Click Browse.

(ライセンス表示: Portions of this page are modifications based on work created and shared by Google and used according to terms described in the Creative Commons 4.0 Attribution License.)


[筆者について]
西野竜太郎。IT分野の英語翻訳者/リンギスト。訳書に「血と汗とピクセル」、著書に「アプリケーションをつくる英語」(第4回ブクログ大賞)、「ITエンジニアのための英語リーディング」、「ソフトウェア・グローバリゼーション入門」、「アプリ翻訳実践入門」など。ブログTwitter

受験スポンサー企業を募集

現在、プログラミング英語検定の受験スポンサーになっていただける企業や団体を募集しています。

希望する受験者に受験料の半額を支援する代わりに、合格証書などにスポンサー名を記載するという内容です。

詳細はこちらのページをご覧ください。

受験スポンサーの関係図

英文スタイルガイド解説(10):UI要素の書き方1

本記事は「プログラミング英語検定ニュースレター #10」(2020年8月28日発行)からの一部抜粋です。同ニュースレターでは、検定のクーポン情報や英語解説などを定期的に発信しています。登録はこちらから。

Googleが公開している開発者向け英文スタイルガイドから項目を1つ取り上げて紹介します。スタイルガイドは基本的には書く際に利用されますが、読む際にも参考になります。

UI要素の書き方 ― 1

URL:https://developers.google.com/style/ui-elements#formatting (2020-08-26閲覧)

開発者であれば、ちょっとした操作説明を英語で書く機会はあります。そのときボタン名やメニュー名などのUI要素をどう扱うか悩むはずです。今回から複数回にわたって、操作説明におけるUI要素の書き方を解説します。なお英語例文はGoogleのものです。

ボールドで囲む

日本語ではUI要素を鍵かっこで囲ったり(例:「編集」を選択)、角かっこで囲ったり(例:[履歴] をクリック)することが多いかと思います。英語で書くときは、UI要素をボールドで書くようにします。

  • ✕: In the New Project window, select “New Activity”, and then click the “Next” button.
    • → ダブルクォーテーション(” “)は使わない
  • ◯: In the New Project window, select the New Activity checkbox, and then click Next.

theを付けるか付けないか

上記の例では「In the New Project window」と定冠詞theが付いていたり、「click Next」と付いていなかったりします。冠詞がない日本語の母語話者にとっては対応に悩む部分です。

例文をよく見ると、theがあるのは「the New Project window」のwindowや「the New Activity checkbox」のcheckboxのような普通名詞がUI要素の後に置かれるときです。他方、UI要素そのままの場合(例:click Next)にはtheがありません。これは文法的に言うと、普通名詞ではなく「固有名詞」のように扱われているためだと思われます。

つまりルールとしては、
・UI要素の後ろにwindowなど普通名詞が付く → theは必要
・UI要素がそのまま → theは不要
となります。

実際、別の例文を見ても上記の形となっています。

  • ◯: In the File menu, click Tools.
  • ◯: In the MyApp window, click Edit.

(ライセンス表示: Portions of this page are modifications based on work created and shared by Google and used according to terms described in the Creative Commons 4.0 Attribution License.)


[筆者について]
西野竜太郎。IT分野の英語翻訳者/リンギスト。訳書に「血と汗とピクセル」、著書に「アプリケーションをつくる英語」(第4回ブクログ大賞)、「ITエンジニアのための英語リーディング」、「ソフトウェア・グローバリゼーション入門」、「アプリ翻訳実践入門」など。ブログTwitter

英文スタイルガイド解説(9):メソッド説明の書き方2

本記事は「プログラミング英語検定ニュースレター #9」(2020年7月31日発行)からの一部抜粋です。同ニュースレターでは、検定の最新情報や英語解説を定期的に発信しています。登録はこちらから。

Googleが公開している開発者向け英文スタイルガイドから項目を1つ取り上げて紹介します。スタイルガイドは基本的には書く際に利用されますが、読む際にも参考になります。

APIリファレンスのメソッドの書き方 ― 2

URL:https://developers.google.com/style/api-reference-comments#parameters (2020-07-30閲覧)

APIリファレンスの書き方に関するページから紹介します。前回はメソッド説明の書き方を取り上げました。今回はメソッドのパラメーターや戻り値などの書き方です。なお英語例文はGoogleのものです。

パラメーター

パラメーターの説明を書く際は、以下のガイドラインに従います。

  • 大文字で書き始め、末尾にはピリオドを付ける
  • ブール値でなければ、定冠詞(the)や不定冠詞(a)で書き始める
    • 上記例:
      • The ID of the bird you want to get.
      • A description of the bird.
  • ブール値であれば、「If true/false, <命令文>」や「True if 〜; false otherwise.」といった構文にする
    • 例:
      • If true, turn traffic lines on. If false, turn them off.
      • True if the zoom is set; false otherwise.

簡潔な記述を目的としているため、主語と動詞がある「きちんとした」英文ではありません。そのため、慣れてなければ違和感を覚えるかもしれません。

また「True if 〜; false otherwise.」は「〜ならtrue、そうでなければfalse」という意味で、APIリファレンスに特有の表現です。otherwiseはプログラミング必須英単語600+のアドバンスト300に入っていますが、この構文での使い方が目立ちます。

戻り値

  • ブール値以外であれば、「The …」で書き始める
    • 例:
      • The bird specified by the given ID.
  • ブール値であれば、「True if …; false otherwise.」という構文にする
    • 例:
      • True if the bird is in the sanctuary; false otherwise.

ブール値以外は「The …」(定冠詞)とされていますが、実際には不定冠詞(a)で示すのが適当な戻り値もあります。

例外

  • 見出しにすでに「Throws」という言葉があれば「If …」で書き始める
    • 例:
      • If no key is assigned.
  • なければ「Thrown when …」で書き始める
    • 例:
      • Thrown when no key is assigned.

なおthrownはthrow(スローする。ベーシック300)の過去分詞形で、「スローされる」という意味です。

非推奨

メソッドなどが非推奨となった場合、文の最初にその旨を書きます。後続の文に理由や代替手段を書きます。

  • 例:
    • Deprecated. Use #CameraPose instead.
    • Deprecated. Access this field using the getField() method.

deprecatedは「非推奨の」という意味の形容詞で、アドバンスト300に入っています。

(ライセンス表示: Portions of this page are modifications based on work created and shared by Google and used according to terms described in the Creative Commons 4.0 Attribution License.)


[筆者について]
西野竜太郎。IT分野の英語翻訳者/リンギスト。訳書に「血と汗とピクセル」、著書に「アプリケーションをつくる英語」(第4回ブクログ大賞)、「ITエンジニアのための英語リーディング」、「ソフトウェア・グローバリゼーション入門」、「アプリ翻訳実践入門」など。ブログTwitter