css-ruby/Overview.src.html

changeset 8499
9979d267d8ed
parent 8498
cc638536b160
child 8500
5243c39b9ab1
     1.1 --- a/css-ruby/Overview.src.html	Tue Jun 18 23:29:25 2013 +0900
     1.2 +++ b/css-ruby/Overview.src.html	Tue Jun 18 23:36:21 2013 +0900
     1.3 @@ -618,6 +618,91 @@
     1.4  both 'before'), the relative position of the two elements is undefined. This 
     1.5  setting should not be used.</p>
     1.6  
     1.7 +<h3 id="rubymerge">Ruby merge: the 'ruby-merge' property</h3>
     1.8 +
     1.9 +	<table class="propdef">
    1.10 +		<tr>
    1.11 +			<th>Name:
    1.12 +			<td><dfn>ruby-merge</dfn>
    1.13 +		<tr>
    1.14 +			<th><a href="#values">Value</a>:
    1.15 +			<td>separate | collapse | auto
    1.16 +		<tr>
    1.17 +			<th>Initial:
    1.18 +			<td>separate
    1.19 +		<tr>
    1.20 +			<th>Applies to:
    1.21 +			<td>all elements and generated content
    1.22 +		<tr>
    1.23 +			<th>Inherited:
    1.24 +			<td>yes
    1.25 +		<tr>
    1.26 +			<th>Percentages:
    1.27 +			<td>N/A
    1.28 +		<tr>
    1.29 +			<th>Media:
    1.30 +			<td>visual
    1.31 +		<tr>
    1.32 +			<th>Computed value:
    1.33 +			<td>specified value (except for initial and inherit)
    1.34 +	</table>
    1.35 +
    1.36 +	<p>
    1.37 +		This property controls how ruby annotation boxes should be rendered
    1.38 +		when there are more than one in a ruby container box.
    1.39 +	</p>
    1.40 +
    1.41 +	<p>Possible values:</p>
    1.42 +	<dl>
    1.43 +		<dt><dfn title="ruby-merge:separate">''separate''</dfn></dt>
    1.44 +		<dd>
    1.45 +			<p>
    1.46 +				Each ruby annotation box is rendered in the same column as its corresponding base box.
    1.47 +				This style is called Mono-ruby in [[JLREQ]].
    1.48 +			</p>
    1.49 +
    1.50 +			<div class="example">
    1.51 +				<p>The following two markups render the same:</p>
    1.52 +				<pre>&lt;ruby&gt;無&lt;rt&gt;む&lt;/ruby&gt;&lt;ruby&gt;常&lt;rt&gt;じょlt;/ruby&gt;</pre>
    1.53 +				<p>and:</p>
    1.54 +				<pre>&lt;ruby style="ruby-merge:separate"&gt;&lt;rb&gt;無&lt;rb&gt;常&lt;rt&gt;む&lt;rt&gt;じょlt;/ruby&gt;</pre>
    1.55 +			</div>
    1.56 +		</dd>
    1.57 +
    1.58 +		<dt><dfn title="ruby-merge:collapse">''collapse''</dfn></dt>
    1.59 +		<dd>
    1.60 +			<p>
    1.61 +				All ruby annotation boxes are concatenated,
    1.62 +				and rendered to the concatenated ruby base boxes.
    1.63 +				This style is called Group-ruby in [[JLREQ]].
    1.64 +			</p>
    1.65 +
    1.66 +			<div class="example">
    1.67 +				<p>The following two markups render the same:</p>
    1.68 +				<pre>&lt;ruby&gt;無常&lt;rt&gt;むじょlt;/ruby&gt;</pre>
    1.69 +				<p>and:</p>
    1.70 +				<pre>&lt;ruby style="ruby-merge:collapse"&gt;&lt;rb&gt;無&lt;rb&gt;常&lt;rt&gt;む&lt;rt&gt;じょlt;/ruby&gt;</pre>
    1.71 +			</div>
    1.72 +		</dd>
    1.73 +
    1.74 +		<dt><dfn title="ruby-merge:auto">''auto''</dfn></dt>
    1.75 +		<dd>
    1.76 +			<p>
    1.77 +				The user agent may use any algorithm to determine how each ruby annotation box
    1.78 +				is rendered to its corresponding base box.
    1.79 +			</p>
    1.80 +			<p>
    1.81 +				One possible algorithm is described as Jukugo-ruby in [[JLREQ]].
    1.82 +			</p>
    1.83 +			<p>
    1.84 +				Another, more simplified algorithm of Jukugo-ruby is
    1.85 +				to render as Mono-ruby if all ruby annotation boxes fit within
    1.86 +				advances of their corresponding base boxes,
    1.87 +				and render as Group-ruby otherwise.
    1.88 +			</p>
    1.89 +		</dd>
    1.90 +	</dl>
    1.91 +
    1.92  <h3 id="rubyalign">
    1.93  Ruby alignment: the 'ruby-align' property</h3>
    1.94  

mercurial