CSS ルビレイアウトの各文書を更新

- 2021/10/11 時点の英語版に同期

3 files changed, 199 insertions, 202 deletions

diff --git a/files/ja/web/css/css_ruby/index.md b/files/ja/web/css/css_ruby/index.md
index 4e0f0119c1..93693dc1b6 100644
--- a/files/ja/web/css/css_ruby/index.md
+++ b/files/ja/web/css/css_ruby/index.md
@@ -3,55 +3,25 @@ title: CSS ルビレイアウト
 slug: Web/CSS/CSS_Ruby
 tags:
   - CSS
-  - CSS ルビレイアウト
-  - Reference
+  - CSS ルビ
+  - ガイド
   - 概要
+  - Reference
 translation_of: Web/CSS/CSS_Ruby
 ---
-<div>{{CSSRef}}</div>
-
-<p><ruby><strong>CSS ルビレイアウト</strong><rp> (</rp><rt>CSS Ruby Layout</rt><rp>) </rp></ruby>は <a href="/ja/docs/Web/CSS">CSS</a> のモジュールの一つで、ルビ表記の表示に関するレンダリングモデルや整形の制御を提供します。ルビ表記は行間の表記の一種で、ベーステキストに沿った短いテキストで構成されます。これらはふつう東アジアの文書で、発音を示したり、短い説明を提供したりするために使用されます。</p>
-
-<h2 id="Reference" name="Reference">リファレンス</h2>
-
-<h3 id="Properties" name="Properties">プロパティ</h3>
-
-<div class="index">
-<ul>
- <li>{{cssxref("ruby-align")}}</li>
- <li>{{cssxref("ruby-position")}}</li>
-</ul>
-</div>
-
-<h2 id="Specifications" name="Specifications">仕様書</h2>
+{{CSSRef}}
 
-<table class="standard-table">
- <thead>
-  <tr>
-   <th scope="col">仕様書</th>
-   <th scope="col">状態</th>
-   <th scope="col">備考</th>
-  </tr>
- </thead>
- <tbody>
-  <tr>
-   <td>{{SpecName('CSS3 Ruby')}}</td>
-   <td>{{Spec2('CSS3 Ruby')}}</td>
-   <td>初回定義</td>
-  </tr>
- </tbody>
-</table>
+**CSS ルビレイアウト** (CSS Ruby Layout) は [CSS](/ja/docs/Web/CSS) のモジュールの一つで、ルビ表記の表示に関するレンダリングモデルや整形の制御を提供します。ルビ表記は行間の表記の一種で、ベーステキストに沿った短いテキストで構成されます。これらはふつう東アジアの文書で、発音を示したり、短い説明を提供したりするために使用されます。
 
-<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2>
+## リファレンス
 
-<h3 id="ruby-align_プロパティ"><code>ruby-align</code> プロパティ</h3>
+### プロパティ
 
-<div>
-<p>{{Compat("css.properties.ruby-align")}}</p>
+- {{cssxref("ruby-align")}}
+- {{cssxref("ruby-position")}}
 
-<h3 id="ruby-position_プロパティ"><code>ruby-position</code> プロパティ</h3>
+## 仕様書
 
-<div>
-<p>{{Compat("css.properties.ruby-position")}}</p>
-</div>
-</div>
+| 仕様書                    | 状態                   | 備考     |
+| ------------------------- | ---------------------- | -------- |
+| {{SpecName('CSS3 Ruby')}} | {{Spec2('CSS3 Ruby')}} | 初回定義 |
diff --git a/files/ja/web/css/ruby-align/index.md b/files/ja/web/css/ruby-align/index.md
index d50ed7d827..616afedb31 100644
--- a/files/ja/web/css/ruby-align/index.md
+++ b/files/ja/web/css/ruby-align/index.md
@@ -6,13 +6,16 @@ tags:
   - CSS プロパティ
   - CSS ルビ
   - Reference
+  - recipe:css-property
+browser-compat: css.properties.ruby-align
 translation_of: Web/CSS/ruby-align
 ---
-<div>{{CSSRef}}{{SeeCompatTable}}</div>
+{{CSSRef}}
 
-<p>CSS の <code><strong>ruby-align</strong></code> プロパティは、ベースに対するさまざまなルビの配分を定義します。</p>
+**`ruby-align`** は CSS のプロパティで、ベースに対するさまざまなルビの配分を定義します。
 
