Merge pull request #365 from ma10/update-en-translation-20250627

参考情報の英訳を追加

Author: ma10

data/yaml/faq/d0004.yaml

@@ -39,6 +39,10 @@ explanation:
     Additionally, if the icon serves as a button, the screen reader will announce that it is a button.
     For this reason, there is no need to include the word "button" in the alternative text either.
     If the announcement fails to convey that it is a button, there is likely an issue with the markup.
+
+    Note: The additional information such as "image" or "button" in screen reader announcements is based on the role of the element being read.
+    Every element has a default role, and you can change the role of an element from its default using the ``role`` attribute.
+    By using appropriate elements and, if necessary, leveraging the ``role`` attribute, you can ensure that screen readers can add the correct information.
 info:
 - exp-image-text-alternative
 - exp-markup-component

en/source/explanations/dynamic_content-hover.rst

@@ -1,28 +1,30 @@
 .. _exp-dynamic-content-hover:
 
 ########################################################
-マウスオーバー（ホバー）で表示されるコンテンツと拡大表示
+Content Displayed on Mouseover (Hover) and Magnification
 ########################################################
 
-マウス・ポインターのマウスオーバー（ホバー）やキーボード・フォーカスを受け取ったことがトリガーになって新たなコンテンツが表示される場合、特に拡大表示を利用しているロービジョンのユーザーのアクセスを阻害する可能性があります。
+When new content is displayed, triggered by a mouseover (hover) with the mouse pointer or by receiving keyboard focus, it can hinder access, especially for low-vision users who rely on magnification.
 
-拡大表示を利用している場合、一度に画面に表示されるのはコンテンツの一部分に過ぎません。ユーザーはマウス・ポインターを移動させることで、拡大表示する部分を切り替えながら、最終的にコンテンツ全体を理解するという作業をします。
+When using magnification, only a portion of the content is displayed on the screen at any given time.
+Users navigate by moving the mouse pointer to switch the magnified area, eventually piecing together the entire content.
 
-まず、この一連の動作の中で、マウス・ポインターが意図せずしてマウスオーバー表示をトリガーしてしまうことがあります。そして、こうして表示されたコンテンツによってそれまで閲覧していたコンテンツや操作しようとしていたコンポーネントが適切に表示されなくなり、動作を続けられなくなる場合があります。
+First, during this process, the mouse pointer can unintentionally trigger a mouseover display.
+When this happens, the newly displayed content can obscure the content the user was viewing or the component they were trying to interact with, preventing them from continuing their task.
 
-もちろん、マウスオーバーで表示されたコンテンツが他のコンテンツの利用を阻害しないようにすれば問題はありませんが、ユーザーによって異なる様々な拡大率のすべてを想定することは現実的ではありません。
-もしこのとき、マウス・ポインターを移動させずに、例えばEscキーを押すことでマウスオーバー表示されたコンテンツを非表示にすることができれば、ユーザーはそれまで行っていた動作を容易に継続することができます。
+Of course, this is not an issue if the content displayed on mouseover does not interfere with the use of other content, but it is not realistic to anticipate all the different magnification levels used by various users.
+If, at this point, the user could hide the mouseover content without moving the mouse pointer, for example, by pressing the :kbd:`Esc` key, they could easily resume their previous task.
 
-一方、マウスオーバーで表示されたコンテンツを拡大表示を用いているユーザーが読みたい場合、特に表示されたコンテンツが占める領域が大きい場合には、表示されたコンテンツをスクロールさせるような操作が必要になります。
-しかし、もしマウス・ポインターがマウスオーバーのトリガーとなったオブジェクトから離れることでそのコンテンツが非表示になってしまうと、こういった操作を行えなくなります。
-この問題を回避するために、マウスオーバーで新たに表示されたコンテンツ上にマウス・ポインターがある場合も、その表示が継続されるようにすることが求められています。
+On the other hand, if a user with magnification wants to read the content displayed on mouseover, they may need to scroll, especially if the displayed content occupies a large area.
+However, if the content disappears when the mouse pointer moves away from the object that triggered the mouseover, they cannot perform this operation.
+To avoid this problem, it is necessary to ensure that the content remains visible as long as the mouse pointer is over the newly displayed content.
 
