[css-ruby] Solve bikeshed link warnings

Author: frivoal

css-ruby-1/Overview.bs

@@ -117,9 +117,9 @@ What is ruby?</h3>
 		the spacing between these Kanji characters is adjusted.
 		(This happens around the fourth Kanji character in the figure above.)
 		To avoid variable spacing between the Kanji characters in the example above
-		the hiragana annotations can be styled as a <i>collapsed annotation</i>,
+		the hiragana annotations can be styled as a [=collapsed annotation=],
 		which will look more like the group-ruby example earlier.
-		However because the base-annotation pairings are recorded in the ruby structure,
+		However because the base-annotation [=pairings=] are recorded in the ruby structure,
 		if the text breaks across lines, the annotation characters will stay
 		correctly paired with their respective base characters.
 	</div>
@@ -141,14 +141,14 @@ Ruby Box Model</h2>
 	one or more <i>ruby base</i> elements representing the base (annotated) text,
 	associated with one or more levels of <i>ruby annotation</i> elements representing the annotations.
 	The structure of ruby is similar to that of a table:
-	there are “rows” (the <i lt="base level">base text level</i>, each <i>annotation level</i>)
+	there are “rows” (the [=base text level=], each [=annotation level=])
 	and “columns” (each <i>ruby base</i> and its corresponding <i>ruby annotations</i>).
 
-	<p>Consecutive bases and annotations are grouped together into <i>ruby segments</i>.
-	Within a <i>ruby segment</i>, a <i>ruby annotation</i> may span multiple <i>ruby bases</i>.
+	<p>Consecutive bases and annotations are grouped together into [=ruby segments=].
+	Within a [=ruby segment=], a <i>ruby annotation</i> may span multiple <i>ruby bases</i>.
 
-	<p class="note">In HTML, a single <code>&lt;ruby&gt;</code> element may contain multiple <i>ruby segments</i>.
-	(In the XHTML Ruby model, a single <code>&lt;ruby&gt;</code> element can only contain one <i>ruby segment</i>.)
+	<p class="note">In HTML, a single <code>&lt;ruby&gt;</code> element may contain multiple [=ruby segments=].
+	(In the XHTML Ruby model, a single <code>&lt;ruby&gt;</code> element can only contain one [=ruby segment=].)
 
 <h3 id="ruby-display">
 Ruby-specific 'display' Values</h3>
@@ -298,16 +298,16 @@ Anonymous Ruby Box Generation</h3>
 			as described below.
 
 		<li id="anony-gen-trim-space"><strong>Trim leading/trailing white space:</strong>
-			Any <i>intra-ruby white space</i>
+			Any [=intra-ruby white space=]
 			that is not the sole child of its parent
 			and occurs at the beginning or end of
 			a <i>ruby container</i>, <i>ruby annotation container</i>, or <i>ruby base container</i>
 			is removed, as if it had ''display: none''
 
 		<li id="anon-gen-discard-space"><strong>Remove inter-level white space:</strong>
-			Any <i>intra-ruby white space</i>
+			Any [=intra-ruby white space=]
 			whose immediately adjacent siblings match one of the patterns below
-			is <dfn>inter-level white space</dfn>
+			is <dfn noexport>inter-level white space</dfn>
 			and is removed, as if it had ''display: none''.
 			<table class="data">
 			<thead>
@@ -331,7 +331,7 @@ Anonymous Ruby Box Generation</h3>
 			</table>
 
 		<li id="anon-gen-interpret-space"><strong>Interpret intra-level white space:</strong>
-			Any <i>intra-ruby white space</i> box
+			Any [=intra-ruby white space=] box
 			whose immediately adjacent siblings match one of the patterns below
 			is assigned the box type and subtype defined in the table below:
 			<table class="data">
@@ -361,7 +361,7 @@ Anonymous Ruby Box Generation</h3>
 				    <td><i>ruby base</i> or <i>ruby base container</i>
 			</table>
 			The <dfn>intra-level white space</dfn> boxes defined above are
-			treated specially for pairing and layout. See below.
+			treated specially for [=pairing=] and layout. See below.
 
 		<li id="anon-gen-unbreak"><strong>Suppress line breaks:</strong>
 			Convert all forced line breaks inside <i>ruby annotations</i> (regardless of 'white-space' value)
