1.1 --- a/css-ruby/Overview.src.html Tue Jul 01 11:06:54 2014 -0700
1.2 +++ b/css-ruby/Overview.src.html Wed Jul 02 06:52:31 2014 -0700
1.3 @@ -13,7 +13,7 @@
1.4 Abstract: Inter-linear annotations, also known as “ruby”, are short runs of text alongside the base text,
1.5 Abstract: typically used in East Asian documents to indicate pronunciation or to provide a short annotation.
1.6 Abstract: This module describes the rendering model and formatting controls related to displaying ruby annotations in CSS.
1.7 -Ignored terms: collapsible, collapsible white space, white space, segment break, soft wrap opportunity, justification opportunity, justification opportunities, characters
1.8 +Ignored terms: collapsible, collapsible white space, white space, segment break, soft wrap opportunity, justification opportunity, justification opportunities, characters, internal table elements
1.9 </pre>
1.10
1.11 <!--
1.12 @@ -208,16 +208,49 @@
1.13 (Corresponds to HTML/XHTML <code><rtc></code> elements.)
1.14 </dl>
1.15
1.16 + <p><i>Ruby containers</i> are non-atomic inline-level boxes:
1.17 + like inline boxes, they break across lines and
1.18 + their base-level contents participate in the same inline formatting context as the <i>ruby container</i> itself.
1.19 + <i>Ruby bases</i>, <i>ruby annotations</i>, <i>ruby base containers</i>, and <i>ruby annotation containers</i>
1.20 + are <dfn>internal ruby boxes</dfn>:
1.21 + like <i>internal table elements</i>,
1.22 + they have specific roles in ruby layout.
1.23 + <span class="issue">Are internal ruby boxes inline-level?</span>
1.24 +
1.25 <p>Authors using a language (such as HTML) that supports ruby markup
1.26 should use that markup rather than styling arbitrary elements (like <code><span></code>)
1.27 with ruby 'display' values.
1.28 Using the correct markup ensures that screen readers
1.29 and non-CSS renderers can interpret the ruby structures.
1.30
1.31 -<h4 id="block-ruby">
1.32 -Block-level Ruby</h4>
1.33 +<h4 id="display-inside-outside">
1.34 +Ruby-specific 'display-inside' and 'display-outside' values</h4>
1.35
1.36 - <p>If an element has a computed 'display-inside' of ''ruby''
1.37 + <p>The ruby-specific 'display' values map to 'display-inside' and 'display-outside' as follows:
1.38 + <table class="data">
1.39 + <thead>
1.40 + <tr><th>'display'
1.41 + <th>'display-inside'
1.42 + <th>'display-outside'
1.43 + <tbody>
1.44 + <tr><td>''ruby''
1.45 + <td>''inline-level''
1.46 + <td>''ruby''
1.47 + <tr><td>''ruby-base''
1.48 + <td>''ruby-base''
1.49 + <td>''auto''
1.50 + <tr><td>''ruby-text''
1.51 + <td>''ruby-text''
1.52 + <td>''auto''
1.53 + <tr><td>''ruby-base-container''
1.54 + <td>''ruby-base-container''
1.55 + <td>''auto''
1.56 + <tr><td>''ruby-text-container''
1.57 + <td>''ruby-text-container''
1.58 + <td>''auto''
1.59 + </table>
1.60 +
1.61 + <p id="block-ruby">If an element has a computed 'display-inside' of ''ruby''
1.62 and a computed 'display-outside' other than ''inline-level'',
1.63 then it generates two boxes:
1.64 a principal block container box of the required 'display-outside' type,
1.65 @@ -226,11 +259,13 @@
1.66 (and if inheritable, inherit to the <i>ruby container box</i>).
1.67 This allows styling the element as a block,
1.68 while correctly maintaining the internal ruby structure.
1.69 +<!--
1.70 + Note: There is no dedicated block-level 'display' shorthand keyword
1.71 + because ruby is fundamentally an inline layout feature.
1.72 +-->
1.73
1.74 <p>See the <a href="http://www.w3.org/TR/css-display/">CSS Display Module</a>
1.75 - for more information on 'display-inside' and 'display-outside'.
1.76 - Note: There is no dedicated block-level 'display' keyword
1.77 - because ruby is fundamentally an inline layout feature.
1.78 + for more information on 'display-inside' and 'display-outside'. [[!CSS3-DISPLAY]]
1.79
1.80 <h3 id="box-fixup">
1.81 Anonymous Ruby Box Generation</h3>
1.82 @@ -264,6 +299,7 @@
1.83
1.84 <li id="anon-gen-bare-inlines"><strong>Wrap misparented inline-level content:</strong>
1.85 Any consecutive sequence of text and inline-level boxes
1.86 + (that are not <i>ruby containers</i> or <i>internal ruby boxes</i>)
1.87 directly parented by a <i>ruby container</i> or <i>ruby base container</i>
1.88 is wrapped in an anonymous <i>ruby base</i>.
1.89 Similarly, any consecutive sequence of text and inline-level boxes