-このように、拡大表示を用いている場合は、用いていない場合と比較してより多くの操作が必要となり、同じコンテンツを読むのにもより時間がかかる場合があります。
-そのため、マウスオーバー表示されたコンテンツを非表示にする操作をユーザーが能動的にした場合と、表示されているものが意味を持たなくなった場合（例えば「読み込み中……」といったメッセージなど）以外には、基本的にマウスオーバー表示されたコンテンツを自動的に非表示にしないことが求められています。
+As a result, using magnification often requires more operations and takes more time to read the same content compared to not using it.
+Therefore, it is generally recommended that content displayed on mouseover not automatically hide itself, except when the user actively performs an action to hide it or when the displayed content becomes meaningless (for example, a "loading..." message).
 
-これらの基準を満たしていても、マウスオーバー表示のトリガーとなるオブジェクトの位置と実際に表示されるコンテンツの表示位置が離れていると、ユーザーはその表示に気づかない場合があるという点には注意が必要です。
-本当にマウスオーバーによる表示が最善の方法なのか、よく検討する必要があるでしょう。
+Even when these criteria are met, it is important to note that if the object that triggers the mouseover display is far from where the content is actually displayed, the user may not notice the new content.
+It is important to carefully consider whether a mouseover display is truly the best method.
 
-なお、マウスオーバーをトリガーとする場合、 :ref:`gl-input-device-keyboard-operable` を満たすために、キーボード・フォーカスも合わせてトリガーにする必要がある点に十分注意する必要があります。
+You should also note that when using mouseover as a trigger, it is crucial to also use keyboard focus as a trigger to meet the requirements of :ref:`gl-input-device-keyboard-operable`.
 
 .. include:: /inc/info2gl/exp-dynamic-content-hover.rst

en/source/explanations/keyboard-notrap.rst

@@ -1,17 +1,18 @@
 .. _exp-keyboard-notrap:
 
-####################################
-キーボード・トラップが引き起こす問題
-####################################
 
-ガイドラインでは、ページ上にあるコンポーネントにキーボードを使ってフォーカスを移動できる場合、そのコンポーネントからフォーカスを外す操作もキーボードで可能にするように求めています。
+#################################
+Problems Caused by Keyboard Traps
+#################################
 
-これは、元々JavaアプレットやFlashを用いたページが頻繁に作られていた時期に、キーボードのみを使っているユーザーがページ中に埋め込まれたJavaアプレットやFlashプレイヤーからフォーカスが外せなくなる現象がしばしば見られたことに起因して定められた項目です。
-一般的なHTMLで実装されているページではこのような状況を引き起こすことは少ないですが、Reactコンポーネントやページ中に埋め込まれる音声/動画プレイヤーなどではこのような状況が発生する可能性があります。
+The guidelines require that if a user can use the keyboard to move the focus to a component on a page, they must also be able to move the focus away from that component using the keyboard.
 
-こういった状況が発生すると、ユーザーはそのコンポーネントの外にあるコンテンツにアクセスできなくなってしまいます。
-すなわち、ページの他の部分がいくらアクセシビリティーが高い状態であっても、この問題が発生しているページではページ全体を利用できない状態になってしまいますので、このような状況を回避することは必須です。
+This requirement was established because a common problem during the era of Java applets and Flash was that users who only used a keyboard would often get their focus trapped within an embedded Java applet or Flash player, unable to move it out.
+While this situation is less common on pages implemented with standard HTML, it can still occur with React components and embedded audio/video players.
 
