Merge pull request #234 from ma10/fix-rst-20240422

外部リンクの記法の誤りを修正
freee · Apr 22, 2024 · f76fbf8 · f76fbf8
2 parents cacf132 + 52e8164
commit f76fbf8
Show file tree

Hide file tree

Showing 101 changed files with 384 additions and 385 deletions.
diff --git a/data/yaml/checks/product/0682.yaml b/data/yaml/checks/product/0682.yaml
@@ -47,6 +47,6 @@ procedures:
   - tool: Landmark Navigation via Keyboard or Pop-up
     technique:
       ja: |-
-        `Landmark Navigation via Keyboard or Pop-up <https://matatk.agrip.org.uk/landmarks/>`_ をインストールしたブラウザーで表示した際、コンテンツのすべてのパーツが適切なARIAランドマークの領域に属していることを確認する。
+        `Landmark Navigation via Keyboard or Pop-up <https://matatk.agrip.org.uk/landmarks/>`__ をインストールしたブラウザーで表示した際、コンテンツのすべてのパーツが適切なARIAランドマークの領域に属していることを確認する。
       en: |-
-        Confirm that every part of the page content is contained in an appropriate ARIA landmark region when viewed using a browser with the `Landmark Navigation via Keyboard or Pop-up <https://matatk.agrip.org.uk/landmarks/>`_ extention installed.
+        Confirm that every part of the page content is contained in an appropriate ARIA landmark region when viewed using a browser with the `Landmark Navigation via Keyboard or Pop-up <https://matatk.agrip.org.uk/landmarks/>`__ extention installed.
diff --git a/data/yaml/faq/d0002.yaml b/data/yaml/faq/d0002.yaml
@@ -26,19 +26,19 @@ solution:
 explanation:
   ja: |-
     :ref:`check-0331` と :ref:`check-0351` は、ガイドライン項目 :ref:`gl-icon-target-size` を満たすための条件を示しています。
-    このガイドラインは、WCAG 2.1の達成基準2.5.5 `Target Size <https://www.w3.org/TR/WCAG21/#target-size>`_ （ `ターゲットのサイズ <https://waic.jp/translations/WCAG21/#target-size>`_ ）が元になっています。
+    このガイドラインは、WCAG 2.1の達成基準2.5.5 `Target Size <https://www.w3.org/TR/WCAG21/#target-size>`__ （ `ターゲットのサイズ <https://waic.jp/translations/WCAG21/#target-size>`__ ）が元になっています。
 
     レベルAAAのこの達成基準では、マウスなどのポインティング・ディバイスの操作対象（チェックボックスやラジオボタンを含む）の大きさとして44×44px以上のサイズを求めています。
     デスクトップ向けサービスの多いfreeeでは、44×44px以上を満たすのは難しいものの、何らかの基準は必要ということで、24×24pxという基準を設けています。
 
-    なお、WCAGの最新バージョンであるWCAG 2.2では、 `Target Size (Minimum) <https://www.w3.org/TR/WCAG22/#target-size-minimum>`_  として、24×24px以上を求めるレベルAAの達成基準2.5.8が追加されています。
+    なお、WCAGの最新バージョンであるWCAG 2.2では、 `Target Size (Minimum) <https://www.w3.org/TR/WCAG22/#target-size-minimum>`__  として、24×24px以上を求めるレベルAAの達成基準2.5.8が追加されています。
 
     これらの達成基準では、例外事項として、「ユーザエージェントのコントロールである: ターゲットのサイズがユーザエージェントによって定められており、かつコンテンツ制作者が変更していない。」という項目があるため、freeeのガイドライン/チェックリストでも、ブラウザーのデフォルトから変更していないものは対象外としています。
     ブラウザーのデフォルトでラジオボタンやチェックボックスのサイズが小さいのはコンテンツ製作者の責任ではなく、またブラウザーのデフォルトにしてあればユーザー側で変更することも可能だろうという想定なのだと考えられます。
 
     ブラウザーのデフォルトから変更しているかどうかの判断方法には、以下のようなものがあります。
 
