Merge branch 'main' into lint/m-dash

mdn · Jul 16, 2023 · 8ccf611 · 8ccf611
2 parents 628023e + 13507d9
commit 8ccf611
Show file tree

Hide file tree

Showing 219 changed files with 737 additions and 2,036 deletions.
diff --git a/.prettierignore b/.prettierignore
@@ -14,7 +14,6 @@ build/
 # The following folders still need a full pass:
 
 # es
-/docs/es/**/*.md
 /files/es/games/**/*.md
 /files/es/glossary/**/*.md
 /files/es/learn/**/*.md
@@ -66,7 +65,6 @@ build/
 /files/pt-br/webassembly/**/*.md
 
 # ru
-/docs/ru/**/*.md
 /files/ru/games/**/*.md
 /files/ru/glossary/**/*.md
 /files/ru/learn/**/*.md

diff --git a/docs/es/README.md b/docs/es/README.md
@@ -33,18 +33,18 @@ Ejemplificaremos el proceso a realizar cuando se desea traducir el contenido de
 Ejemplo:
 
 Digamos que desea traducir el contenido de la página que se observa en esta dirección.
-    ![image](https://user-images.githubusercontent.com/7331511/152851642-5dea4df9-f771-4323-bc13-b238dec511ef.png)
+![image](https://user-images.githubusercontent.com/7331511/152851642-5dea4df9-f771-4323-bc13-b238dec511ef.png)
 
 1. Buscar la [versión original (en inglés)](https://github.com/mdn/content/tree/main/files/en-us) del documento que desea traducir.
-    Debería buscar en el repositorio [en inglés (mdn/content)](https://github.com/mdn/content) el archivo correspondiente al documento, en este caso la dirección sería [`files/en-us/web/javascript/reference/global_objects/array/index.md`](https://github.com/mdn/content/blob/main/files/en-us/web/javascript/reference/global_objects/array/index.md)
+   Debería buscar en el repositorio [en inglés (mdn/content)](https://github.com/mdn/content) el archivo correspondiente al documento, en este caso la dirección sería [`files/en-us/web/javascript/reference/global_objects/array/index.md`](https://github.com/mdn/content/blob/main/files/en-us/web/javascript/reference/global_objects/array/index.md)
 
 2. Buscar la [versión en español](https://github.com/mdn/translated-content/blob/main/files/es/) del [documento](https://github.com/mdn/translated-content/blob/main/files/es/web/javascript/reference/global_objects/array/index.html) que desea traducir. En este caso la dirección seria [`files/es/web/javascript/reference/global_objects/array/index.{html|md}`](https://github.com/mdn/translated-content/blob/main/files/es/web/javascript/reference/global_objects/array/index.html)
 
-    > NOTA:
-    >
-    > - Si el archivo no existe, deberá crearlo en formato `Markdown` imitando la ruta que tiene la versión en inglés.
-    >
-    > - Es posible que el archivo en la versión en español se encuentre en formato `HTML`, en cuyo caso tendrá que reemplazarlo por el formato `Markdown`.
+   > NOTA:
+   >
+   > - Si el archivo no existe, deberá crearlo en formato `Markdown` imitando la ruta que tiene la versión en inglés.
+   >
+   > - Es posible que el archivo en la versión en español se encuentre en formato `HTML`, en cuyo caso tendrá que reemplazarlo por el formato `Markdown`.
 
 3. Utilizar el texto y formato en inglés como guía para traducir al español.
 
@@ -71,16 +71,16 @@ La comunidad de español sugiere utilizar las siguientes convenciones al traduci
 ### Formatos especiales
 
 | Inglés         | Español            |
-|----------------|--------------------|
+| -------------- | ------------------ |
 | `**Note:**`    | `**Nota:**`        |
-| `**Warning:**` | `**Advertencia:**`  |
+| `**Warning:**` | `**Advertencia:**` |
 | `**Callout:**` | `**Observación:**` |
 
 ## Formateo
 
-| Expresión | Como escribirlo |
-| --------- | --------------- |
-| 2<sup>5</sup> | 2^5         |
+| Expresión     | Como escribirlo |
+| ------------- | --------------- |
+| 2<sup>5</sup> | 2^5             |
 
 Actualmente trabajando en: <https://github.com/mdn/translated-content/issues/8635>
 
@@ -118,6 +118,7 @@ Tutorial para crear el ambiente de desarrollo para MDN
 
 Guía de markdown
 <https://developer.mozilla.org/en-US/docs/MDN/Contribute/Markdown_in_MDN>
+
 </details>
 
 Más información [aqui](https://github.com/mdn/translated-content/discussions/4029)

diff --git a/docs/ru/translation-guide.md b/docs/ru/translation-guide.md
@@ -22,19 +22,19 @@
 
 **Пожалуйста, поддерживайте глоссарий в алфавитном порядке.**
 
-| Оригинальный термин | Перевод |
-| ------------------ | ---------- |
-| cache | кеш |
-| feature | возможность (_менее предпочтительный синоним: функциональность_) |
-| functionality | функциональность (или в зависимости от контекста — _возможность_) \* |
-| general knowledge | общие сведения (при использовании в качестве заголовка) |
-| learn more | дополнительные ресурсы (при использовании в качестве заголовка) |
-| listener | обработчик (события) |
-| note | примечание |
-| production | продакшен |
-| render(ing) | рендер, рендерить, отрендерить |
-| see also | смотрите также |
-| technical reference | технические материалы (при использовании в качестве заголовка) |
+| Оригинальный термин | Перевод                                                              |
+| ------------------- | -------------------------------------------------------------------- |
+| cache               | кеш                                                                  |
+| feature             | возможность (_менее предпочтительный синоним: функциональность_)     |
+| functionality       | функциональность (или в зависимости от контекста — _возможность_) \* |
+| general knowledge   | общие сведения (при использовании в качестве заголовка)              |
+| learn more          | дополнительные ресурсы (при использовании в качестве заголовка)      |
+| listener            | обработчик (события)                                                 |
+| note                | примечание                                                           |
+| production          | продакшен                                                            |
+| render(ing)         | рендер, рендерить, отрендерить                                       |
+| see also            | смотрите также                                                       |
+| technical reference | технические материалы (при использовании в качестве заголовка)       |
 
 \* — по возможности лучше избежать прямого перевода, используя синонимы или лучше раскрывая смысл.
 

diff --git a/files/ja/web/api/htmlsourceelement/index.md b/files/ja/web/api/htmlsourceelement/index.md
@@ -1,48 +1,48 @@
 ---
 title: HTMLSourceElement
 slug: Web/API/HTMLSourceElement
+l10n:
+  sourceCommit: 7e6e5f5d4c1c984af3d4ebf9399042d19eccea1e
 ---
 
-{{ApiRef}}
+{{APIRef("HTML DOM")}}
 
-`HTMLSourceElement` インターフェイスは {{htmlelement("source")}} 要素を操作するための (継承によって利用できる、通常の {{domxref("HTMLElement")}} オブジェクトインターフェイスにから見て) 特別なプロパティを提供します。
+**`HTMLSourceElement`** インターフェイスは、（通常の {{domxref("HTMLElement")}} インターフェイスから継承されるもの以外に） {{HtmlElement("source")}} 要素を操作するための特別なプロパティとメソッドを提供します。
 
-{{InheritanceDiagram(600, 120)}}
+{{InheritanceDiagram}}
 
-## プロパティ
+## インスタンスプロパティ
 
-_親である {{domxref("HTMLElement")}} からプロパティを継承しています。_
+_親である {{domxref("HTMLElement")}} から継承したプロパティがあります。_
 
-- {{domxref("HTMLSourceElement.keySystem")}} {{experimental_inline}}
-  - : ストリームを暗号化するキーシステムを説明する {{domxref("DOMString")}} です。
 - {{domxref("HTMLSourceElement.media")}}
-  - : HTML の [`media`](/ja/docs/Web/HTML/Element/source#media) 属性を反映する {{domxref("DOMString")}} で、メディアリソースの意図する型を含みます。
-- {{domxref("HTMLSourceElement.sizes")}} {{experimental_inline}}
-  - : ブレークポイント間の画像の寸法を表す {{domxref("DOMString")}} です。
+  - : 文字列で、HTML の [`media`](/ja/docs/Web/HTML/Element/source#media) 属性を反映し、メディアリソースの意図する型を含みます。
+- {{domxref("HTMLSourceElement.sizes")}}
+  - : 文字列で、ブレークポイント間の画像の寸法を表します。
 - {{domxref("HTMLSourceElement.src")}}
 
-  - : HTML の [`src`](/ja/docs/Web/HTML/Element/source#src) 属性を反映する {{domxref("DOMString")}} で、メディアリソースの URL が入ります。 {{domxref("HTMLSourceElement.src")}} プロパティは関連する {{HTMLElement("source")}} 要素が {{htmlelement("video")}} や {{htmlelement("audio")}} 要素などのメディア要素の中で入れ子になった場合のみ意味を持ちます。 {{HTMLElement("picture")}} 要素の中で入れ子になったときは意味を持たず、無視されます。
+  - : 文字列で、HTML の [`src`](/ja/docs/Web/HTML/Element/source#src) 属性を反映し、メディアリソースの URL が保持します。{{domxref("HTMLSourceElement.src")}} プロパティは関連する {{HTMLElement("source")}} 要素が {{htmlelement("video")}} や {{htmlelement("audio")}} 要素などのメディア要素の中で入れ子になった場合のみ意味を持ちます。 {{HTMLElement("picture")}} 要素の中で入れ子になったときは意味を持たず、無視されます。
 
-    > **メモ:** `src` プロパティが (兄弟要素によって) 更新された場合、親の {{domxref("HTMLMediaElement")}} の `load` メソッドが完了時に呼び出されます。 `<source>` 要素は自動的には再読み込みされないからです。
+    > **メモ:** `src` プロパティが（兄弟要素によって）更新された場合、親の {{domxref("HTMLMediaElement")}} の `load` メソッドが完了時に呼び出されます。`<source>` 要素は自動的には再読み込みされないからです。
 
-- {{domxref("HTMLSourceElement.srcset")}} {{experimental_inline}}
-  - : HTML の [`srcset`](/ja/docs/Web/HTML/Element/source#srcset) 属性を反映する {{domxref("DOMString")}} で、コンマ (`',', U+002C COMMA`) で区切られた画像の候補のリストが入ります。画像の候補は URL の後に `'w'` に続いて画像の幅、または `'x'` に続いてピクセルの密度を指定します。
+- {{domxref("HTMLSourceElement.srcset")}}
+  - : 文字列で、HTML の [`srcset`](/ja/docs/Web/HTML/Element/source#srcset) 属性を反映し、カンマ (`',', U+002C COMMA`) で区切られた画像の候補のリストが入ります。画像の候補は URL の後に `'w'` に続いて画像の幅、または `'x'` に続いてピクセルの密度を指定します。
 - {{domxref("HTMLSourceElement.type")}}
-  - : HTML の [`type`](/ja/docs/Web/HTML/Element/source#type) 属性を反映する {{domxref("DOMString")}} で、メディアリソースの型が入ります。
+  - : 文字列で、HTML の [`type`](/ja/docs/Web/HTML/Element/source#type) 属性を反映し、メディアリソースの型を保持します。
 
-## メソッド
+## インスタンスメソッド
 
-_固有メソッドはありません。 {{domxref("HTMLElement")}} インターフェイスからの継承メソッドが利用可能です。_
+_の固有メソッドはありません。親である {{domxref("HTMLElement")}} から継承したメソッドがあります。_
 
 ## 仕様書
 
 {{Specifications}}
 
 ## ブラウザーの互換性
 
-{{Compat("api.HTMLSourceElement")}}
+{{Compat}}
 
 ## 関連情報
 
-- このインターフェイスを実装する HTML 要素: {{ HTMLElement("source") }}.
-- {{HTMLElement("source")}} 要素を含むことができる要素の HTML DOM API: {{domxref("HTMLVideoElement")}}, {{domxref("HTMLAudioElement")}}, {{domxref("HTMLPictureElement")}}.
+- このインターフェイスを実装する HTML 要素: {{ HTMLElement("source") }}
+- {{HTMLElement("source")}} 要素を含むことができる要素の HTML DOM API: {{domxref("HTMLVideoElement")}}, {{domxref("HTMLAudioElement")}}, {{domxref("HTMLPictureElement")}}
diff --git a/files/ja/web/html/element/small/index.md b/files/ja/web/html/element/small/index.md
@@ -1,18 +1,58 @@
 ---
-title: '<small>: 附随コメント要素'
+title: "<small>: 附随コメント要素"
 slug: Web/HTML/Element/small
+l10n:
+  sourceCommit: 942a529383ee7ee3996fb234187641c08935f3ff
 ---
 
 {{HTMLSidebar}}
 
-**HTML の `<small>` 要素**は、表示上のスタイルとは関係なく、著作権表示や法的表記のような、注釈や小さく表示される文を表します。既定では、 `small` から `x-small` のように、一段階小さいフォントでテキストが表示されます。
+**`<small>`** は [HTML](/ja/docs/Web/HTML) の要素で、スタイルの表現とは独立して、著作権表示や法的表記のような、注釈や小さく表示される文を表します。既定では、 `small` から `x-small` のように、一段階小さいフォントでテキストが表示されます。
 
 {{EmbedInteractiveExample("pages/tabbed/small.html", "tabbed-shorter")}}
 
+## 属性
+
+この要素には[グローバル属性](/ja/docs/Web/HTML/Global_attributes)のみがあります。
+
+## 例
+
+### 基本的な使用
+
+```html
+<p>
+  これは最初の文です。
+  <small>この文は小さい文字で表記されています。</small>
+</p>
+```
+
+#### 結果
+
+{{EmbedLiveSample("Basic_usage")}}
+
+### CSS による代替
+
+```html
+<p>
+  これは最初の文です。
+  <span style="font-size:0.8em">この文は小さい文字で表記されています。</span>
+</p>
+```
+
+#### 結果
+
+{{EmbedLiveSample("CSS_alternative")}}
+
+## 注
+
+`<small>` 要素は {{htmlelement("b")}} 要素や {{htmlelement("i")}} 要素と同様に、構造と表現の分離の原則に反しますが、これら 3 つの要素は HTML で有効です。作者は `<small>` を使用するか CSS を使用するかを決める際に最良の判断を行うよう求められます。
+
+## 技術的概要
+
 <table class="properties">
   <tbody>
     <tr>
-      <th scope="row">コンテンツカテゴリ</th>
+      <th scope="row">コンテンツカテゴリー</th>
       <td>
         <a href="/ja/docs/Web/HTML/Content_categories#フローコンテンツ"
           >フローコンテンツ</a
@@ -64,44 +104,13 @@ slug: Web/HTML/Element/small
   </tbody>
 </table>
 
-## 属性
-
-この要素には[グローバル属性](/ja/docs/Web/HTML/Global_attributes)のみがあります。
-
-## 例
-
-### 基本的な使用
-
-```html
-<p>これは最初の文です。
- <small>この文は小さい文字で表記されています。</small>
-</p>
-```
-
-{{EmbedLiveSample("Basic_usage")}}
-
-### CSS による代替
-
-```html
-<p>これは最初の文です。
-  <span style="font-size:0.8em">この文は小さい文字で表記されています。
-    </span>
-</p>
-```
-
-{{EmbedLiveSample("CSS_alternative")}}
-
 ## 仕様書
 
 {{Specifications}}
 
-## 注
-
-`<small>` 要素は {{htmlelement("b")}} 要素や {{htmlelement("i")}} 要素と同様に、構造と表現の分離の原則に反しますが、これら 3 つの要素は HTML5 で有効です。作者は `<small>` を使用するか CSS を使用するかを決める際に最良の判断を行うよう求められます。
-
 ## ブラウザーの互換性
 
-{{Compat("html.elements.small")}}
+{{Compat}}
 
 ## 関連情報