-<pre class="brush:css no-line-numbers">/* キーワード値 */
+```css
+/* キーワード値 */
 ruby-align: start;
 ruby-align: center;
 ruby-align: space-between;
@@ -21,130 +24,134 @@ ruby-align: space-around;
 /* グローバル値 */
 ruby-align: inherit;
 ruby-align: initial;
+ruby-align: revert;
 ruby-align: unset;
-</pre>
+```
 
-<p>{{cssinfo}}</p>
+## 構文
 
-<h2 id="Syntax" name="Syntax">構文</h2>
+### 値
 
-<h3 id="Values" name="Values">値</h3>
+- `start`
+  - : ルビをベーステキストの始点に揃えることを示すキーワードです。
+- `center`
+  - : ルビをベーステキストの中央に揃えることを示すキーワードです。
+- `space-between`
+  - : ルビの要素の範囲内に配分するよう、スペースを付加することを示すキーワードです。
+- `space-around`
+  - : ルビの要素の範囲内に配分するよう、スペースを付加することを示すキーワードです。また、ルビの周囲にもスペースを付加します。
 
-<dl>
- <dt><code>start</code></dt>
- <dd>ルビをベーステキストの始点に揃えることを示すキーワードです。</dd>
- <dt><code>center</code></dt>
- <dd>ルビをベーステキストの中央に揃えることを示すキーワードです。</dd>
- <dt><code>space-between</code></dt>
- <dd>ルビの要素の範囲内に配分するよう、スペースを付加することを示すキーワードです。</dd>
- <dt><code>space-around</code></dt>
- <dd>ルビの要素の範囲内に配分するよう、スペースを付加することを示すキーワードです。また、ルビの周囲にもスペースを付加します。</dd>
-</dl>
+## 公式定義
 
-<h3 id="Formal_syntax" name="Formal_syntax">形式文法</h3>
+{{cssinfo}}
+
+## 形式文法
 
 {{csssyntax}}
 
-<h2 id="Examples" name="Examples">例</h2>
+## 例
 
-<p>この HTML を、<code>ruby-align</code> のそれぞれの値でレンダリングします。</p>
+<h3 id="Ruby_aligned_at_the_start_of_the_base_text">ルビをベーステキストの先頭に揃える</h3>
 
-<pre class="brush: html">&lt;ruby&gt;
-  &lt;rb&gt;確認用の長いテキスト&lt;/rb&gt;
-  &lt;rp&gt;（&lt;/rp&gt;&lt;rt&gt;短いルビ&lt;/rt&gt;&lt;rp&gt;）&lt;/rp&gt;
-&lt;/ruby&gt;
-</pre>
+#### HTML
 
-<h3 id="Ruby_aligned_at_the_start_of_the_base_text" name="Ruby_aligned_at_the_start_of_the_base_text">ルビをベーステキストの始点に揃える</h3>
+```html
+<ruby>
+  <rb>確認用の長いテキスト</rb>
+  <rp>（</rp><rt>短いルビ</rt><rp>）</rp>
+</ruby>
+```
 
-<pre class="brush: html" style="display: none;">&lt;ruby&gt;
-  &lt;rb&gt;確認用の長いテキスト&lt;/rb&gt;
-  &lt;rp&gt;（&lt;/rp&gt;&lt;rt&gt;短いルビ&lt;/rt&gt;&lt;rp&gt;）&lt;/rp&gt;
-&lt;/ruby&gt;
-</pre>
+#### CSS
 