-    *  MDNの `チェックボックスのサンプル <https://developer.mozilla.org/ja/docs/Web/HTML/Element/input/checkbox>`_ や `ラジオボタンのサンプル <https://developer.mozilla.org/ja/docs/Web/HTML/Element/input/radio>`_ と見比べてみて、明らかに見た目が違う場合は変更されている。
+    *  MDNの `チェックボックスのサンプル <https://developer.mozilla.org/ja/docs/Web/HTML/Element/input/checkbox>`__ や `ラジオボタンのサンプル <https://developer.mozilla.org/ja/docs/Web/HTML/Element/input/radio>`__ と見比べてみて、明らかに見た目が違う場合は変更されている。
     *  開発者ツールを用いてページのソースを確認する：
 
        1. チェックボックスの上で右クリックしてメニューを開き、「検証」を選ぶ
@@ -63,19 +63,19 @@ explanation:
 
           上記のスクリーン・ショットでは ``box-sizing: border-box`` が上書きされているが、元の指定と同じで、見た目を変更する指定でもないので問題はない。
   en: |-
-    Checks 0331 and 0351 indicate the conditions for satisfying Guideline Item :ref:`gl-icon-target-size` which is based on the Success Criterion 2.5.5 `Target Size <https://www.w3.org/TR/WCAG21/#target-size>`_ of WCAG 2.1.
+    Checks 0331 and 0351 indicate the conditions for satisfying Guideline Item :ref:`gl-icon-target-size` which is based on the Success Criterion 2.5.5 `Target Size <https://www.w3.org/TR/WCAG21/#target-size>`__ of WCAG 2.1.
 
     This Level AAA success criterion requires the size of pointer input targets, including checkboxes and radio buttons, to be 44×44px or more.
     freee, which has many desktop services, finds it difficult to meet the requirement of 44×44px or more, but it is necessary to have some kind of standard, so we have set a standard of 24×24px.
 
-    In WCAG 2.2, the latest version of WCAG, Level AA Success Criterion 2.5.8 `Target Size (Minimum) <https://www.w3.org/TR/WCAG22/#target-size-minimum>`_ has been added, which requires a size of 24×24px or more.
+    In WCAG 2.2, the latest version of WCAG, Level AA Success Criterion 2.5.8 `Target Size (Minimum) <https://www.w3.org/TR/WCAG22/#target-size-minimum>`__ has been added, which requires a size of 24×24px or more.
 
     These success criteria have an exception that "The size of the target is determined by the user agent and is not modified by the author." Therefore, in freee's guidelines/checklist, those that have not been changed from the browser's default are excluded.
     When the check boxes and radio buttons are shown with the browser's default style, the content author does not owe the responsibility for it, and it can be assumed that the user can change the setting.
 
     There are several ways to determine whether or not the browser's default has been changed.
 
-    *  If the appearance is clearly different from the MDN `checkbox sample <https://developer.mozilla.org/ja/docs/Web/HTML/Element/input/checkbox>`_ or `radio button sample <https://developer.mozilla.org/ja/docs/Web/HTML/Element/input/radio>`_ , it has been changed.
+    *  If the appearance is clearly different from the MDN `checkbox sample <https://developer.mozilla.org/ja/docs/Web/HTML/Element/input/checkbox>`__ or `radio button sample <https://developer.mozilla.org/ja/docs/Web/HTML/Element/input/radio>`__ , it has been changed.
     *  Use the developer tools to check the page source:
 
        1. Right-click on the checkbox to open the menu and select "Inspect".

diff --git a/data/yaml/faq/d0003.yaml b/data/yaml/faq/d0003.yaml
@@ -19,13 +19,13 @@ solution:
 explanation:
   ja: |-
     当ガイドラインでクリック/タップ可能な領域のサイズ（ターゲット・サイズ）について定めているものは、アイコンとフォーム・コントロールを対象としていて、テキストのリンクは対象としていません。
