css-ruby/Overview.src.html

changeset 9167
e654b1e94545
parent 9163
84b4394709eb
child 9168
9aff8601c264
     1.1 --- a/css-ruby/Overview.src.html	Fri Sep 13 22:55:51 2013 +0200
     1.2 +++ b/css-ruby/Overview.src.html	Fri Sep 13 13:55:31 2013 -0700
     1.3 @@ -426,18 +426,20 @@
     1.4  <h3 id="white-space">
     1.5  White Space</h3>
     1.6  
     1.7 -	<p class="issue">I'm unsure exactly where space should be trimmed. :/
     1.8 -	But pretty sure we need to keep spaces between things,
     1.9 -	otherwise ruby only works for CJK.
    1.10 +	<p><i>Collapsible</i> white space within a ruby structure is discarded
    1.11 +	<ul>
    1.12 +		<li>at the beginning and end of a <i>ruby container</i>, <i>ruby annotation container</i>, or <i>ruby base container</i>,
    1.13 +		<li>at the beginning/end of a <i>ruby annotation box</i> or <i>ruby base box</i> if white space is not its only contents,
    1.14 +		<li>between a <i>ruby base container</i> and its following <i>ruby annotation container</i>,
    1.15 +		<li>between <i>ruby annotation containers</i>.
    1.16 +	</ul>
    1.17  
    1.18 -	<p><i>Collapsible</i> white space within a ruby structure is discarded
    1.19 -	at the beginning and end of a <i>ruby container</i>, <i>ruby annotation container</i>, or <i>ruby base container</i>,
    1.20 -	and at the beginning/end of a <i>ruby annotation box</i> or <i>ruby base box</i> if white space is not its only contents.
    1.21 -	Between <i>ruby segments</i>, between <i>ruby bases</i>, and between <i>ruby annotations</i>, however,
    1.22 +	<p>Between <i>ruby segments</i>, between <i>ruby bases</i>, and between <i>ruby annotations</i>, however,
    1.23  	white space is not discarded.
    1.24 -	If such white space is <i>collapsible</i>, it will collapse
    1.25 +
    1.26 +	<p>Where undiscarded white space is <i>collapsible</i>, it will collapse
    1.27  	following the standard <a href="http://www.w3.org/TR/css3-text/#white-space-rules">white space processing rules</a>. [[!CSS3TEXT]]
    1.28 -	Between <i>ruby segments</i>, however,
    1.29 +	For <i>collapsible</i> white space between <i>ruby segments</i>, however,
    1.30  	the contextual text for determining collapsing behavior is given by the <i>ruby bases</i> on either side,
    1.31  	not the text on either side of the white space in the source document.
    1.32  
    1.33 @@ -452,11 +454,12 @@
    1.34  <!--		-->  &lt;rb>東&lt;/rb>&lt;rb>京&lt;/rb>
    1.35  <!--		-->  &lt;rt>とう&lt;/rt>&lt;rt>きょう&lt;/rt>
    1.36  <!--		-->&lt;/ruby></pre>
    1.37 -		<p>However, this markup will:
    1.38 +		<p>However, white space that does not contain a <i>segment break</i> does not collapse completely away,
    1.39 +		so this markup will display with a space between the first and second ruby pairs:
    1.40  		<pre>
    1.41  <!--		-->&lt;ruby>
    1.42  <!--		-->  &lt;rb>東&lt;/rb>	&lt;rb>京&lt;/rb>
    1.43 -<!--		-->  &lt;rt>とう&lt;/rt> &lt;rt>きょう&lt;/rt>
    1.44 +<!--		-->  &lt;rt>とう&lt;/rt>	&lt;rt>きょう&lt;/rt>
    1.45  <!--		-->&lt;/ruby></pre>
    1.46  	</div>
    1.47  
    1.48 @@ -465,8 +468,10 @@
    1.49  	<i>ruby annotation container</i> (if between <i>ruby annotations</i>),
    1.50  	or <i>ruby container</i> (if between <i>ruby segments</i>).
    1.51  	In the latter case, the text is considered part of the <i>base level</i>.
    1.52 -	This box does not take part in pairing.
    1.53 -	It merely ensures separation between adjacent bases/annotations.
    1.54 +	Such anonynmous boxes do not take part in pairing.
    1.55 +	They merely ensure separation between adjacent bases/annotations.
    1.56 +
    1.57 +	<p class="issue">Specify how these anonymous white space boxes impact layout.
    1.58  
    1.59  	<div class="example">
    1.60  		<p>These rules allow ruby to be used with space-separated scripts such as Latin.
    1.61 @@ -484,8 +489,6 @@
    1.62  <!--		-->&lt;/ruby></pre>
    1.63  	</div>
    1.64  
    1.65 -	<p class="issue">Specify how this impacts layout, or not.
    1.66 -
    1.67  <h3 id="ruby-layout">
    1.68  Ruby layout</h3>
    1.69  

mercurial