- From: Ishii Koji via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 06 May 2011 02:32:09 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css-line-grid
In directory hutz:/tmp/cvs-serv6515
Modified Files:
Overview.html Overview.src.html
Log Message:
Editorial fixes
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css-line-grid/Overview.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- Overview.html 30 Apr 2011 15:27:55 -0000 1.9
+++ Overview.html 6 May 2011 02:32:07 -0000 1.10
@@ -39,13 +39,13 @@
<h1>CSS Line Grid Module</h1>
- <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 30 April 2011</h2>
+ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 6 May 2011</h2>
<dl>
<dt>This version:
- <dd><a href="http://www.w3.org/TR/2011/ED-unknown-shortname-20110430">
- http://www.w3.org/TR/2011/ED-unknown-shortname-20110430</a> <!--
+ <dd><a href="http://www.w3.org/TR/2011/ED-unknown-shortname-20110506">
+ http://www.w3.org/TR/2011/ED-unknown-shortname-20110506</a> <!--
<dt>Latest version:
<dd><a href="http://www.w3.org/TR/css-line-grid">
http://www.w3.org/TR/css-line-grid</a>
@@ -216,77 +216,75 @@
<p>This specification provides features to align lines and blocks to
invisible grids in the document.
- <p>Aligning lines and blocks to grids gives the following benefits:
+ <p>Aligning lines and blocks to grids provides the following benefits:
<ul>
- <li>Keep vertical rhythm for better readability.
+ <li>Vertical rhythm is kept for better readability.
- <li>Align lines between columns in multi-column documents.
+ <li>Lines are aligned between columns in multi-column documents.
- <li>Make the top and the bottom margins of pictures equal, while keeping
- the vertical rhythm of text before and after the pictures.</li>
+ <li>The top and the bottom margins of pictures are made equal, while
+ keeping the vertical rhythm of text before and after the pictures.</li>
<!--
<li>Aligning to grids can sometimes be turned off for objects like tables,
but then turned back on for the following text
to the same grids as the one for the text before the objects.</li>
-->
- <li>Layout lines at the same position in every page in paged media.
+ <li>Layout lines are at the same position on every page in paged media.
Keeping the position of the bottom line of a page has benefits for design
- and readability. This also improves the readability on duplex printing,
- two pages spreads, and when displaying on slow display devices like
- e-ink.
+ and readability. This also improves the readability of duplex printing,
+ two pages spreads, and displaying on slow display devices like e-ink.
<li>East Asian layouts require vertical rhythm more often than other
- scripts does, even in single column, non-paged media documents, as
- defined in <a href="#JLREQ" rel=biblioentry>[JLREQ]<!--{{JLREQ}}--></a>.
+ scripts do, even in single column, non-paged media documents, as defined
+ in <a href="#JLREQ" rel=biblioentry>[JLREQ]<!--{{JLREQ}}--></a>.
- <li>It is often desirable in East Asian layouts to make the line width to
- be multiple of <em>em</em> without fractions. Since most East Asian
- characters have 1em advance, and since most East Asian documents are
- justified, this minimizes the case where justification needs to expand
- lines.
+ <li>It is often desirable in East Asian layouts to make the line width a
+ multiple of <em>em</em> without fractions. Because most East Asian
+ characters have 1em advance and most East Asian documents are justified,
+ this minimizes cases where justification is needed to expand lines.
</ul>
<p>There are several types of objects in a document that can break the
- vertical rhythm. Examples include lines in different size of text,
+ vertical rhythm. Examples include lines with different sizes of text,
pictures, and tables.
- <div class=figure> <img alt="Keep vertical rhythm through pictures and
+ <div class=figure> <img alt="Vertical rhythm kept through pictures and
different size of text in a multi-column document" height=246
src=line-grid-multicol.png width=480>
- <p class=caption>Keep vertical rhythm through pictures and different size
+ <p class=caption>Vertical rhythm kept through pictures and different size
of text in a multi-column document.</p>
</div>
<div class=figure id=ex-sidenote>
<div class=sidenote-block>
<div class=sidenote-body> Sidenotes (and footnotes for that matter) are
- often set at a smaller size to the basic text. This smaller text should
- still line up with basic text. Authors can achieve this effect by
- calculating appropriate font-size, line-height, and margins*.</div>
+ often set at a smaller size than the basic text. This smaller text
+ should still line up with the basic text. Authors can achieve this
+ effect by calculating appropriate font-size, line-height, and margins*.</div>
<div class=sidenote-note> Only if author controls everything. It can
easily be broken by user stylesheet, for instance.</div>
</div>
- <p class=caption>Sidenotes set at a smaller size, but still line up with
- basic text.</p>
+ <p class=caption>Sidenotes are set at a smaller size, but still line up
+ with the basic text.</p>
</div>
- <p>This module defines following capabilities:
+ <p>This module provides the following capabilities:
<ul>
- <li>Defines grids in the line progression direction.
+ <li>Defining grids in the line progression direction.
- <li>Controls how lines and blocks align to the grids.
+ <li>Controling how lines and blocks align to the grids.
- <li>Rounds lengths down to multiple of units.
+ <li>Rounding lengths down to multiples of units.
</ul>
- <p>It is important to control these capabilities independently, so that
- aligning to grids can be turned off for tables for example, but can then
- be turned back on for the following text to the grids.
+ <p>It is important to control these capabilities independently, so that,
+ for example, aligning to grids can be turned off for tables, but can then
+ be turned back on for aligning the following text to the grids.
<h3 id=placement><span class=secno>1.2. </span>Module Interactions</h3>
@@ -498,7 +496,7 @@
<p>When this property is set to anything other than ‘<code
class=css>none</code>’, the computed height of the object is
- increased to the smallest multiple of the grid heights that is equal to or
+ increased to the smallest multiple of the grid height that is equal to or
smaller than the original computed height.
<p>When the value of this property is ‘<code
@@ -513,24 +511,25 @@
the object to fit in. The starting alignment point is moved accordingly.
This is illustrated below, where <em>a</em> represents the numerical
‘<a href="#layout-grid-line"><code
- class=property>layout-grid-line</code></a>’ value, <em>b</em> and
- <em>c</em> are half the difference between the computed line-heights and
- either the layout-grid-line value or twice the value respectively.:
+ class=property>layout-grid-line</code></a>’ value, and <em>b</em>
+ and <em>c</em> are half the difference between the computed line-heights
+ and either the layout-grid-line value or twice the value respectively.
- <div class=figure> <img src=lgl.gif>
- <p class=caption>Layout of contents within line grid, where <em>a</em>
+ <div class=figure> <img alt="Layout of content within a line grid"
+ src=lgl.gif>
+ <p class=caption>Layout of content within a line grid, where <em>a</em>
represents the layout-grid-line value, and the alignment baseline is at
the bottom (after-edge).</p>
</div>
- <p>As for regular height computation, the ruby box is treated especially.
+ <p>As for regular height computation, the ruby box is treated specifically.
In a similar fashion to the line-height determination process, only the
- ruby base element is considered for centering purpose, however the above
+ ruby base element is considered for centering purposes, however the above
and/or the after space should be sufficient to fit the ruby text above
and/or after the base text within the grid-line space. If this is not the
- case, the grid-line size needs to be increased in multiple of grid rows
- until the whole ruby box fits. <span class=issue>Is just ignoring ruby
- text enough? like rt { layout-grid-mode: ignore; } or nothing needed to be
+ case, the grid-line size needs to be increased in multiple grid rows until
+ the whole ruby box fits. <span class=issue>Is just ignoring ruby text
+ enough? like rt { layout-grid-mode: ignore; } or nothing needed to be
defined if line-stacking-ruby: auto does the work?</span>
<p>Note that in order for this property to have an effect, line grids must
@@ -542,7 +541,7 @@
like only a word in a line is large. But how can we align baselines to
grids? Align baselines to center of grids? Lines may not fit within one
grid. Align baselines to grids might work better, but it may not work well
- with settings headigns to ‘<code class=css>block</code>’.
+ with settings headings to ‘<code class=css>block</code>’.
<div class=example>
<div class=sidefigure> <img alt="Large text wraps within line grids"
@@ -550,8 +549,8 @@
<p class=caption>Large text wraps within line grids.</p>
</div>
- <p>When a different size of text like headings wraps, it is usually
- aligned to grids as a block and lines within the block do not align.</p>
+ <p>When a different size of text, such as a headings, wraps, it is usually
+ aligned to grids as a block and the lines within the block do not align.</p>
<p>This effect can be achieved by the following code:</p>
@@ -577,7 +576,7 @@
Grid units are used very frequently in East Asian typography, especially
for the left, right, top and bottom element margins.
- <p>Therefore a new length unit is necessary: gd to enable the author to
+ <p>Therefore, a new length unit is necessary, gd, to enable the author to
specify the various measurements in terms of the grid.
<p>For example, consider the following style:
@@ -613,7 +612,7 @@
<p>East Asian layout often requires heights specified by the count of the
line grids. In Japanese, this method is called Gyou-dori. Refer to <a
href="#JLREQ" rel=biblioentry>[JLREQ]<!--{{JLREQ}}--></a> for more
- details of Gyou-dori.</p>
+ details about Gyou-dori.</p>
<pre><code class=css>
<!-- -->h1 {
@@ -633,13 +632,13 @@
class=property>height</code>’ properties accept ‘<code
class=css>*gd</code>’ and ‘<code class=css>*em</code>’
values. These values compute to ‘<code class=css>auto</code>’,
- and then the result will be round down to the largest multiple of the
+ and then the result will be rounded down to the largest multiple of the
specified unit that is equal to or less than the original computed value.
- <p>The fraction is distributed evenly to the computed values of margins of
+ <p>The fraction is distributed evenly to the computed values of margins on
each side. If it is used for ‘<code
- class=property>height</code>’, the half the fraction is added to the
- top and the bottom margins. If for ‘<code
+ class=property>height</code>’, half the fraction is added to the top
+ and the bottom margins. If for ‘<code
class=property>width</code>’, to the left and the right margins.
<p class=issue>Should this be a property instead?
@@ -651,10 +650,9 @@
<div class=example>
<p>It is often desirable for East Asian layouts to make the line width to
- be multiple of <em>em</em> without fractions. Since most East Asian
- characters have 1em advance, and since most East Asian documents are
- justified, this minimizes the case where justification needs to expand
- lines.</p>
+ be multiple of <em>em</em> without fractions. Because most East Asian
+ characters have 1em advance and most East Asian documents are justified,
+ this minimizes cases where justification is needed to expand lines.</p>
<pre><code class=css>
<!-- -->body {
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css-line-grid/Overview.src.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- Overview.src.html 30 Apr 2011 15:27:55 -0000 1.9
+++ Overview.src.html 6 May 2011 02:32:07 -0000 1.10
@@ -90,54 +90,54 @@
<p>This specification provides features to align lines and blocks
to invisible grids in the document.</p>
- <p>Aligning lines and blocks to grids gives the following benefits:</p>
+ <p>Aligning lines and blocks to grids provides the following benefits:</p>
<ul>
- <li>Keep vertical rhythm for better readability.</li>
- <li>Align lines between columns in multi-column documents.</li>
- <li>Make the top and the bottom margins of pictures equal,
+ <li>Vertical rhythm is kept for better readability.</li>
+ <li>Lines are aligned between columns in multi-column documents.</li>
+ <li>The top and the bottom margins of pictures are made equal,
while keeping the vertical rhythm of text before and after the pictures.</li>
<!--
<li>Aligning to grids can sometimes be turned off for objects like tables,
but then turned back on for the following text
to the same grids as the one for the text before the objects.</li>
-->
- <li>Layout lines at the same position in every page in paged media.
+ <li>Layout lines are at the same position on every page in paged media.
Keeping the position of the bottom line of a page has benefits for
design and readability.
- This also improves the readability on duplex printing,
+ This also improves the readability of duplex printing,
two pages spreads,
- and when displaying on slow display devices like e-ink.</li>
+ and displaying on slow display devices like e-ink.</li>
<li>East Asian layouts require vertical rhythm
- more often than other scripts does,
+ more often than other scripts do,
even in single column, non-paged media documents,
as defined in [[JLREQ]].</li>
<li>It is often desirable in East Asian layouts
- to make the line width to be
- multiple of <em>em</em> without fractions.
- Since most East Asian characters have 1em advance,
- and since most East Asian documents are justified,
- this minimizes the case where justification needs to expand lines.</li>
+ to make the line width
+ a multiple of <em>em</em> without fractions.
+ Because most East Asian characters have 1em advance
+ and most East Asian documents are justified,
+ this minimizes cases where justification is needed to expand lines.</li>
</ul>
<p>There are several types of objects in a document
that can break the vertical rhythm.
- Examples include lines in different size of text, pictures, and tables.</p>
+ Examples include lines with different sizes of text, pictures, and tables.</p>
<div class="figure">
<img src="line-grid-multicol.png"
width="480" height="246"
- alt="Keep vertical rhythm through pictures and different size of text in a multi-column document"
+ alt="Vertical rhythm kept through pictures and different size of text in a multi-column document"
/>
- <p class="caption">Keep vertical rhythm through pictures and different size of text in a multi-column document.</p>
+ <p class="caption">Vertical rhythm kept through pictures and different size of text in a multi-column document.</p>
</div>
<div id="ex-sidenote" class="figure">
<div class="sidenote-block">
<div class="sidenote-body">
Sidenotes (and footnotes for that matter) are often set
- at a smaller size to the basic text.
- This smaller text should still line up with basic text.
+ at a smaller size than the basic text.
+ This smaller text should still line up with the basic text.
Authors can achieve this effect
by calculating appropriate font-size, line-height,
and margins*.
@@ -147,19 +147,19 @@
It can easily be broken by user stylesheet, for instance.
</div>
</div>
- <p class="caption">Sidenotes set at a smaller size, but still line up with basic text.</p>
+ <p class="caption">Sidenotes are set at a smaller size, but still line up with the basic text.</p>
</div>
- <p>This module defines following capabilities:</p>
+ <p>This module provides the following capabilities:</p>
<ul>
- <li>Defines grids in the line progression direction.</li>
- <li>Controls how lines and blocks align to the grids.</li>
- <li>Rounds lengths down to multiple of units.</li>
+ <li>Defining grids in the line progression direction.</li>
+ <li>Controling how lines and blocks align to the grids.</li>
+ <li>Rounding lengths down to multiples of units.</li>
</ul>
<p>It is important to control these capabilities independently,
- so that aligning to grids can be turned off for tables for example,
- but can then be turned back on for the following text to the grids.
+ so that, for example, aligning to grids can be turned off for tables,
+ but can then be turned back on for aligning the following text to the grids.
</p>
@@ -327,7 +327,7 @@
<p>When this property is set to anything other than ''none'',
the computed height of the object is increased to
- the smallest multiple of the grid heights
+ the smallest multiple of the grid height
that is equal to or smaller than the original computed height.</p>
<p>When the value of this property is ''baseline'',
@@ -342,24 +342,25 @@
The starting alignment point is moved accordingly.
This is illustrated below,
where <em>a</em> represents the numerical 'layout-grid-line' value,
- <em>b</em> and <em>c</em> are half the difference between the computed line-heights
- and either the layout-grid-line value or twice the value respectively.:</p>
+ and <em>b</em> and <em>c</em> are half the difference between the computed line-heights
+ and either the layout-grid-line value or twice the value respectively.</p>
<div class="figure">
<img src="lgl.gif"
+ alt="Layout of content within a line grid"
/>
- <p class="caption">Layout of contents within line grid,
+ <p class="caption">Layout of content within a line grid,
where <em>a</em> represents the layout-grid-line value,
and the alignment baseline is at the bottom (after-edge).</p>
</div>
- <p>As for regular height computation, the ruby box is treated especially.
+ <p>As for regular height computation, the ruby box is treated specifically.
In a similar fashion to the line-height determination process,
- only the ruby base element is considered for centering purpose,
+ only the ruby base element is considered for centering purposes,
however the above and/or the after space should be sufficient
to fit the ruby text above and/or after the base text within the grid-line space.
If this is not the case,
- the grid-line size needs to be increased in multiple of grid rows until the whole ruby box fits.
+ the grid-line size needs to be increased in multiple grid rows until the whole ruby box fits.
<span class="issue">Is just ignoring ruby text enough? like rt { layout-grid-mode: ignore; }
or nothing needed to be defined if line-stacking-ruby: auto does the work?</span>
</p>
@@ -372,7 +373,7 @@
if we consider cases like only a word in a line is large.
But how can we align baselines to grids?
Align baselines to center of grids? Lines may not fit within one grid.
- Align baselines to grids might work better, but it may not work well with settings headigns to ''block''.</p>
+ Align baselines to grids might work better, but it may not work well with settings headings to ''block''.</p>
<div class="example">
<div class="sidefigure">
@@ -383,9 +384,9 @@
<p class="caption">Large text wraps within line grids.</p>
</div>
- <p>When a different size of text like headings wraps,
+ <p>When a different size of text, such as a headings, wraps,
it is usually aligned to grids as a block and
- lines within the block do not align.</p>
+ the lines within the block do not align.</p>
<p>This effect can be achieved by the following code:</p>
<pre><code class="css">
@@ -408,8 +409,8 @@
Grid units are used very frequently in East Asian typography,
especially for the left, right, top and bottom element margins.</p>
- <p>Therefore a new length unit is necessary:
- gd to enable the author to specify the various measurements in terms of the grid.</p>
+ <p>Therefore, a new length unit is necessary,
+ gd, to enable the author to specify the various measurements in terms of the grid.</p>
<p>For example, consider the following style:</p>
<pre><code class="css">P { layout-grid: strict both 20pt 15pt; margin: 1gd 3gd 1gd 2gd }</code></pre>
@@ -440,7 +441,7 @@
<p>East Asian layout often requires heights specified
by the count of the line grids.
In Japanese, this method is called Gyou-dori.
- Refer to [[JLREQ]] for more details of Gyou-dori.</p>
+ Refer to [[JLREQ]] for more details about Gyou-dori.</p>
<pre><code class="css">
<!-- -->h1 {
<!-- --> line-grid-mode: block;
@@ -456,13 +457,13 @@
<p>The 'width' and 'height' properties
accept ''*gd'' and ''*em'' values.
These values compute to ''auto'',
- and then the result will be round down to
+ and then the result will be rounded down to
the largest multiple of the specified unit
that is equal to or less than the original computed value.</p>
- <p>The fraction is distributed evenly to the computed values of margins of each side.
+ <p>The fraction is distributed evenly to the computed values of margins on each side.
If it is used for 'height',
- the half the fraction is added to the top and the bottom margins.
+ half the fraction is added to the top and the bottom margins.
If for 'width', to the left and the right margins.</p>
<p class="issue">Should this be a property instead?</p>
@@ -474,9 +475,9 @@
<p>It is often desirable for East Asian layouts
to make the line width to be
multiple of <em>em</em> without fractions.
- Since most East Asian characters have 1em advance,
- and since most East Asian documents are justified,
- this minimizes the case where justification needs to expand lines.</p>
+ Because most East Asian characters have 1em advance
+ and most East Asian documents are justified,
+ this minimizes cases where justification is needed to expand lines.</p>
<pre><code class="css">
<!-- -->body {
<!-- --> margin: 3cm 3.5cm 3cm 3cm;
Received on Friday, 6 May 2011 02:32:12 UTC