-    また、WCAG 2.1の達成基準2.5.5 `Target Size <https://www.w3.org/TR/WCAG21/#target-size>`_ （ `ターゲットのサイズ <https://waic.jp/translations/WCAG21/#target-size>`_ ）においても、インラインである場合の例外として、クリック/タップのターゲットが文中、又はテキスト・ブロック内に存在する場合には、サイズの基準の対象外としています。
+    また、WCAG 2.1の達成基準2.5.5 `Target Size <https://www.w3.org/TR/WCAG21/#target-size>`__ （ `ターゲットのサイズ <https://waic.jp/translations/WCAG21/#target-size>`__ ）においても、インラインである場合の例外として、クリック/タップのターゲットが文中、又はテキスト・ブロック内に存在する場合には、サイズの基準の対象外としています。
 
     ターゲット・サイズは大きい方が操作しやすいというのは事実ですから、幅に関してはリンクにするテキストの内容を工夫することでより広くすることはできますし、可能な範囲でそういった工夫をすることは推奨されます。
     一方高さに関しては、ターゲット・サイズの基準を満たすだけの目的で調整する必要はありません。
   en: |-
     In our guidelines, the specified sizes for clickable/tappable areas (target size) are intended for icons and form controls, and do not apply to text links.
-    Similarly, in WCAG 2.1 `Success Criterion 2.5.5 Target Size <https://www.w3.org/TR/WCAG21/#target-size>`_, there's an exception for inline elements, where targets that are within sentences or text blocks are exempt from the size criteria.
+    Similarly, in WCAG 2.1 `Success Criterion 2.5.5 Target Size <https://www.w3.org/TR/WCAG21/#target-size>`__, there's an exception for inline elements, where targets that are within sentences or text blocks are exempt from the size criteria.
 
     It is true that larger target size makes it easier to interact with, so it is recommended to creatively adjust the content of the text being linked to make its width broader, within feasible limits.
     However, there is no need to adjust the height solely to meet the target size criteria.

