[css-grid-2] More cross-linking.

Author: fantasai

css-grid-2/Overview.bs

@@ -1494,7 +1494,7 @@ Explicit Track Sizing: the 'grid-template-rows' and 'grid-template-columns' prop
 
 	These properties specify,
 	as a space-separated <dfn export>track list</dfn>,
-	the line names and <a>track sizing functions</a> of the <a>grid</a>.
+	the [=line names=] and <a>track sizing functions</a> of the <a>grid</a>.
 	The 'grid-template-columns' property specifies the <a>track list</a> for the grid's columns,
 	while 'grid-template-rows' specifies the <a>track list</a> for the grid's rows.
 
@@ -1512,7 +1512,7 @@ Explicit Track Sizing: the 'grid-template-rows' and 'grid-template-columns' prop
 		<dt><dfn id="track-listing"><<track-list>> | <<auto-track-list>></dfn>
 		<dd>
 			Specifies the <a>track list</a> as a series of <a>track sizing functions</a>
-			and line names.
+			and [=line names=].
 			Each <dfn dfn lt="track sizing function|sizing function">track sizing function</dfn> can be specified as a length,
 			a percentage of the <a>grid container</a>’s size,
 			a measurement of the contents occupying the column or row,
@@ -1525,26 +1525,28 @@ Explicit Track Sizing: the 'grid-template-rows' and 'grid-template-columns' prop
 		<dt><dfn id="subgrid-listing">subgrid <<line-name-list>>?</dfn>
 		<dd>
 			The <dfn value for="grid-template-rows, grid-template-columns">subgrid</dfn> value
-			indicates that the grid will adopt the spanned portion of its parent grid in that axis
+			indicates that the grid will adopt the spanned portion
+			of its [=parent grid=] in that axis
 			(the <dfn dfn for local-lt="subgridded">subgridded axis</dfn>).
 			Rather than being specified explicitly,
 			the sizes of the grid rows/columns