-Tab/Shift+Tabキー、矢印キー、Escキーなど、簡単な操作でフォーカスを外せるようにすることが必要です。
+When this happens, the user is unable to access any content outside of that component.
+This means that no matter how accessible other parts of the page are, the entire page becomes unusable if this problem occurs. Therefore, it is essential to prevent such situations.
+
+It is necessary to allow users to move the focus out of a component with simple key presses like :kbd:`Tab` / :kbd:`Shift+Tab`, arrow keys, or :kbd:`Esc`.
 
 .. include:: /inc/info2gl/exp-keyboard-notrap.rst

en/source/explanations/link-text.rst

@@ -1,35 +1,35 @@
 .. _exp-link-text:
 
-################################
-リンク先の内容を推測しやすくする
-################################
+############################################
+Making It Easy to Guess the Link Destination
+############################################
 
-リンク先に求めている情報があるかどうかを推測しやすくすることは、どのようなユーザーにとっても使い勝手の向上につながります。
+Making it easier to predict whether a link leads to the desired information improves the user experience for everyone.
 
-リンク先の内容の推測を容易にして、不必要なページ遷移を抑制することは、肢体不自由でマウス操作に時間がかかるなどといった状況のユーザーにとっては特に重要です。
+For users with physical disabilities who take more time to operate a mouse, it is especially important to make it easier to predict the content of a linked page and thereby prevent unnecessary page transitions.
 
-また、スクリーン・リーダーのユーザーは、スクリーン・リーダーが提供するページ中のリンクを一覧表示する機能を用いて、目的のページへのリンクを探す場合があります。
-さらに、 :kbd:`Tab` キーや :kbd:`Shift+Tab` キーを繰り返し押すことでフォーカスを移動させ、目的のリンクを探すユーザーも少なくありません。
-このような場合、リンク・テキスト（ ``a`` 要素の中身）が、リンク先のページの内容を推測できるものになっているかどうかが重要です。
+Additionally, screen reader users may use their screen reader's feature to list all links on a page to find the one they need.
+Many users also find links by repeatedly pressing the :kbd:`Tab` / :kbd:`Shift+Tab` keys to move the focus.
+In these cases, it is crucial that the link text (the content of the ``a`` element) enables users to predict the content of the destination page.
 
-.. list-table:: 注意すべきリンク・テキストの文言の例（「」部分がリンク・テキスト）
+.. list-table:: Examples of problematic link text (link text is in quotation marks)
    :header-rows: 1
 
-   *  -  NG
-      -  OK
-   *  -  ○○は「こちら」
-      -  「○○はこちら」
-   *  -  「もっと見る」
-      -  「○○についてもっと見る」
-   *  -  「詳細」
-      -  「○○についての詳細」
+   *  -  Inadvisable
+      -  Recommended
+   *  -  "Click here" for XX
+      -  "Click here for XX"
+   *  -  "Read more"
+      -  "Read more about XX"
+   *  -  "Details"
+      -  "Details about XX"
 
-また、マークアップによってリンクの意図が明確になっていれば、ガイドラインを満たすことができます。
+You can also meet the guidelines if the link's purpose is clear from the markup.
 
-具体的には、リンク・テキストが同じ複数のリンクがあるページで、以下のような条件を満たしている場合を例として挙げられます。
+Specifically, consider a page with multiple links that have the same link text and meet the following conditions:
 
-*  当該のリンクがページ中の異なるセクションに含まれている場合、見出しが適切にマークアップされていて、各リンクが含まれるセクションが明確になっている
-*  リストの各項目に同じリンク・テキストのリンクがある場合に、適切にリスト・アイテムがマークアップされていて、どのリスト項目に含まれるリンクかが明確になっている
-*  表の各行に同じリンク・テキストがある場合に、適切に ``table`` 要素や関連要素でリンクが含まれる行と列が明確になっている
+*  If the links are in different sections of the page, the headings are properly marked up, making it clear which section each link is in.
+*  If a list contains links with the same link text, the list items are properly marked up, making it clear which list item each link belongs to.
+*  If a table has links with the same link text in each row, the ``table`` element and related elements are properly marked up, making the row and column of each link clear.
 
 .. include:: /inc/info2gl/exp-link-text.rst