diff --git a/data/yaml/gl/image/mobile-text-contrast.yaml b/data/yaml/gl/image/mobile-text-contrast.yaml
@@ -16,8 +16,8 @@ guideline:
 
     注：モバイル・アプリケーションにおいては、デスクトップのWebと比較して文字サイズの変更方法が広く知られていると推測されること、各プラットフォームのガイドライン [#]_ [#]_ においてもWCAG 2.1に準じた基準を用いていることから、上記の基準としています。
 
-    .. [#] `アクセシビリティ | Apple Developer Documentation <https://developer.apple.com/jp/design/human-interface-guidelines/accessibility>`_
-    .. [#] `Accessibility – Material Design 3 <https://m3.material.io/foundations/accessible-design/patterns#f72f3851-5184-4132-b871-bc8224e062e2>`_
+    .. [#] `アクセシビリティ | Apple Developer Documentation <https://developer.apple.com/jp/design/human-interface-guidelines/accessibility>`__
+    .. [#] `Accessibility – Material Design 3 <https://m3.material.io/foundations/accessible-design/patterns#f72f3851-5184-4132-b871-bc8224e062e2>`__
   en: |-
     Ensure sufficient contrast between the colors of text within images and key visual elements conveying important information, and their background colors.
 
@@ -27,8 +27,8 @@ guideline:
 
     Note: In mobile applications, it is assumed that methods for changing text size are more widely known compared to desktop web, and the guidelines of each platform [#]_ [#]_ also use standards in line with WCAG 2.1, hence the above criteria are set.
 
-    .. [#] `Accessibility | Apple Developer Documentation <https://developer.apple.com/design/human-interface-guidelines/accessibility>`_
-    .. [#] `Accessibility – Material Design 3 <https://m3.material.io/foundations/accessible-design/patterns#f72f3851-5184-4132-b871-bc8224e062e2>`_
+    .. [#] `Accessibility | Apple Developer Documentation <https://developer.apple.com/design/human-interface-guidelines/accessibility>`__
+    .. [#] `Accessibility – Material Design 3 <https://m3.material.io/foundations/accessible-design/patterns#f72f3851-5184-4132-b871-bc8224e062e2>`__
 sc:
 - 1.4.3
 - 1.4.6

diff --git a/data/yaml/gl/image/text-contrast.yaml b/data/yaml/gl/image/text-contrast.yaml
@@ -16,8 +16,8 @@ guideline:
 
     注：freeeのプロダクトやWebサイトにおいては、主に日本語が用いられているため、Understanding WCAG 2.1 [#]_ の日本語訳 [#]_ 中の訳注で示されている基準を用いています。
 
-    .. [#] `Understanding Success Criterion 1.4.3: Contrast (Minimum) <https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html>`_
-    .. [#] `達成基準 1.4.3: コントラスト (最低限)を理解する <https://waic.jp/translations/WCAG21/Understanding/contrast-minimum.html>`_
+    .. [#] `Understanding Success Criterion 1.4.3: Contrast (Minimum) <https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html>`__
+    .. [#] `達成基準 1.4.3: コントラスト (最低限)を理解する <https://waic.jp/translations/WCAG21/Understanding/contrast-minimum.html>`__
   en: |-
     Ensure sufficient contrast between the colors of text within images and key visual elements conveying important information, and their background colors.
 
@@ -27,8 +27,8 @@ guideline:
 
     Note: In freee products and websites, Japanese is mainly used, so the criteria indicated in the translation notes in Understanding WCAG 2.1 [#]_ [#]_  are used.
 
-    .. [#] `Understanding Success Criterion 1.4.3: Contrast (Minimum) <https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html>`_
-    .. [#] `達成基準 1.4.3: コントラスト (最低限)を理解する <https://waic.jp/translations/WCAG21/Understanding/contrast-minimum.html>`_
+    .. [#] `Understanding Success Criterion 1.4.3: Contrast (Minimum) <https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html>`__
+    .. [#] `達成基準 1.4.3: コントラスト (最低限)を理解する <https://waic.jp/translations/WCAG21/Understanding/contrast-minimum.html>`__
 sc:
 - 1.4.3
 - 1.4.6

diff --git a/data/yaml/gl/images_of_text/mobile-text-contrast.yaml b/data/yaml/gl/images_of_text/mobile-text-contrast.yaml
@@ -16,8 +16,8 @@ guideline:
 
     注：モバイル・アプリケーションにおいては、デスクトップのWebと比較して文字サイズの変更方法が広く知られていると推測されること、各プラットフォームのガイドライン [#]_ [#]_ においてもWCAG 2.1に準じた基準を用いていることから、上記の基準としています。
 
-    .. [#] `アクセシビリティ | Apple Developer Documentation <https://developer.apple.com/jp/design/human-interface-guidelines/accessibility>`_
-    .. [#] `Accessibility – Material Design 3 <https://m3.material.io/foundations/accessible-design/patterns#f72f3851-5184-4132-b871-bc8224e062e2>`_
+    .. [#] `アクセシビリティ | Apple Developer Documentation <https://developer.apple.com/jp/design/human-interface-guidelines/accessibility>`__
+    .. [#] `Accessibility – Material Design 3 <https://m3.material.io/foundations/accessible-design/patterns#f72f3851-5184-4132-b871-bc8224e062e2>`__
   en: |-
     Ensure a sufficient contrast ratio between the colors of images of text and their background colors.
 
@@ -27,8 +27,8 @@ guideline:
 
     Note: In mobile applications, it is assumed that methods for changing text size are more widely known compared to desktop web, and the guidelines of each platform [#]_ [#]_ also use standards in line with WCAG 2.1, hence the above criteria are set.
 
-    .. [#] `Accessibility | Apple Developer Documentation <https://developer.apple.com/design/human-interface-guidelines/accessibility>`_
-    .. [#] `Accessibility – Material Design 3 <https://m3.material.io/foundations/accessible-design/patterns#f72f3851-5184-4132-b871-bc8224e062e2>`_
+    .. [#] `Accessibility | Apple Developer Documentation <https://developer.apple.com/design/human-interface-guidelines/accessibility>`__
+    .. [#] `Accessibility – Material Design 3 <https://m3.material.io/foundations/accessible-design/patterns#f72f3851-5184-4132-b871-bc8224e062e2>`__
 sc:
 - 1.4.3
 - 1.4.6

diff --git a/data/yaml/gl/images_of_text/text-contrast.yaml b/data/yaml/gl/images_of_text/text-contrast.yaml
@@ -16,8 +16,8 @@ guideline:
 
     注：freeeのプロダクトやWebサイトにおいては、主に日本語が用いられているため、Understanding WCAG 2.1 [#]_ の日本語訳 [#]_ 中の訳注で示されている基準を用いています。
 
-    .. [#] `Understanding Success Criterion 1.4.3: Contrast (Minimum) <https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html>`_
-    .. [#] `達成基準 1.4.3: コントラスト (最低限)を理解する <https://waic.jp/translations/WCAG21/Understanding/contrast-minimum.html>`_
+    .. [#] `Understanding Success Criterion 1.4.3: Contrast (Minimum) <https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html>`__
+    .. [#] `達成基準 1.4.3: コントラスト (最低限)を理解する <https://waic.jp/translations/WCAG21/Understanding/contrast-minimum.html>`__
   en: |-
     Ensure a sufficient contrast ratio between the colors of images of text and their background colors.
 
@@ -27,8 +27,8 @@ guideline:
 
     Note: In freee products and websites, Japanese is mainly used, so the criteria indicated in the translation notes in Understanding WCAG 2.1 [#]_ [#]_ are used.
 
-    .. [#] `Understanding Success Criterion 1.4.3: Contrast (Minimum) <https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html>`_
-    .. [#] `達成基準 1.4.3: コントラスト (最低限)を理解する <https://waic.jp/translations/WCAG21/Understanding/contrast-minimum.html>`_
+    .. [#] `Understanding Success Criterion 1.4.3: Contrast (Minimum) <https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html>`__
+    .. [#] `達成基準 1.4.3: コントラスト (最低限)を理解する <https://waic.jp/translations/WCAG21/Understanding/contrast-minimum.html>`__
 sc:
 - 1.4.3
 - 1.4.6

diff --git a/data/yaml/gl/text/contrast.yaml b/data/yaml/gl/text/contrast.yaml
@@ -16,8 +16,8 @@ guideline:
 
     注：freeeのプロダクトやWebサイトにおいては、主に日本語が用いられているため、Understanding WCAG 2.1 [#]_ の日本語訳 [#]_ 中の訳注で示されている基準を用いています。
 
-    .. [#] `Understanding Success Criterion 1.4.3: Contrast (Minimum) <https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html>`_
-    .. [#] `達成基準 1.4.3: コントラスト (最低限)を理解する <https://waic.jp/translations/WCAG21/Understanding/contrast-minimum.html>`_
+    .. [#] `Understanding Success Criterion 1.4.3: Contrast (Minimum) <https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html>`__
+    .. [#] `達成基準 1.4.3: コントラスト (最低限)を理解する <https://waic.jp/translations/WCAG21/Understanding/contrast-minimum.html>`__
   en: |-
     Ensure sufficient contrast between the colors of text and their background colors.
 
@@ -27,8 +27,8 @@ guideline:
 
     Note: In freee products and websites, Japanese is mainly used, so the criteria indicated in the translation notes in Understanding WCAG 2.1 [#]_ [#]_ are used.
 
-    .. [#] `Understanding Success Criterion 1.4.3: Contrast (Minimum) <https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html>`_
-    .. [#] `達成基準 1.4.3: コントラスト (最低限)を理解する <https://waic.jp/translations/WCAG21/Understanding/contrast-minimum.html>`_
+    .. [#] `Understanding Success Criterion 1.4.3: Contrast (Minimum) <https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum.html>`__
+    .. [#] `達成基準 1.4.3: コントラスト (最低限)を理解する <https://waic.jp/translations/WCAG21/Understanding/contrast-minimum.html>`__
 sc:
 - 1.4.3
 - 1.4.6