-			will be taken from the parent grid's definition,
+			will be taken from the [=parent grid=]'s definition,
 			and the <a>subgrid</a>’s items will participate
 			in the <a href="https://www.w3.org/TR/css-grid-1/#algo-content">intrinsic size calculations</a> ([[css-grid-1#algo-content]])
-			of any tracks shared with the parent grid.
+			of any tracks shared with the [=parent grid=].
 			Essentially,
 			<a>subgrids</a> provide the ability to pass grid parameters down through nested elements,
-			and content-based sizing information back up to their parent grid.
+			and content-based sizing information back up to their [=parent grid=].
 
-			The <<line-name-list>> argument allows local naming of the grid lines propagated from the parent grid:
+			The <<line-name-list>> argument allows local naming of
+			the grid lines shared with the [=parent grid=]:
 			if a <<line-name-list>> is given,
 			the specified <<line-names>>s are assigned to
-			the lines of the subgrid’s <a>explicit grid</a>,
+			the lines of the [=subgrid=]’s [=explicit grid=],
 			one per line, starting with line 1.
 			Excess <<line-names>> are ignored.
 
-			If there is no parent grid,
+			If there is no [=parent grid=],
 			this value is equivalent to
 			the initial value, ''grid-template-rows/none'',
 			and the [=grid container=] is not a [=subgrid=].
@@ -1756,7 +1758,7 @@ Naming Grid Lines: the <css>[<<custom-ident>>*]</css> syntax</h4>
 		</figure>
 	</div>
 
-	A line name cannot be <css>span</css> or <css>auto</css>,
+	A [=line name=] cannot be <css>span</css> or <css>auto</css>,
 	i.e. the <<custom-ident>> in the <<line-names>> production
 	excludes the keywords <css>span</css> and <css>auto</css>.
 
@@ -1828,9 +1830,9 @@ Syntax of ''repeat()''</h5>
 		but requires <a>definite</a> track sizes so that the number of repetitions can be calculated.
 		It can only appear once in the <a>track list</a>,
 		but the same <a>track list</a> can also contain <<fixed-repeat>>s.
-	* The <<name-repeat>> variant is for adding line names to [=subgrids=].
+	* The <<name-repeat>> variant is for adding [=line names=] to [=subgrids=].
 		It can only be used with the ''grid-template-rows/subgid'' keyword
-		and cannot specify track sizes, only line names.
+		and cannot specify track sizes, only [=line names=].
 
 	If a ''repeat()'' function that is not a <<name-repeat>>
 	ends up placing two <<line-names>> adjacent to each other,
@@ -1842,7 +1844,8 @@ Repeat-to-fill: ''auto-fill'' and ''auto-fit'' repetitions</h5>
 
 	On a [=subgridded axis=],
 	the ''auto-fill'' keyword is only valid once per <<line-name-list>>,
-	and repeats enough times for the name list to match the subgrid’s specified <a>grid span</a>
+	and repeats enough times for the name list to match
+	the [=subgrid=]’s specified <a>grid span</a>
 	(falling back to 0 if the span is already fulfilled).
 
 	Otherwise on a [=standalone axis=],
@@ -2136,8 +2139,8 @@ Resolved Value of a Subgridded Track Listing</h5>
 	serialized as the ''subgrid'' keyword
 	followed by a list representing each of its lines
 	as a [=line name set=] of all the line's names
-	explicitly defined on the subgrid
-	(not including those adopted from the parent grid),
+	explicitly defined on the [=subgrid=]
+	(not including those adopted from the [=parent grid=]),
 	without using the ''repeat()'' notation.
 
 	<div class="example">
@@ -2171,7 +2174,7 @@ Resolved Value of a Subgridded Track Listing</h5>
 	"shortest equivalent serialization" principle
 	by serializing empty trailing [=line name sets=],
 	as the trailing [=line name sets=] provide potentially-useful information
-	about how many tracks the subgrid is spanning.
+	about how many tracks the [=subgrid=] is spanning.
 
 <!--
  ██████   ████████  ████ ████████           ███    ████████  ████████    ███     ██████
@@ -3508,15 +3511,15 @@ Subgrids</h2>
 	<ul style="list-style-type: lower-alpha">
 		<li id="subgrid-tracks">
 			Placing the <a>subgrid</a>
-			creates a correspondence between its subgridded tracks
-			and those that it spans in its parent grid.
-			The grid lines thus shared between the subgrid and its parent
+			creates a correspondence between its [=subgridded=] tracks
+			and those that it spans in its [=parent grid=].
+			The grid lines thus shared between the [=subgrid=] and its parent
 			form the subgrid’s <a>explicit grid</a>,
-			and its track sizes are governed by the parent grid.
+			and its track sizes are governed by the [=parent grid=].
 
 		<li id="subgrid-span">
 			The number of explicit tracks in the <a>subgrid</a>
-			in a subgridded dimension
+			in a [=subgridded=] dimension
 			always corresponds to the number of <a>grid tracks</a>
 			that it spans in its parent <a>grid</a>:
 
@@ -3538,24 +3541,24 @@ Subgrids</h2>
 		<li id="subgrid-indexing">
 			The <a>grid-placement properties</a> of the <a>subgrid</a>’s <a>grid items</a>
 			and the line numbers they use
-			are scoped to the lines covered by the subgrid,
-			exactly consistent with the lines outside the subgrid
+			are scoped to the lines covered by the [=subgrid=],
+			exactly consistent with the lines outside the [=subgrid=]
 			being excluded from its <a>explicit grid</a>.
-			E.g. numeric indices count starting from the first line of the subgrid
-			rather than the first line of the parent grid.
+			E.g. numeric indices count starting from the first line of the [=subgrid=]
+			rather than the first line of the [=parent grid=].
 
 			Line numbering and placement rules
-			obey the subgrid’s own <a>writing mode</a>,
+			obey the [=subgrid=]’s own <a>writing mode</a>,
 			just as they would for a nested independent grid.
 
 		<li id="subgrid-line-name-inheritance">
 			Since <a>subgrids</a> can be placed before their contents are placed,
-			the subgridded lines
-			automatically receive the explicit line names
+			the [=subgridded=] lines
+			automatically receive the [=explicitly-created line names=]
 			specified on the corresponding lines of the parent <a>grid</a>.
 
 			These names are in <em>addition</em> to
-			any line names specified locally on the subgrid.
+			any [=line names=] specified locally on the [=subgrid=].
 
 		<li id="subgrid-area-inheritance">
 			When a <a>subgrid</a> overlaps a <a>named grid area</a> in its parent
@@ -3576,7 +3579,7 @@ Subgrids</h2>
 			to the [=line name=] assignments of the parent <a>grid</a>.
 
 			These names are also in <em>addition</em> to
-			any line names specified locally on the subgrid.
+			any [=line names=] specified locally on the [=subgrid=].
 
 			<div class="example">
 				In the following example,
@@ -3619,19 +3622,20 @@ Subgrids</h2>
 					.inner = [center info-start] [info-end photos-start] [main-end photos-end]
 				</pre>
 
-				Notice that all the explicit names inherit straight through to .inner,
-				but the implicit names are calculated based on
-				each subgrid's overlap of the original <a>named grid area</a>.
+				Notice that all the [=explicitly-created names=]
+				inherit straight through to .inner,
+				but the [=implicitly-created names=] are calculated based on
+				each [=subgrid=]'s overlap of the original <a>named grid area</a>.
 			</div>
 
 		<li id="subgrid-implicit">
 			The <a>subgrid</a> does not have any <a>implicit grid tracks</a>
-			in the subgridded dimension(s).
+			in the [=subgridded=] dimension(s).
 			Hypothetical <a>implicit grid lines</a> are used to resolve placement
 			as usual when the <a>explicit grid</a> does not have enough lines;
 			however
 			each <a>grid item</a>’s <a>grid area</a>
-			is <a lt="clamp a grid area">clamped</a> to the subgrid’s <a>explicit grid</a>
+			is <a lt="clamp a grid area">clamped</a> to the [=subgrid=]’s <a>explicit grid</a>
 			(using the same procedure as for clamping placement in an overly-large grid).
 
 			<div class="example">
@@ -3640,13 +3644,13 @@ Subgrids</h2>
 			</div>
 
 		<li id="subgrid-size-contribution">
-			The <a>subgrid</a> itself lays out as an ordinary <a>grid item</a> in its parent grid,
+			The <a>subgrid</a> itself lays out as an ordinary <a>grid item</a> in its [=parent grid=],
 			but acts as if it was completely empty for track sizing purposes
-			in the subgridded dimension.
+			in the [=subgridded=] dimension.
 
 		<li id="subgrid-item-contribution">
 			The <a>subgrid</a>'s own <a>grid items</a> participate
-			in the sizing of its parent grid in the subgridded dimension(s)
+			in the sizing of its in the [=subgridded=] dimension(s)
 			and are aligned to it in those dimensions.
 
 			<p id="subgrid-margins">
@@ -3655,7 +3659,7 @@ Subgrids</h2>
 			are applied as an extra layer of (potentially negative) margin
 			to the items at those edges.
 			This extra layer of “margin” accumulates
-			through multiple levels of subgrids.
+			through multiple levels of [=subgrids=].
 
 			<div class="example">
 				For example, if we have a 3&times;3 grid with the following tracks:
@@ -3688,21 +3692,21 @@ Subgrids</h2>
 			<p id="subgrid-gaps">
 			Meanwhile,
 			half the size of the difference between
-			the subgrid’s <a>gutters</a> ('row-gap'/'column-gap')
-			and its parent grid’s <a>gutters</a>
+			the [=subgrid=]’s <a>gutters</a> ('row-gap'/'column-gap')
+			and its [=parent grid=]’s <a>gutters</a>
 			is applied as an extra layer of (potentially negative) margin
 			to the items not at those edges.
 			This extra layer of “margin” also accumulates
-			through multiple levels of subgrids.
+			through multiple levels of [=subgrids=].
 			A value of ''row-gap/normal''
-			indicates that the subgrid has the same size <a>gutters</a>
-			as its parent grid,
+			indicates that the [=subgrid=] has the same size <a>gutters</a>
+			as its [=parent grid=],
 			i.e. the applied difference is zero.
 
 			Note: The end result will be that the parent’s grid tracks
 			will be sized as specified,
-			and that the subgrid’s gaps will visually center-align
-			with the parent grid’s gaps.
+			and that the [=subgrid=]’s [=gutters=] will visually center-align
+			with the [=parent grid=]’s [=gutters=].
 
 			<div class="example">
 				<p>For example,
@@ -3807,7 +3811,7 @@ Subgrids</h2>
 			</div>
 
 		<li id="subgrid-edge-placeholders">
-			For each edge of a non-empty subgrid,
+			For each edge of a non-empty [=subgrid=],
 			to account for the subgrid’s margin/border/padding at that edge,
 			a hypothetical item is contributed to the track sizing algorithm
 			for each span size
@@ -3822,10 +3826,10 @@ Subgrids</h2>
 			Similarly, the hypothetical item’s span is taken
 			from that same real item’s span,
 			and inflated by the number of empty tracks between it
-			and the relevant subgrid’s edge(s).
+			and the relevant [=subgrid=]’s edge(s).
 
 			Note: This step can be shortcut if
-			the tracks closest to the subgrid’s edges contain real items,
+			the tracks closest to the [=subgrid=]’s edges contain real items,
 			which would have already
 			<a href="#subgrid-item-contribution">accounted for the subgrid’s margin/border/padding</a>
 			as described above.
@@ -3859,15 +3863,15 @@ Subgrids</h2>
 			</div>
 
 		<li id="subgrid-box-alignment">
-			The <a>subgrid</a> is always stretched in its subgridded dimension(s):
+			The <a>subgrid</a> is always stretched in its [=subgridded=] dimension(s):
 			the 'align-self'/'justify-self' properties on it are ignored,
 			as are any specified width/height constraints.
 
 		<li id="subgrid-grid-alignment">
 			Layoutwise, the <a>subgrid</a>’s <a>grid</a>
 			is always aligned with the corresponding section of the parent <a>grid</a>;
 			the 'align-content'/'justify-content' properties on it are also ignored
-			in the subgridded dimension.
+			in the [=subgridded=] dimension.
 
 		<li id="subgrid-overflow">
 			The 'overflow' property does apply to <a>subgrids</a>,
@@ -4326,7 +4330,7 @@ Grid Sizing Algorithm</h3>
 			(see <a href="https://www.w3.org/TR/css-grid-1/#algo-content">Resolve Intrinsic Track Sizes</a>)
 			is taken under the provision
 			of having determined its track sizing only up to the same point
-			in the Grid Sizing Algorithm as this parent grid itself.
+			in the Grid Sizing Algorithm as this itself.
 			E.g. for the first pass through this step,
 			the item will have its tracks sized only through this first step;
 			if a second pass of this step is triggered then
@@ -4424,7 +4428,7 @@ Grid Sizing Algorithm</h3>
 
 	Note: Track sizing in a [=subgridded=] dimension
 	treats each item in a given track in that axis
-	as members of the parent grid.
+	as members of the [=parent grid=].
 	This interlacing requires that grid sizing
 	drill down per axis into [=subgrids=],
 	rather than completing both axes as it recurses.