-<pre class="brush: css">ruby {
+```css
+ruby {
   ruby-align: start;
-}</pre>
+}
+```
+
+#### 結果
 
-<p>結果は以下のとおりです。</p>
+{{EmbedLiveSample("Ruby_aligned_at_the_start_of_the_base_text", 180, 40)}}
 
-<p>{{EmbedLiveSample("Ruby_aligned_at_the_start_of_the_base_text", 180, 40)}}</p>
+<h3 id="Ruby_aligned_at_the_center_of_the_base_text">ルビをベーステキストの中央に揃える</h3>
 
-<h3 id="Ruby_aligned_at_the_center_of_the_base_text" name="Ruby_aligned_at_the_center_of_the_base_text">ルビをベーステキストの中央に揃える</h3>
+#### HTML
 
-<pre class="brush: html" style="display: none;">&lt;ruby&gt;
-  &lt;rb&gt;確認用の長いテキスト&lt;/rb&gt;
-  &lt;rp&gt;（&lt;/rp&gt;&lt;rt&gt;短いルビ&lt;/rt&gt;&lt;rp&gt;）&lt;/rp&gt;
-&lt;/ruby&gt;
-</pre>
+```html
+<ruby>
+  <rb>確認用の長いテキスト</rb>
+  <rp>（</rp><rt>短いルビ</rt><rp>）</rp>
+</ruby>
+```
 
-<pre class="brush: css">ruby {
+#### CSS
+
+```css
+ruby {
   ruby-align: center;
-}</pre>
+}
+```
+
+#### 結果
 
-<p>結果は以下のとおりです。</p>
+{{EmbedLiveSample("Ruby_aligned_at_the_center_of_the_base_text", 180, 40)}}
 
-<p>{{EmbedLiveSample("Ruby_aligned_at_the_center_of_the_base_text", 180, 40)}}</p>
+<h3 id="Extra_space_distributed_between_ruby_elements">ルビ要素の範囲内にスペースを配分する</h3>
 
-<h3 id="Extra_space_distributed_between_ruby_elements" name="Extra_space_distributed_between_ruby_elements">ルビ要素の範囲内にスペースを配分する</h3>
+#### HTML
 
-<pre class="brush: html" style="display: none;">&lt;ruby&gt;
-  &lt;rb&gt;確認用の長いテキスト&lt;/rb&gt;
-  &lt;rp&gt;（&lt;/rp&gt;&lt;rt&gt;短いルビ&lt;/rt&gt;&lt;rp&gt;）&lt;/rp&gt;
-&lt;/ruby&gt;
-</pre>
+```html
+<ruby>
+  <rb>確認用の長いテキスト</rb>
+  <rp>（</rp><rt>短いルビ</rt><rp>）</rp>
+</ruby>
+```
 
-<pre class="brush: css">ruby {
+#### CSS
+
+```css
+ruby {
   ruby-align: space-between;
-}</pre>
+}
+```
+
+#### 結果
+
+{{EmbedLiveSample("Extra_space_distributed_between_ruby_elements", 180, 40)}}
 
-<p>結果は以下のとおりです。</p>
+<h3 id="Extra_space_distributed_between_and_around_ruby_elements">ルビ要素内および周囲にスペースを配分する</h3>
 
-<p>{{EmbedLiveSample("Extra_space_distributed_between_ruby_elements", 180, 40)}}</p>
+#### HTML
 
-<h3 id="Extra_space_distributed_between_and_around_ruby_elements" name="Extra_space_distributed_between_and_around_ruby_elements">ルビ要素内および周囲にスペースを配分する</h3>
+```html
+<ruby>
+  <rb>確認用の長いテキスト</rb>
+  <rp>（</rp><rt>短いルビ</rt><rp>）</rp>
+</ruby>
+```
 
-<pre class="brush: html" style="display: none;">&lt;ruby&gt;
-  &lt;rb&gt;確認用の長いテキスト&lt;/rb&gt;
-  &lt;rp&gt;（&lt;/rp&gt;&lt;rt&gt;短いルビ&lt;/rt&gt;&lt;rp&gt;）&lt;/rp&gt;
-&lt;/ruby&gt;
-</pre>
+#### CSS
 
-<pre class="brush: css">ruby {
+```css
+ruby {
   ruby-align: space-around;
-}</pre>
+}
+```
 
-<p>結果は以下のとおりです。</p>
+#### 結果
 
-<p>{{EmbedLiveSample("Extra_space_distributed_between_and_around_ruby_elements", 180, 40)}}</p>
+{{EmbedLiveSample("Extra_space_distributed_between_and_around_ruby_elements", 180, 40)}}
 
-<h2 id="Specifications" name="Specifications">仕様書</h2>
+## 仕様書
 
-<table class="standard-table">
- <thead>
-  <tr>
-   <th scope="col">仕様書</th>
-   <th scope="col">状態</th>
-   <th scope="col">備考</th>
-  </tr>
- </thead>
- <tbody>
-  <tr>
-   <td>{{SpecName('CSS3 Ruby', '#ruby-align-property', 'ruby-align')}}</td>
-   <td>{{Spec2('CSS3 Ruby')}}</td>
-   <td>初回定義</td>
-  </tr>
- </tbody>
-</table>
+{{Specifications}}
 
-<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2>
+## ブラウザーの互換性
 
-<p>{{Compat("css.properties.ruby-align")}}</p>
+{{Compat}}
 
-<h2 id="See_also" name="See_also">関連情報</h2>
+## 関連情報
 
-<ul>
- <li>HTML のルビ関連要素: {{HTMLElement("ruby")}}, {{HTMLElement("rt")}}, {{HTMLElement("rp")}}, {{HTMLElement("rtc")}}</li>
- <li>CSS のルビ関連プロパティ: {{cssxref("ruby-position")}}, {{cssxref("ruby-merge")}}</li>
-</ul>
+- HTML のルビ関連要素: {{HTMLElement("ruby")}}, {{HTMLElement("rt")}}, {{HTMLElement("rp")}}, {{HTMLElement("rtc")}}
+- CSS のルビ関連プロパティ: {{cssxref("ruby-position")}}, {{cssxref("ruby-merge")}}
diff --git a/files/ja/web/css/ruby-position/index.md b/files/ja/web/css/ruby-position/index.md
index 6cb66cd58d..dc12a3ee96 100644
--- a/files/ja/web/css/ruby-position/index.md
+++ b/files/ja/web/css/ruby-position/index.md
@@ -5,111 +5,131 @@ tags:
   - CSS
   - CSS プロパティ
   - CSS ルビ
-  - リファレンス
+  - Reference
+  - recipe:css-property
+browser-compat: css.properties.ruby-position
 translation_of: Web/CSS/ruby-position
 ---
-<div>{{CSSRef}}{{SeeCompatTable}}</div>
+{{CSSRef}}
 
-<p>CSS の <code><strong>ruby-position</strong></code> プロパティは、ベース要素に対するルビ要素の位置を定義します。要素の上方 (<code>over</code>)、下方 (<code>under</code>)、文字の間の右側 (<code>inter-character</code>) に配置できます。</p>
+**`ruby-position`** は CSS のプロパティで、ベース要素に対するルビ要素の位置を定義します。要素の上方 (`over`)、下方 (`under`)、文字の間の右側 (`inter-character`) に配置できます。
 
-<pre class="brush:css">/* キーワード値 */
+## 構文
+
+```css
+/* キーワード値 */
 ruby-position: over;
 ruby-position: under;
 ruby-position: inter-character;
+ruby-position: alternate;
 
 /* グローバル値 */
 ruby-position: inherit;
 ruby-position: initial;
+ruby-position: revert;
 ruby-position: unset;
-</pre>
+```
 
-<p>{{cssinfo}}</p>
+### 値
 
-<h2 id="Syntax" name="Syntax">構文</h2>
+- `over`
+  - : ![over の例](screen_shot_2015-03-04_at_13.02.20.png)ルビを主テキストの上 (横書きの場合) または右 (縦書きの場合) に配置することを示すキーワードです。
+- `under`
+  - : ![under の例](screen_shot_2015-03-04_at_13.02.07.png)ルビを主テキストの下 (横書きの場合) または左 (縦書きの場合) に配置することを示すキーワードです。
+- `inter-character`
+  - : ルビをそれぞれの文字の間に配置することを示すキーワードです。
+- `alternate`
+  - : 複数のレベルの注釈があった場合に、ルビが上と下の間で交互に表示されることを示すキーワードです。
 
-<h3 id="Values" name="Values">値</h3>
+## 公式定義
 
-<dl>
- <dt><code>over</code></dt>
- <dd><img alt="over の例" src="https://mdn.mozillademos.org/files/10251/Screen%20Shot%202015-03-04%20at%2013.02.20.png" style="height: 31px; width: 77px;">ルビをメインテキストの上 (横書きの場合) または右 (縦書きの場合) に配置することを示すキーワードです。</dd>
- <dt><code>under</code></dt>
- <dd><img alt="under の例" src="https://mdn.mozillademos.org/files/10249/Screen%20Shot%202015-03-04%20at%2013.02.07.png" style="height: 34px; width: 78px;">ルビをメインテキストの下 (横書きの場合) または左 (縦書きの場合) に配置することを示すキーワードです。</dd>
- <dt><code>inter-character</code></dt>
- <dd>ルビをそれぞれの文字の間に配置することを示すキーワードです。</dd>
-</dl>
+{{cssinfo}}
 
-<h3 id="Formal_syntax" name="Formal_syntax">形式文法</h3>
+## 形式文法
 
 {{csssyntax}}
 
-<h2 id="Examples" name="Examples">例</h2>
+## 例
+
+<h3 id="Ruby_positioned_over_the_text">テキストの上に配置したルビ</h3>
+
+#### HTML
+
+```html
+<ruby>
+  <rb>超電磁砲</rb>
+  <rp>（</rp><rt>レールガン</rt><rp>）</rp>
+</ruby>
+```
+
+#### CSS
+
+```css
+ruby {
+    ruby-position:over;
+}
+```
+
+#### 結果
+
+{{EmbedLiveSample("Ruby_positioned_over_the_text", 100, 40)}}
+
+<h3 id="Ruby_positioned_under_the_text">テキストの下に配置したルビ</h3>
+
+#### HTML
 
-<p>この HTML は、 <code>ruby-position</code> のそれぞれの値でレンダリングします。</p>
+```html
+<ruby>
+  <rb>超電磁砲</rb>
+  <rp>（</rp><rt>レールガン</rt><rp>）</rp>
+</ruby>
+```
 
-<pre class="brush: html">&lt;ruby&gt;
-  &lt;rb&gt;超電磁砲&lt;/rb&gt;
-  &lt;rp&gt;（&lt;/rp&gt;&lt;rt&gt;レールガン&lt;/rt&gt;&lt;rp&gt;）&lt;/rp&gt;
-&lt;/ruby&gt;
-</pre>
+#### CSS
 
-<h3 id="Ruby_positioned_over_the_text" name="Ruby_positioned_over_the_text">テキストの上に配置したルビ</h3>
+```css
+ruby {
+    ruby-position:under;
+}
+```
 
-<pre class="brush: html" style="display: none;">&lt;ruby&gt;
-  &lt;rb&gt;超電磁砲&lt;/rb&gt;
-  &lt;rp&gt;（&lt;/rp&gt;&lt;rt&gt;レールガン&lt;/rt&gt;&lt;rp&gt;）&lt;/rp&gt;
-&lt;/ruby&gt;
-</pre>
+#### 結果
 
-<pre class="brush: css">ruby {
-    ruby-position:over;
-}</pre>
+{{EmbedLiveSample("Ruby_positioned_under_the_text", 100, 40)}}
 
-<p>結果は以下のとおりです。</p>
+<h3 id="Ruby_alternate">交互のルビ</h3>
 
-<p>{{EmbedLiveSample("Ruby_positioned_over_the_text", 100, 40)}}</p>
+#### HTML
 
-<h3 id="Ruby_positioned_under_the_text" name="Ruby_positioned_under_the_text">テキストの下に配置したルビ</h3>
+```html
+<ruby>
+  <rb>A<rb>B<rb>C</rb>
+  <rtc>Above</rtc>
+  <rtc>Below</rtc>
+</ruby>
+```
 
-<pre class="brush: html" style="display: none;">&lt;ruby&gt;
-  &lt;rb&gt;超電磁砲&lt;/rb&gt;
-  &lt;rp&gt;（&lt;/rp&gt;&lt;rt&gt;レールガン&lt;/rt&gt;&lt;rp&gt;）&lt;/rp&gt;
-&lt;/ruby&gt;
-</pre>
+#### CSS
 
-<pre class="brush: css">ruby {
-    ruby-position:under;
-}</pre>
+```css
+ruby {
+    ruby-position: alternate; /* 初期値でもある */
+}
+```
 
-<p>結果は以下のとおりです。</p>
+#### 結果
 
-<p>{{EmbedLiveSample("Ruby_positioned_under_the_text", 100, 40)}}</p>
+{{EmbedLiveSample("Ruby_alternate", 100, 40)}}
 
-<h2 id="Specifications" name="Specifications">仕様書</h2>
+## 仕様書
 
-<table class="standard-table">
- <thead>
-  <tr>
-   <th scope="col">仕様書</th>
-   <th scope="col">状態</th>
-   <th scope="col">備考</th>
-  </tr>
- </thead>
- <tbody>
-  <tr>
-   <td>{{SpecName('CSS3 Ruby', '#rubypos', 'ruby-position')}}</td>
-   <td>{{Spec2('CSS3 Ruby')}}</td>
-   <td>初回定義</td>
-  </tr>
- </tbody>
-</table>
+{{Specifications}}
 
-<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2>
+## ブラウザーの互換性
 
-<p>{{Compat("css.properties.ruby-position")}}</p>
+{{Compat}}
 
-<h2 id="See_also" name="See_also">関連情報</h2>
+## 関連情報
 
-<ul>
- <li>HTML のルビ関連要素: {{HTMLElement("ruby")}}, {{HTMLElement("rt")}}, {{HTMLElement("rp")}}, {{HTMLElement("rtc")}}</li>
- <li>CSS のルビ関連プロパティ: {{cssxref("ruby-align")}}, {{cssxref("ruby-merge")}}</li>
-</ul>
+- HTML のルビ関連要素: {{HTMLElement("ruby")}}, {{HTMLElement("rt")}}, {{HTMLElement("rp")}}, {{HTMLElement("rtc")}}
+- CSS のルビ関連プロパティ: {{cssxref("ruby-align")}}, {{cssxref("ruby-merge")}}