@@ -371,10 +371,10 @@ Anonymous Ruby Box Generation</h3>
 
 		<li id="anon-gen-anon-containers"><strong>Generate anonymous level containers:</strong>
 			Any consecutive sequence of <i>ruby bases</i> and <i>inter-base white space</i>
-			(and not <i>inter-segment white space</i>)
+			(and not [=inter-segment white space=])
 			not parented by a <i>ruby base container</i>
 			is wrapped in an anonymous <i>ruby base container</i>.
-			Similarly, any consecutive sequence of <i>ruby annotations</i> and <i>inter-annotation white space</i>
+			Similarly, any consecutive sequence of <i>ruby annotations</i> and [=inter-annotation white space=]
 			not parented by a <i>ruby annotation container</i>
 			is wrapped in an anonymous <i>ruby annotation container</i>.
 	</ol>
@@ -386,9 +386,9 @@ Anonymous Ruby Box Generation</h3>
 
 	<p class="note">
 	Note that the UA is not required to create any of these anonymous boxes
-	(or the anonymous empty <i>intra-level white space</i> boxes in the pairing section)
+	(or the anonymous empty [=intra-level white space=] boxes in [[#ruby-pairing]])
 	in its internal structures,
-	as long as pairing and layout behaves as if they existed.
+	as long as [=pairing=] and layout behaves as if they existed.
 
 <h3 id="ruby-pairing">
 Annotation Pairing</h3>
@@ -397,18 +397,18 @@ Annotation Pairing</h3>
 	<i>ruby annotations</i> with <i>ruby bases</i>.
 	Each <i>ruby annotation</i> is associated with one or more <i>ruby bases</i>,
 	and is said to <dfn>span</dfn> those bases.
-	(A <i>ruby annotation</i> that <i>spans</i> multiple bases is called
+	(A <i>ruby annotation</i> that [=spans=] multiple bases is called
 	a <dfn>spanning annotation</dfn>.)
 
 	A <i>ruby base</i> is can be associated with
-	only one <i>ruby annotation</i> per <i>annotation level</i>.
-	However, if there are multiple <i>annotation levels</i>,
+	only one <i>ruby annotation</i> per [=annotation level=].
+	However, if there are multiple [=annotation levels=],
 	it can be associated with multiple <i>ruby annotations</i>.
 
-	Once pairing is complete, ruby “column” units are defined,
+	Once [=pairing=] is complete, ruby “column” units are defined,
 	each represented by a single <i>ruby base</i>
 	and one <i>ruby annotation</i> (possibly an empty, anonymous one)
-	from each <i>annotation level</i> in its <i>ruby segment</i>.
+	from each [=annotation level=] in its [=ruby segment=].
 
 
 <h4 id="segment-pairing">
@@ -417,12 +417,12 @@ Segment Pairing and Annotation Levels</h4>
 	<p>A ruby structure is divided into <dfn>ruby segments</dfn>,
 	each consisting of a single <i>ruby base container</i>
 	followed by one or more <i>ruby annotation containers</i>.
-	Each <i>ruby annotation container</i> in a <i>ruby segment</i>
+	Each <i>ruby annotation container</i> in a [=ruby segment=]
 	represents one <dfn lt="annotation level | level">level</dfn> of annotation for the base text:
 	the first one represents the first level of annotation,
 	the second one represents the second level of annotation,
 	and so on.
-	The <i>ruby base container</i> represents the <dfn>base level</dfn>.
+	The <i>ruby base container</i> represents the <dfn lt="base level | base text level">base level</dfn>.
 	The <i>ruby base container</i> in each segment is thus paired
 	with each of the <i>ruby annotation containers</i> in that segment.
 
@@ -434,20 +434,20 @@ Segment Pairing and Annotation Levels</h4>
 		anonymous, empty <i>ruby annotation containers</i> are assumed to exist between them.
 	</ul>
 
-	<p><i>Inter-segment white space</i> is effectively a <i>ruby segment</i> of its own.
+	<p><i>Inter-segment white space</i> is effectively a [=ruby segment=] of its own.
 
 <h4 id="base-annotation-pairing">
 Unit Pairing and Spanning Annotations</h4>
 
-	<p>Within a <i>ruby segment</i>,
+	<p>Within a [=ruby segment=],
 	each <i>ruby base</i> in the <i>ruby base container</i>
 	is paired with one <i>ruby annotation</i>
-	from each <i>ruby annotation container</i> in its <i>ruby segment</i>.
+	from each <i>ruby annotation container</i> in its [=ruby segment=].
 
 	<p>If a <i>ruby annotation container</i> contains only
 	a single, anonymous <i>ruby annotation</i>,
-	then that <i>ruby annotation</i> is paired with (i.e. <i>spans</i> across)
-	all of the <i>ruby bases</i> in its <i>ruby segment</i>.
+	then that <i>ruby annotation</i> is paired with (i.e. [=spans=] across)
+	all of the <i>ruby bases</i> in its [=ruby segment=].
 
 	<p>Otherwise, each <i>ruby annotation</i> is paired,
 	in order, with the corresponding <i>ruby base</i> in that segment</i>.
@@ -460,22 +460,22 @@ Unit Pairing and Spanning Annotations</h4>
 
 	<p>If an implementation supports ruby markup with explicit spanning
 	(e.g. XHTML Complex Ruby Annotations),
-	it must adjust the pairing rules to pair <i>spanning annotations</i>
+	it must adjust the [=pairing=] rules to pair [=spanning annotations=]
 	to their bases appropriately.
 
-	<p><i>Intra-level white space</i> does not participate in standard annotation <i>pairing</i>.
+	<p><i>Intra-level white space</i> does not participate in standard annotation [=pairing=].
 	However, if the immediately-adjacent <i>ruby bases</i> or <i>ruby annotations</i>
 	are paired
 	<ul>
 		<li>with two <i>ruby bases</i> or <i lt="ruby annotations">annotations</i>
-		that surround corresponding <i>intra-level white space</i> in another level,
-		then the so-corresponding <i>intra-level white space</i> boxes are also paired.
+		that surround corresponding [=intra-level white space=] in another level,
+		then the so-corresponding [=intra-level white space=] boxes are also paired.
 		<li>with a single spanning <i>ruby annotation</i>,
-		then the <i>intra-level white space</i> is also paired to that <i>ruby annotation</i>
+		then the [=intra-level white space=] is also paired to that <i>ruby annotation</i>
 		<li>with two <i>ruby bases</i> or <i lt="ruby annotations">annotations</i>
-		with no intervening <i>intra-level white space</i>,
-		then the <i>intra-level white space</i> box pairs with
-		an anonymous empty <i>intra-level white space</i> box assumed to exist between them.
+		with no intervening [=intra-level white space=],
+		then the [=intra-level white space=] box pairs with
+		an anonymous empty [=intra-level white space=] box assumed to exist between them.
 	</ul>
 
 	<p class="issue">Insert diagram</p>
@@ -484,15 +484,15 @@ Unit Pairing and Spanning Annotations</h4>
 Complex Spanning with Nested Ruby</h4>
 
 	<p>When <i>ruby containers</i> are <dfn lt="nested ruby">nested</dfn>,
-	pairing begins with the deepest <i>ruby container</i>,
+	[=pairing=] begins with the deepest <i>ruby container</i>,
 	then expands out.
-	From the pairing perspective of the outer <i>ruby container</i>,
+	From the [=pairing=] perspective of the outer <i>ruby container</i>,
 	each <i>ruby container</i> nested within another <i>ruby container</i>
 	counts as representing a single <i>ruby base</i>/<i>annotation</i> per level.
-	The outer <i>ruby container</i>’s <i>ruby annotations</i> paired to the <i>nested ruby</i>
-	are therefore paired with (and <i>span</i>) all of the nested <i>ruby container</i>’s <i>ruby bases</i>.
+	The outer <i>ruby container</i>’s <i>ruby annotations</i> paired to the [=nested ruby=]
+	are therefore paired with (and [=span=]) all of the nested <i>ruby container</i>’s <i>ruby bases</i>.
 	Each <i>ruby annotation container</i> in the nested <i>ruby container</i>
-	occupies the same <i>annotation level</i> in the outer <i>ruby container</i>
+	occupies the same [=annotation level=] in the outer <i>ruby container</i>
 	as it does in the inner one
 	and participates in its layout as if it were directly contained in the outer <i>ruby container</i>.
 
@@ -509,13 +509,13 @@ Autohiding Base-identical Annotations</h3>
 
 	<p>If a <i>ruby annotation</i> has the exact same text content as its base,
 	it is <dfn lt="hidden ruby annotation | hidden annotation">hidden</dfn>.
-	Hiding a <i>ruby annotation</i> does not affect annotation pairing
-	or the block-axis positioning of boxes in other <i>levels</i>.
-	However the <i>hidden annotation</i> is not visible,
+	Hiding a <i>ruby annotation</i> does not affect annotation [=pairing=]
+	or the block-axis positioning of boxes in other [=levels=].
+	However the [=hidden annotation=] is not visible,
 	and it has no impact on layout
 	other than to separate adjacent sequences of <i>ruby annotation boxes</i> within its level,
 	as if they belonged to separate segments
-	and the <i>hidden annotation</i>’s base were not a <i>ruby base</i> but an intervening inline.
+	and the [=hidden annotation=]’s base were not a <i>ruby base</i> but an intervening inline.
 
 	<div class="example">
 		<p>This is to allow correct inlined display of annotations
@@ -571,12 +571,12 @@ White Space Collapsing</h3>
 <!--		-->&lt;/ruby></pre>
 	</div>
 
-	<p>Between <i>ruby segments</i>, between <i>ruby bases</i>, and between <i>ruby annotations</i>, however,
+	<p>Between [=ruby segments=], between <i>ruby bases</i>, and between <i>ruby annotations</i>, however,
 	white space is not discarded,
 	and is maintained for rendering
-	as <i lt="inter-base white space">inter-base</i>,
-	<i lt="inter-annotation white space">inter-annotation</i>,
-	or <i>inter-segment white space</i>.
+	as [=inter-base white space|inter-base=],
+	[=inter-annotation white space|inter-annotation=],
+	or [=inter-segment white space=].
 	(See <a href="#box-fixup">Anonymous Ruby Box Generation</a>, above.)
 
 	<div class="example">
@@ -597,7 +597,7 @@ White Space Collapsing</h3>
 
 	<p>Where undiscarded white space is <i>collapsible</i>, it will collapse
 	following the standard <a href="https://www.w3.org/TR/css3-text/#white-space-rules">white space processing rules</a>. [[!CSS3TEXT]]
-	For <i>collapsible white space</i> between <i>ruby segments</i> (<i>inter-segment white space</i>), however,
+	For <i>collapsible white space</i> between [=ruby segments=] ([=inter-segment white space=]), however,
 	the contextual text for determining collapsing behavior is given by the <i>ruby bases</i> on either side,
 	not the text on either side of the white space in source document order.
 
@@ -625,13 +625,13 @@ White Space Collapsing</h3>
 Ruby Layout</h2>
 
 	<p>When a ruby structure is laid out,
-	its <i>base level</i> is laid out on the line,
+	its [=base level=] is laid out on the line,
 	aligned according to its 'vertical-align' property
 	exactly as if its <i>ruby bases</i> were a regular sequence of inline boxes.
 	Each <i>ruby base container</i> is sized and positioned
 	to contain exactly all of its <i>ruby bases</i>’ margin boxes.
 
-	<p><i>Ruby annotations</i> associated with the <i>base level</i>
+	<p><i>Ruby annotations</i> associated with the [=base level=]
 	are then positioned with respect to their <i>ruby base boxes</i>
 	according to the applicable 'ruby-position' values.
 	<i>Ruby annotations</i> within a level (within a single <i>ruby container</i>)
@@ -652,7 +652,7 @@ Ruby Layout</h2>
 	measures as wide as the content of its widest level.
 	Similarly, <i>ruby base boxes</i> and <i>ruby annotation boxes</i>
 	within a ruby “column” have the measure of the widest content in that “column”.
-	In the case of <i>spanning annotations</i>
+	In the case of [=spanning annotations=]
 	(whether actually spanning or pretending to span per 'ruby-merge'),
 	the measures of the <i>ruby annotation box</i> and
 	the sum of its associated <i>ruby base boxes</i> must match.
@@ -670,7 +670,7 @@ Inter-character Ruby Layout</h3>
 	<p>Inter-character annotations have special layout.
 	When 'ruby-position' indicates ''inter-character'' annotations,
 	the affected <i>ruby annotation boxes</i>
-	are spliced into and measured as part of the layout of the <i>base level</i>.
+	are spliced into and measured as part of the layout of the [=base level=].
 	The <i>ruby base container</i> must be sized to include both the <i>ruby base boxes</i>
 	as well as the ''inter-character'' <i>ruby annotation boxes</i>.
 	The affected <i>ruby annotation container</i> is similarly sized
@@ -733,7 +733,7 @@ Breaking Between Bases</h4>
 	<p>Whether ruby can break between two adjacent <i>ruby bases</i>
 	is controlled by normal line-breaking rules for the base text,
 	exactly as if the <i>ruby bases</i> were adjacent inline boxes.
-	(The annotations are ignored when determining soft wrap opportunities for the <i>base level</i>.)
+	(The annotations are ignored when determining soft wrap opportunities for the [=base level=].)
 
 	<div class="example">
 		<p>For example, if two adjacent ruby bases are “蝴” and “蝶”,
@@ -806,7 +806,7 @@ Bidi Reordering</h3>
 				so authors will need to ensure that the <i>ruby container</i>’s declared directionality
 				does indeed match its contents.
 		<li>
-			During layout, <i>ruby segments</i> are ordered within the <i>ruby container</i>
+			During layout, [=ruby segments=] are ordered within the <i>ruby container</i>
 			by the 'direction' property of their <i>ruby container</i>.
 		<li>
 			Within a segment, <i>ruby bases</i> and <i>ruby annotations</i>
@@ -1004,7 +1004,7 @@ Sharing Annotation Space: the 'ruby-merge' property</h3>
 		<dt><dfn>collapse</dfn>
 		<dd>
 			<p>
-				All <i>ruby annotation boxes</i> within the same <i>ruby segment</i> on the same line are concatenated,
+				All <i>ruby annotation boxes</i> within the same [=ruby segment=] on the same line are concatenated,
 				and laid out as if their contents belonged to a single <i>ruby annotation box</i>
 				spanning all their associated <i>ruby base boxes</i>.
 				This style renders similar to “group ruby” in [[JLREQ]],
@@ -1139,7 +1139,7 @@ Ruby Text Distribution: the 'ruby-align' property</h3>
 		</dd>
 	</dl>
 
-	<p class="issue">Add a paragraph explaining how to distribute space in situations with spanning annotations.
+	<p class="issue">Add a paragraph explaining how to distribute space in situations with [=spanning annotations=].
 <!--
 	<p>For a complex ruby with spanning elements, one additional consideration is
 		required. If the spanning element spans multiple 'rows' (other rbc or rtc
@@ -1170,7 +1170,7 @@ Ruby Text Decoration</h3>
 	with overline and underline decorations applied to the base text.
 	In the basic case of consistent font size and baseline alignment,
 	an underline or overline is positioned
-	between the base level and any annotations on that side.
+	between the [=base level=] and any annotations on that side.
 
 	<p class="issue">This section needs some clarification about
 	drawing decorations between the content of adjacent bases/annotations.
@@ -1570,7 +1570,7 @@ Changes since the 5 August 2014 WD</h3>
 	<li>Tweak the <a href="#default-stylesheet">default style sheet</a>.
 	<li>Add section on <a href="#ruby-text-decoration">text decoration</a>.
 	<li>Defer the <css>right</css> and <css>left</css> values of 'ruby-position' to the next level.
-	<li>Change ruby pairing rules to only operate on anonymous annotations (i.e. content directly contained by an <{rtc}>).
+	<li>Change ruby [=pairing=] rules to only operate on anonymous annotations (i.e. content directly contained by an <{rtc}>).
 	<li>Apply 'ruby-position' to ''::first-line''.
 		(<a href="https://github.com/w3c/csswg-drafts/issues/2998">Issue 2998</a>)
 </ul>
@@ -1580,8 +1580,8 @@ Changes since the 19 September 2013 WD</h3>
 
 	<ul>
 		<li>Rewrite anonymous box generation rules and white space handling rules,
-		defined specialized pairing of anonymous white space boxes.
-		<li>Take nested ruby handling out of pairing.
+		defined specialized [=pairing=] of anonymous white space boxes.
+		<li>Take [=nested ruby=] handling out of [=pairing=].
 		(Will be handling it via sizing/layout.)
 		<li>Define bidi layout of ruby structures.
 	</ul>
@@ -1646,7 +1646,7 @@ Changes since the 19 September 2013 WD</h3>
 
 				<dt>Wrote anonymous box generation rules
 
-				<dd> And defined pairing of bases and annotations. Should now handle all
+				<dd> And defined [=pairing=] of bases and annotations. Should now handle all
 				 the crazy proposed permutations of HTML ruby markup.
 
 				<dt>Defined layout of ruby