Skip to content

Commit d101c81

Browse files
committed
[css-ruby] Add issue for limiting L1 to two levels. Explain what's complicated and why it's tough to remove those bits.
--HG-- extra : rebase_source : 62dc93de31178937ec09005c413ae37a7dde64be
1 parent 69119d8 commit d101c81

2 files changed

Lines changed: 61 additions & 1 deletion

File tree

css-ruby/Overview.html

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -192,6 +192,26 @@ <h2 class="heading settled heading" data-level=1 id=intro><span class=secno>1 </
192192

193193
<p><em>This section is not normative.</em>
194194

195+
<div class=issue id=issue-8c07d92e><a class=self-link href=#issue-8c07d92e></a>
196+
<p>Depending on how implementers feel about it,
197+
we might want to limit (via the at-risk list) CSS Ruby Layout Level 1, like HTML5,
198+
to two levels of annotation.
199+
Subsequent levels would be inlined immediately after their ruby segment.
200+
(Not sure how to represent that limitation in <code>@supports</code>, though.)
201+
202+
<p>FWIW, the main complexity item of concern with &gt;2 levels is nested ruby.
203+
The next most complex feature, after nested ruby,
204+
is allowing two levels of ruby on the same side of the text.
205+
Removing either of these features, however, boxes us into a corner.
206+
By removing nested ruby handling,
207+
we’d create a dependency on nested ruby not being handled optimally
208+
(unless we did something dumb and always obviously broken somehow).
209+
By forcing a second annotation to be on the opposite side of the first,
210+
we create an assumption that it can never be placed on the same side,
211+
and that <a class=property data-link-type=propdesc href=#propdef-ruby-position title=ruby-position>ruby-position</a> rules that would place the second annotation
212+
on the same side as the first have no effect.
213+
</div>
214+
195215
<h3 class="heading settled heading" data-level=1.1 id=placement><span class=secno>1.1 </span><span class=content>
196216
Module interactions</span><a class=self-link href=#placement></a></h3>
197217

@@ -1616,7 +1636,27 @@ <h2 class="no-num no-ref heading settled heading" id=property-index><span class=
16161636
<tr><th scope=row><a class=css-code data-link-type=property href=#propdef-ruby-align title=ruby-align>ruby-align</a><td>start | center | space-between | space-around<td>space-around<td>ruby bases, ruby annotations, ruby base containers, ruby annotation containers<td>yes<td>N/A<td>visual<td><td><td>specified value (except for initial and inherit)<td></table></div>
16171637

16181638

1619-
<h2 class="no-num heading settled" id=issues-index><span class=content>Issues Index</span><a class=self-link href=#issues-index></a></h2><div style="counter-reset: issue"><div class=issue>The goal of this is to simplify the layout model by suppressing any line breaks within ruby annotations.
1639+
<h2 class="no-num heading settled" id=issues-index><span class=content>Issues Index</span><a class=self-link href=#issues-index></a></h2><div style="counter-reset: issue"><div class=issue>
1640+
<p>Depending on how implementers feel about it,
1641+
we might want to limit (via the at-risk list) CSS Ruby Layout Level 1, like HTML5,
1642+
to two levels of annotation.
1643+
Subsequent levels would be inlined immediately after their ruby segment.
1644+
(Not sure how to represent that limitation in <code>@supports</code>, though.)
1645+
1646+
<p>FWIW, the main complexity item of concern with &gt;2 levels is nested ruby.
1647+
The next most complex feature, after nested ruby,
1648+
is allowing two levels of ruby on the same side of the text.
1649+
Removing either of these features, however, boxes us into a corner.
1650+
By removing nested ruby handling,
1651+
we’d create a dependency on nested ruby not being handled optimally
1652+
(unless we did something dumb and always obviously broken somehow).
1653+
By forcing a second annotation to be on the opposite side of the first,
1654+
we create an assumption that it can never be placed on the same side,
1655+
and that <a class=property data-link-type=propdesc href=#propdef-ruby-position title=ruby-position>ruby-position</a> rules that would place the second annotation
1656+
on the same side as the first have no effect.
1657+
</p><a href=#issue-8c07d92e></a></div>
1658+
1659+
<div class=issue>The goal of this is to simplify the layout model by suppressing any line breaks within ruby annotations.
16201660
Alternatively we could try to define some kind of acceptable behavior for them.
16211661
<a href=#issue-8af70305></a></div><div class=issue>Make this into an example:
16221662
<img src=http://lists.w3.org/Archives/Public/www-archive/2014Jun/att-0027/PastedGraphic-1.png style="display: block; width: 100%">

css-ruby/Overview.src.html

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,26 @@ <h2 id="intro">
3232

3333
<p><em>This section is not normative.</em>
3434

35+
<div class="issue">
36+
<p>Depending on how implementers feel about it,
37+
we might want to limit (via the at-risk list) CSS Ruby Layout Level 1, like HTML5,
38+
to two levels of annotation.
39+
Subsequent levels would be inlined immediately after their ruby segment.
40+
(Not sure how to represent that limitation in <code>@supports</code>, though.)
41+
42+
<p>FWIW, the main complexity item of concern with >2 levels is nested ruby.
43+
The next most complex feature, after nested ruby,
44+
is allowing two levels of ruby on the same side of the text.
45+
Removing either of these features, however, boxes us into a corner.
46+
By removing nested ruby handling,
47+
we'd create a dependency on nested ruby not being handled optimally
48+
(unless we did something dumb and always obviously broken somehow).
49+
By forcing a second annotation to be on the opposite side of the first,
50+
we create an assumption that it can never be placed on the same side,
51+
and that 'ruby-position' rules that would place the second annotation
52+
on the same side as the first have no effect.
53+
</div>
54+
3555
<h3 id="placement">
3656
Module interactions</h3>
3757

0 commit comments

Comments
 (0)