OSDN Git Service

updated documents
[luatex-ja/luatexja.git] / doc / luatexja-ruby.tex
1 %#! lualatex
2 %%% a test of ruby.
3 \documentclass[a4paper,10pt]{ltjsarticle}
4 \usepackage{luatexja-otf,amsmath,bxghost}
5 \usepackage[no-math]{fontspec}
6 \usepackage[match]{luatexja-fontspec}
7 \usepackage[haranoaji]{luatexja-preset}\normalsize
8 \setmonojfont{HaranoAjiGothic-Regular.otf}
9 \usepackage{unicode-math}
10 \setmathfont{Latin Modern Math}
11
12 \def\emph#1{\textbf{\textgt{#1}}}
13 \def\headfont{\normalfont\bfseries\gtfamily}
14 \def\cs#1{\eghostguarded{\texttt{\textbackslash#1}}}
15 \usepackage[textwidth=45\zw, lines=45, footskip=2\zh]{geometry}
16 \advance\leftmargini-1\zw\advance\leftmarginii-1\zw
17 \protected\def\Param#1{\eghostguarded{\underline{\smash{\textsf{\mdseries #1}}}}}
18
19 \usepackage{luatexja-ruby,showexpl,booktabs}
20 \lstset{
21   preset=\normalsize, basicstyle=\small\ttfamily, basewidth=0.5em,
22   explpreset={numberstyle=\tiny, numbers=left, numbersep=1em, columns=fixed},
23 }
24 \makeatletter\let\SX@Info=\relax\makeatother
25 \fboxsep=0mm
26
27 \usepackage{hyperref,bookmark,xcolor}
28 \hypersetup{%
29         unicode,
30         colorlinks,
31         allbordercolors=1 1 1,
32         allcolors=blue,
33         pdftitle={luatexja-ruby.sty}
34 }
35
36 \def\Node#1#2{\,\vcenter{\hbox{\fboxsep=1pt\fbox{\vbox{\small\halign{\hfil##\hfil\cr
37   #1\mathstrut\cr\noalign{\smallskip\hrule height.4pt\smallskip}\strut\<#2\cr}}}}}\,}
38 \def\LuaTeX{Lua\TeX}
39
40 % 三分ルビ用
41 \DeclareFontShape{JY3}{mc}{mc}{n}{<-> [0.92487] 
42   HaranoAjiMincho-Regular:extend=0.67;jfm=ujisc33}{}
43
44 \title{\textsf{luatexja-ruby}パッケージ}
45 \begin{document}
46 \catcode`\<=13
47 \def<#1>{{\rmfamily\mdseries\itshape$\langle$#1\/$\rangle$}}
48 %\fontsize{13.19873}{15}\selectfont%
49
50 \maketitle
51
52 \begin{abstract}
53 \textsf{luatexja-ruby}パッケージは,\LuaTeX-jaの機能を利用してルビの組版処理を行う追加パッケージである.
54 \LuaTeX, \LuaTeX-jaの内部処理に割り込むことにより,熟語ルビ中の行分割や,
55 行頭形・行中形・行末形の自動検出,また進入許容量の自動設定などを可能とした.
56 \end{abstract}
57
58 \tableofcontents
59
60 \newpage
61 \section{\ltjruby{利|用|方|法}{り|よう|ほう|ほう}}
62 パッケージ読み込みは,\verb+\usepackage{luatexja-ruby}+ で良く,
63 必要ならば自動的に\LuaTeX-ja本体を読み込む.
64 plain \LuaTeX でのロードはまだサポートしておらず,
65 \LaTeXe のみサポートしている.
66
67 \subsection{\ltjruby{用|語}{よう|ご}}
68 「進入(intrusion)」「突出(protrusion)」という用語は,
69 \href{http://zrbabbler.sp.land.to/pxrubrica.html}{\textsf{pxrubrica}パッケージ}%
70 での用法に準ずる.
71
72 \begin{quotation}
73 進入あり:と\ltjruby{暁}{あかつき}の
74
75 進入なし:{\setkeys[ltj]{ruby}{mode=0}と\ltjruby{暁}{あかつき}の}
76
77 突出あり:{\setkeys[ltj]{ruby}{stretch={1}{2}{1}}\ltjruby{聴衆}{ちようしゆう}}
78
79 突出なし:{\setkeys[ltj]{ruby}{stretch={0}{2}{0}}\ltjruby{聴衆}{ちようしゆう}}
80 \end{quotation}
81
82 \subsection{\ruby{命|令}{めい|れい}}
83 \paragraph{\cs{ltjruby}}
84 ルビ出力用命令の本体.\verb+\ruby+ という別名を定義している.
85 \begin{quote}
86 \ttfamily \textbackslash ltjruby[<option>]\{親|文|字\}\{おや|も|じ\}
87 \end{quote}
88 のように使用する.
89 第2・第3引数内の「\verb+|+」はグループの区切りを表す.詳細は\ref{ssec:grp}\nobreak 小節を参照.
90
91 <option>には以下の内容をkey-valueリストで指定可能である:
92 \begin{description}
93 \def\makelabel#1{\ttfamily\bfseries #1}
94 \item[pre=<real>] 前進入許容量をルビ全角単位で指定.
95 負の長さを指定した場合は,ルビの状況や直前の文字に応じた自動指定を意味する.
96 既定値は負(つまり,自動指定).
97
98 \item[post=<real>] 同様に,後進入許容量を指定する.既定値は負(自動指定).
99
100 \item[mode] 進入処理のモードを表すbit vector.下位2\,bitは,\texttt{pre}や
101 \texttt{post}が負である場合にしか効力を発揮しない.既定値は$(0001)_2 = 1$.
102 \begin{description}
103  \item[bit 0] 進入を無効にするならば0,有効にするならば1.
104  \item[bit 1] 前進入許容量$B$と後進入許容量$A$が異なった場合,
105 そのまま処理する場合は0,小さい方に揃えるならば1.
106  \item[bit 2--3] ルビ文字の突出量$x$から実際の前進入量$b$,後進入量$a$の計算方法を指定する.
107 親文字の文字数が$k+1$,親文字の前に入る空白量・間の空白量・後ろの空白量の比が$p:q:r$のとき,
108 \begin{description}
109  \item[00] $b=\min(B, xp/(p+kq+r))$, \ $a=\min(A, xr/(p+kq+r))$
110  \item[01] $b=\min(B, x)$, \ $a=\min(A, \max(x-b,0))$
111  \item[10] $a=\min(A, x)$, \ $b=\min(B, \max(x-a,0))$
112  \item[11] $M=\min(B,A)$とおく.もし$x\le 2M$ならば$b=a=x/2$.そうでなければ
113 \[
114  b=\min\left(B, M + \frac{(x-2M)p}{p+kq+r}\right),\qquad 
115  a=\min\left(A, M + \frac{(x-2M)r}{p+kq+r}\right)
116 \]
117 \end{description}
118
119 組み方の具体例を実際に示す.例示のため,平仮名にはルビが1字まで,「立」にはルビを
120 0.5字分までかけてよいことにしている.
121 \begin{description}
122 \item[00]{\setkeys[ltj]{ruby}{mode=1}%
123 \ltjsetparameter{rubypreintrusion={`立,0.5}, rubypostintrusion={`立,0.5}}%
124 は\ltjruby{美}{うつく}しい
125   \quad は\ltjruby{聴衆}{ちようしゆう}と\quad
126 は\ltjruby{暁}{あかつき}立\quad
127 は\ltjruby{聴衆}{ちようしゆう}立\par}
128 \item[01]{\setkeys[ltj]{ruby}{mode=5}%
129 \ltjsetparameter{rubypreintrusion={`立,0.5}, rubypostintrusion={`立,0.5}}%
130 は\ltjruby{美}{うつく}しい
131   \quad は\ltjruby{聴衆}{ちようしゆう}と\quad
132 は\ltjruby{暁}{あかつき}立\quad
133 は\ltjruby{聴衆}{ちようしゆう}立\par}
134 \item[10]{\setkeys[ltj]{ruby}{mode=9}%
135 \ltjsetparameter{rubypreintrusion={`立,0.5}, rubypostintrusion={`立,0.5}}%
136 は\ltjruby{美}{うつく}しい
137   \quad は\ltjruby{聴衆}{ちようしゆう}と\quad
138 は\ltjruby{暁}{あかつき}立\quad
139 は\ltjruby{聴衆}{ちようしゆう}立\par}
140 \item[11]{\setkeys[ltj]{ruby}{mode=13}%
141 \ltjsetparameter{rubypreintrusion={`立,0.5}, rubypostintrusion={`立,0.5}}%
142 は\ltjruby{美}{うつく}しい\quad
143 は\ltjruby{聴衆}{ちようしゆう}と\quad
144 は\ltjruby{暁}{あかつき}立\quad
145 は\ltjruby{聴衆}{ちようしゆう}立\par}
146 \end{description} 
147
148 \end{description}
149 \item[stretchruby=\{<left>\}\{<middle>\}\{<right>\}] 親文字の合計長が
150 ルビ文字の合計長より長い時に,ルビ文字の前・間・後に入れる空白の割合であり,
151 それぞれ0--7の自然数で指定する.
152 既定値は\ \verb+{1}{2}{1}+ である.
153 <left>はルビ文字の先頭までの空き量,<middle>はルビ文字間の空き量,<right>はルビ文字の末尾からの
154 空き量(の比)を表す.以下が例である.
155 \begin{LTXexample}[width=0.3\textwidth, preset=\Large]
156 \ltjruby[stretchruby=123,maxmargin=2]%
157   {◯◯◯◯}{◆◆}
158 \end{LTXexample}
159 \item[stretch=\{<left>\}\{<middle>\}\{<right>\}]
160 行中形でルビ文字の方が長い場合,親文字の前・中・後に入れる空白の割合.
161 既定値は\ \verb+{1}{2}{1}+ である.それ以外の代表的な値としては,例えば次のようなものがある.
162 \begin{description}
163 \item[親文字均等割禁止] \verb+{1}{0}{1}+\ など<middle>を0にした値
164 \item[前突出禁止] \verb+{0}{1}{1}+
165 \item[後突出禁止] \verb+{1}{1}{0}+
166 \end{description}
167
168 \item[stretchbol=\{<left>\}\{<middle>\}\{<right>\}] 行頭形〜.
169 既定値は\ \verb+{0}{1}{1}+ である.
170 \item[stretcheol=\{<left>\}\{<middle>\}\{<right>\}] 行末形〜.
171 既定値は\ \verb+{1}{1}{0}+ である.
172
173 \item[maxmargin=<real>] 親文字の方がルビより長い時に,ルビの先頭と親文字の先頭,及び
174 ルビ末尾と親文字の末尾の間に許される最大の空白量.\textbf{親文字全角単位}で指定し,既定値は0.5.
175
176 \medskip
177 \item[size=<real>] ルビ文字の親文字に対する大きさ.既定値は0.5.
178 \item[intergap=<real>] ルビ文字と親文字との空きを親文字全角単位で指定.既定値は0.
179 \item[rubysmash=<bool>] ルビの高さを0にするか.既定値は偽.次が例である.
180 \begin{LTXexample}[width=0.3\textwidth, preset=\Large]
181 \ \vrule width 0pt height 2\zw depth 1\zw
182 \frame{\ltjruby[rubysmash=false]{本}{ほん}}\ 
183 \frame{\ltjruby[rubysmash=true]{本}{ほん}}\ 
184 \frame{\ltjruby[rubysmash=false,intergap=0.2]
185   {本}{ほん}}\ 
186 \frame{\ltjruby[rubysmash=true,intergap=0.2]
187   {本}{ほん}}\ 
188 \frame{\ltjruby[rubysmash=false,intergap=-1.5]
189   {本}{ほん}}
190 \end{LTXexample}
191
192
193 \item[kenten=<command>]各文字につく圏点の出力命令を指定する.既定値は「\verb+\ltjalchar`•+」
194 であり,\texttt{U+2022} (Bullet)を\textbf{ALchar}として出力することを指定している.
195
196 \item[fontcmd=<command>]ルビ用のフォント切り替え命令を指定する.
197 このキーの内容が実行された後に\ \verb+\fontsize...\selectfont+\ が実行されるので,
198 このキーの指定では最後に\ \verb+\selectfont+ を加える必要はない.
199
200 この \texttt{fontcmd} キーの内容は多くの回数実行される.
201 例えば,\textsf{luatexja-fontspec}パッケージを用いてOpenTypeフォントを用いる場合,
202 \begin{lstlisting}
203  fontcmd=\addjfontfeatures{Style=Ruby}
204 \end{lstlisting}
205 のようにしてルビ用字形を用いることが可能だが,現在の実装ではタイプセットに時間がかかるようになる.
206
207
208 \end{description}
209
210 \medskip
211 次の2つは,以上で説明した複数のオプションを一度に設定するためのものである.
212 普通はこの2つのうちいずれかを設定するだけで足りるだろう.
213
214 \begin{description}
215 \def\makelabel#1{\ttfamily\bfseries #1}
216 \item[naka] 以下のオプションを同時に設定する.主に中付きルビを組むときに用いる.
217 \begin{verbatim}
218 mode=1, stretch={1}{2}{1}, stretchruby={1}{2}{1}
219 \end{verbatim}
220 \item[kata] 同様に,肩付きルビ用に,次を設定する.
221 \begin{verbatim}
222 mode=9, stretch={1}{2}{1}, stretchruby={0}{0}{1}
223 \end{verbatim}
224 \end{description}
225
226 \paragraph{\cs{ltjsetruby}\{<option>\}}
227 <option>の既定値を指定する.\textsf{luatexja-ruby}読み込み時の値は
228 各項目の所で既に説明してあるが,次のようになっている.
229 \begin{verbatim}
230   pre=-1, post=-1, mode=1, 
231   stretchruby={1}{2}{1}, stretch = {1}{2}{1},
232   stretchbol={0}{1}{1}, stretcheol={1}{1}{0},
233   maxmargin=0.5, size=0.5, intergap=0, rubysmash=false,
234   kenten=\ltjalchar`•, fontcmd=\relax
235 \end{verbatim}
236
237 \paragraph{\texttt{\textbackslash ltjsetparamater} に追加されるキー}
238 \begin{description}
239 \item[\Param{rubypreintrusion}\ttfamily =\{<chr\_code>, <pre\_int>\}]
240 文字<chr\_code> に,その\textbf{直後}のルビによって掛けられるルビ文字列の最大長をルビ全角単位で指定.
241 \item[\Param{rubypostintrusion}\ttfamily =\{<chr\_code>, <post\_int>\}]
242 文字<chr\_code> に,その\textbf{直前}のルビによって掛けられるルビ文字列の最大長をルビ全角単位で指定.
243 \end{description}
244 既定値は,\Param{rubypreintrusion},~\Param{rubypostintrusion}とも
245 以下の文字に対しては1,その他の文字については0である:
246 \begin{quote}
247  平仮名(\texttt{U+3040}--\texttt{U+309F}),カギ括弧「」,読点「,」「、」,中黒「・」
248 \end{quote}
249 また,ここでは「文字コード$-1$の文字」は,「段落開始の \verb+\parindent+」を表す%
250 \footnote{通常の\LuaTeX-jaにおける指定では文中数式境界を表していることに注意.}.
251 この「文字」に対する\Param{rubypreintrusion}の値も1である.
252
253 \paragraph{\texttt{\textbackslash ltjkenten}}
254 圏点を出力する命令で,\verb+\kenten+ という別名を定義している.
255 \begin{quote}
256  \ttfamily\cs{ltjkenten}[<option>]\{親文字\}
257 \end{quote}
258 のように使用する.複数文字に圏点をつける場合でも,\verb+\ltjruby+ のように「\texttt{|}」を使って
259 文字を区切る\textbf{必要はない}ことに注意してほしい.
260
261 圏点として出力される文字は \texttt{kenten} キーによって指定し,
262 圏点自身の大きさは(ルビと同様に)\texttt{size} キーで指定する.
263
264 \subsection{グループの\ruby{指|定}{し|てい}}
265 \label{ssec:grp}
266 \begin{quote}
267 \ttfamily\cs{ltjruby}[<option>]\{親|文|字\}\{おや|も|じ\}
268 \end{quote}
269 のように,\verb+\ltjruby+\ の第2・第3引数内の「\verb+|+」はグループの区切りを表す.
270 グループの数は両者で一致しなければならず,
271 \verb+\ltjruby{紋章}{もん|しよう}+ のようには\emph{できない}.
272
273 1グループのみのルビ(単純グループルビ)はグループルビとして組まれる.そのため,
274 もしモノルビを使いたければ,面倒でも
275 \begin{LTXexample}[width=0.4\textwidth, preset=\Large]
276 の\ltjruby{紋}{もん}\ltjruby{章}{しよう}が
277 \end{LTXexample}
278 のように,複数回使用すること.
279 また,全てのグループにおいて「ルビ文字列の長さは親文字列以下」であれば,
280 単純グループルビの並びとして扱われる.すなわち,次の2行は全くの等価となる.
281 \begin{verbatim}
282 \ltjruby{普|通|車}{ふ|つう|しや}
283 \ltjruby{普}{ふ}\ltjruby{通}{つう}\ltjruby{車}{しや}
284 \end{verbatim}
285
286 複数グループかつ上記の条件を満たさない場合は,
287 所謂「可動グループルビ」であり,ルビの前後や各グループの切れ目で行分割が可能となる.
288 例えば
289 \begin{verbatim}
290 …の\ltjruby{表|現|力}{ひよう|げん|りよく}は…
291 \end{verbatim}
292 という入力からは得られる組版結果は,次のいずれかになる.
293 \begin{center}
294  \begin{tabular}{ll}
295  \toprule
296  改行なし(行中形)&\Large …の\ltjruby{表|現|力}{ひよう|げん|りよく}は…\\
297  直前で改行&\Large \vrule \ltjruby[stretch=011]{表|現|力}{ひよう|げん|りよく}は…\\
298 &\Large …の\ltjruby[stretch=110]{表}{ひよう}
299     \vrule\ltjruby[stretch=011]{現|力}{げん|りよく}は…\\
300 &\Large …の\ltjruby[stretch=110]{表|現}{ひよう|げん}
301     \vrule\ltjruby[stretch=011]{力}{りよく}は…\\
302  直後に改行&\Large …の\ltjruby[stretch=110]{表|現|力}{ひよう|げん|りよく}\vrule\\
303 \bottomrule
304  \end{tabular}
305 \end{center}
306 \begin{itemize}
307  \item これらの行分割によってペナルティは発生しない.
308  \item 上記の例で見られるように,
309 2ブロック以上をまとめて組むときは,全体を1つのグループルビのように組版する(JIS~X~4051と同様).
310 『日本語組版処理の要件』では,
311 附属書Fに「熟語の構成,さらにその熟語の前後にくる文字の種類を考慮して配置する方法」として
312 別の方法を解説しているが,こちらの方法は現時点ではサポートしていないので,
313 面倒でも手動で \texttt{pre}, \texttt{post} などを使って頑張って欲しい.
314  \item 実装方法の都合により,ルビの直前・直後・途中で2箇所以上の改行が起きる場合,例えば
315 \begin{center}
316  \begin{tabular}{lll}
317  \toprule
318  \Large …の\ltjruby[stretch=110]{表}{ひよう}
319     \vrule\ltjruby[stretch=010]{現|力}{げん|りよく}\vrule&
320 \Large \vrule\ltjruby[stretch=010]{表|現}{ひよう|げん}
321     \vrule\ltjruby[stretch=011]{力}{りよく}は…&
322 \Large \vrule\ltjruby[stretch=010]{表|現|力}{ひよう|げん|りよく}\vrule\\
323 \bottomrule
324  \end{tabular}
325 \end{center}
326 などの組み方は\emph{想定していない}.
327 \end{itemize}
328
329 \newpage
330
331 \section{\ruby{注|意|点}{ちゆう|い|てん}}
332 \begin{description}
333 \item[ルビ文字のはみ出し]
334 「日本語組版処理の要件」の図3.82のように,
335 ルビ文字のはみ出しが繋がらないようにする処理について述べる.
336
337 例えば,
338 \begin{LTXexample}[preset=\Large,width=0.3\textwidth]
339 \ltjruby{陵}{りよう}と\ltjruby{陵}{みささぎ}\\
340 \ltjruby{陵}{りよう}と\ltjruby[pre=1]{陵}{みささぎ}
341 \end{LTXexample} 
342 において,1行目右側の「\ltjruby{陵}{みささぎ}」のルビが前の「と」にかかる量は次のように決まる:
343 \begin{enumerate}
344 \item 1回目の実行では,行分割前に「\ltjruby{陵}{りよう}」の後側進入量は前もって知ることはでき
345       ない.なので,「\ltjruby{陵}{りよう}」は行中形で組まれるものとして
346 「\ltjruby{陵}{みささぎ}」前側進入許容量は
347 \[
348  \underbrace{0.5\,\mathrm{zw}}_{\text{元々の許容量}}
349 -\underbrace{0.25\,\mathrm{zw}}_{\text{前のルビの後側進入量(行中形)}}=0.25\,\mathrm{zw}
350 \]
351 となる.行分割後,「\ltjruby{陵}{りよう}」の実際の後側進入量は
352 auxファイルに記述される.
353 \item 2回目以降の実行では,auxファイルに保存された「\ltjruby{陵}{りよう}」の後側進入量
354 を用いて,「\ltjruby{陵}{みささぎ}」前側進入許容量を次のように計算する:
355 \[
356  \underbrace{0.5\,\mathrm{zw}}_{\text{元々の許容量}}
357 -\underbrace{0.25\,\mathrm{zw}}_{\text{前のルビの後側進入量 (from aux)}}=0.25\,\mathrm{zw}.
358 \]
359 \end{enumerate}
360 auxファイルに保存する際,各 \verb+\ltjruby+ 命令の呼び出しを識別するキーが必要になるが,
361 そのキーとしては単純に「何個目の \verb+\ltjruby+ 命令か」である.
362
363 なお,以上の処理は,1行目と2行目を比較すれば分かるように,
364 「\ltjruby{陵}{みささぎ}」の\emph{前進入許容量指定(\texttt{pre})が自動}になっている場合のみ
365 実施される.
366
367 \item[段落末尾のルビ]
368 段落がルビで終わった場合,そのルビが行末形で組まれることはない.
369 これは,段落の「本当の」末尾には \verb+\penalty10000\parfillskip+ があるためで,
370 ルビ処理用に作った最後のグルー(\ref{sec:impl}\nobreak 節の説明では$g_2$)が消去されないことによる.
371
372 \verb+\parfillskip+ の長さ(や,場合によっては \verb+\rightskip+)を実測し,
373 それによって処理を変えるのも可能だが,そのようなことはしなかった.
374 段落がルビで終わることは普通ない(最低でも句点が続くだろう)と思うからである.
375
376
377
378 \item[段落先頭のルビ]
379 同様に,段落先頭のルビは行頭形にはならない.
380 \texttt{pre}が負(つまり,自動指定)のとき,段落最初の \verb+\parindent+ 部分への
381 進入は可能である.\verb+\parindent+ 部分への進入許容量は
382 「文字$-1$」に対する\Param{rubypreintrusion}(既定値は1,ルビ全角単位)と
383 \ \verb+\parindent+ の長さのうち小さい方である.
384 \begin{LTXexample}[preset=\Large,width=0.4\textwidth]
385 \parindent1\zw\noindent 012345\par
386 \ltjruby{陵}{みささぎ}は……\par
387 \ltjruby{承}{うけたまわ}り……\par
388 \parindent0.25\zw\ltjruby{陵}{みささぎ}は……
389 \end{LTXexample}
390
391
392 \end{description}
393
394 \newpage
395 \section{\ruby{実|装}{じつ|そう}について}
396 \label{sec:impl}
397 次の例で実装の大まかな方法を説明する.
398 \begin{LTXexample}[preset=\Large]
399 ……を\ltjruby{流|暢}{りゆう|ちよう}に……
400 \end{LTXexample}
401
402 \begin{enumerate}
403 \item \verb|\ltjruby|コマンド自体は,一旦次のnode listを値とするwhatsit~$W$を作って,
404 現在の水平リストへと挿入する(必要ならば\verb|\leavevmode|も実行):
405 \[
406  \Node{whatsit $w$}{value: 2}\longrightarrow 
407  \Node{hlist $s_1$}{「りゆう」}\longrightarrow
408  \Node{hlist $p_1$}{「流」}\longrightarrow
409  \Node{hlist $s_2$}{「ちよう」}\longrightarrow
410  \Node{hlist $p_2$}{「暢」}
411 \]
412 ここで,最初の$w$の値2は,ルビが2つのパーツ「\ltjruby{流}{りゆう}」「\ltjruby{暢}{ちよう}」からなっていることを
413 表している.この値を$\mathit{cmp}$とおこう.
414 $s_i$達の中の文字は既にルビの大きさである.
415 \item \LuaTeX-jaの和文処理グルー挿入処理において,
416 このwhatsit~$W$はまとめて
417 「先頭が『流』,最後が『暢』であるようなhboxを \verb|\unhbox| で展開したもの」と扱われる.
418 言い換えれば,ルビ部分を無視した単なる「流暢」という和文文字の並びとして扱われる\footnote{「流」「暢」の間のグルーは既に入っている,と扱われる.}.
419 次のサンプルを参照
420 \begin{LTXexample}[preset=\Large]
421 \leavevmode\hbox{.}A\\
422 %↑xkanjiskip 
423 \ltjruby{.}{}A
424 %↑2分
425 \end{LTXexample}
426 \item 和文処理グルーの挿入が終わった後で,可動グループルビのためのノードの挿入に入る.
427 \begin{enumerate}
428 \item $W$の前後に$2\mathit{cmp}+1=5$個のノードが挿入され,$W$の周辺は次のようなノード列になる.
429 \begin{align*}
430  (\text{other nodes})&\longrightarrow
431  \Node{glue $g_0$}{}\longrightarrow \Node{whatsit~$W$}{元からある}\longrightarrow \Node{rule $r_1$}{}
432 \\&\longrightarrow
433  \Node{glue $g_1$}{}\longrightarrow \Node{rule $r_2$}{}\longrightarrow 
434  \Node{glue $g_2$}{}\longrightarrow (\text{other nodes})
435 \end{align*}
436
437 \item このようにノードを挿入する目的は,\TeX の行分割処理自体に影響を加えずに可動グループルビ
438 を実現させることにある.
439 \begin{gather*}
440  (\text{other nodes})\longrightarrow
441  \Node{glue $g_0$}{}\longrightarrow \Node{whatsit~$W$}{元からある}\longrightarrow \Node{rule $r_1$}{}\\
442 \noalign{\hrulefill 行の境目\hrulefill}
443 \Node{rule $r_2$}{}\longrightarrow 
444  \Node{glue $g_2$}{}\longrightarrow (\text{other nodes})
445 \end{gather*}
446 のようになったとしたら,「\ltjruby{流}{りゆう}」「\ltjruby{暢}{ちよう}」の間で行分割が起きた,ということがわかり,
447 $g_i$,~$r_i$達のノードを適切に置き換えればよい(後で詳しく説明する).
448
449 \begin{figure}\centering\small
450 \begin{tabular}{cllll}
451 \toprule
452 \multicolumn{1}{c}{\bf ノード}&\multicolumn{1}{c}{\bf 組み方}&\multicolumn{1}{c}{\bf サンプル}%
453 &\multicolumn{1}{c}{\bf 対応するノード並び}\\
454 \midrule
455 $n_1$&行末1グループ&
456 \Large
457 \fbox{を}{\color{blue!50!black}\gt\ltjruby[pre=1,mode=5,stretch=110]{流}{りゆう}}\vrule
458 &
459 $g_0\rightarrow W\rightarrow r_1$\\
460 $n_2$&行末2グループ&
461 \Large
462 \fbox{を}{\color{blue!50!black}\gt\ltjruby[pre=1,mode=1,stretch=110]{流|暢}{りゆう|ちよう}}\vrule
463 &
464 $g_0\rightarrow W\rightarrow r_1\rightarrow g_2 \rightarrow r_2$\\
465 $n_3$&行頭1グループ&
466 \Large
467 \vrule{\color{blue!50!black}\gt\ltjruby[post=1,mode=1,stretch=011]{暢}{ちよう}}\fbox{に}
468 &
469 $r_2\rightarrow g_2$\\
470 $n_4$&行頭2グループ&
471 \Large
472 \vrule{\color{blue!50!black}\gt\ltjruby[post=1,mode=1,stretch=011]{流|暢}{りゆう|ちよう}}\fbox{に}
473 &
474 $W\rightarrow r_1\rightarrow g_2 \rightarrow r_2\rightarrow g_2$\\
475 $n_5$&行中&
476 \Large
477 \fbox{を}{\color{blue!50!black}\gt\ltjruby[post=0.5,pre=0.5,mode=1]{流|暢}{りゆう|ちよう}}\fbox{に}
478 &
479 $g_0\rightarrow W\rightarrow r_1\rightarrow g_2 \rightarrow r_2\rightarrow g_2$\\
480
481 \bottomrule
482 \end{tabular}
483 \caption{ルビの組み方と対応するノード並び}
484 \label{fig:node}
485 \end{figure}
486
487 \item なお,$r_i$達の高さ・深さは組み上がった後のそれである.
488 $g_i$,~$r_i$達の幅は,図\nobreak\ref{fig:node}に示したような対応に沿って算出する.
489 例えばこの場合,行中形$n_5$に対して
490 \[
491  g_0+r_1+g_2+r_2+g_2 = 3\,\mathrm{zw}-(0.25\,\mathrm{zw}\times 2)=2.5\,\mathrm{zw}
492 \]
493 という方程式が立つ(zwは親文字全角の幅,進入量込).
494 $n_1$から$n_5$まで計5本の方程式が立つが,これらはGau\ss の消去法で解くことができて
495 $g_i$,~$r_i$達の幅が求まる.
496 \item また,ルビ処理を統括しているwhatsit~$W$の値も
497 \[
498  \Node{whatsit $w$}{value: 2}\longrightarrow 
499  \Node{vlist $n_1$}{末1}\longrightarrow
500  \Node{vlist $n_2$}{末2}\longrightarrow
501  \Node{vlist $n_3$}{頭1}\longrightarrow
502  \Node{vlist $n_4$}{頭2}\longrightarrow
503  \Node{vlist $n_5$}{中}
504 \]
505 に置き換えておく.
506
507 \end{enumerate}
508
509 \item \LuaTeX の行分割処理を普通に行う.
510 \item 行分割の結果に従って,$g_i$,~$r_i$達を適切に置換する.
511
512 例えば行分割の結果
513 \begin{gather*}
514  (\text{other nodes})\longrightarrow
515  \Node{glue $g_0$}{}\longrightarrow \Node{whatsit~$W$}{元からある}\longrightarrow \Node{rule $r_1$}{}
516   \tag{行A}\\
517 \noalign{\hrulefill 行の境目\hrulefill}
518 \Node{rule $r_2$}{}\longrightarrow 
519  \Node{glue $g_2$}{}\longrightarrow (\text{other nodes})\tag{行B}
520 \end{gather*}
521 のようになったとしよう.
522 \begin{enumerate}
523 \item 処理は段落の上の行から順番に行われる.行Aの処理がまわってきたとしよう.
524
525 \item 行Aの先頭から順番に眺めていく.すると「whatsit~$W$由来」のノード,$g_0$,~$W$,~$r_1$が見つかり,
526 行Aはここで終わっている.
527
528 まず,行Aのhboxの中身からwhatsit~$W$を消去(リストから取り除くだけで,$W$のメモリを解放するわけではない)する.
529 $g_0$,~($W$,)~$r_1$というノードの並びは,「行末1グループ」$n_1$に対応しているので,
530 $g_0$,~$r_1$を行Aから除去・メモリ解放し,代わりに$n_1$を行Aの中身に追加する.
531
532 \item 次に行Bの処理にうつる.行Aでルビの処理は完了していない(2グループのルビなのにまだ1グループしか使っていない)ので,
533 「whatsit~$W$由来」のノードがいくつか行B内に残っているはずである.
534
535 案の定,$r_2$,~$g_2$というノード列が見つかった.これは「行頭1グループ」$n_3$に対応しているので,
536 $r_2$,~$g_2$を行Bから除去・メモリ解放し,代わりに$n_3$を行Bの中身に挿入する.
537
538 \item これで2グループとも使い切ったことになるので,
539 隔離しておいた$W$を,(使われなかった$n_2$,~$n_4$,~$n_5$などと共に)メモリ解放する.結果として
540 次のようになった:
541 \begin{gather*}
542  (\text{other nodes})\longrightarrow
543  \Node{vlist $n_1$}{末1}\tag{行A}\\
544 \noalign{\hrulefill 行の境目\hrulefill}
545 \Node{vlist $n_3$}{頭1}\longrightarrow (\text{other nodes})\tag{行B}
546 \end{gather*}
547 \end{enumerate}
548 \end{enumerate}
549
550 \newpage
551 \section{いくつかの例}
552 \def\rubytest{\ruby{黄金橋}{ゴールデンゲートブリッジ}\relax}
553
554 \setbox0=\vbox{\hsize=22\zw%
555 ああああ\rubytest いうえおかきくけこ
556 あ\rubytest いうえおかきくけこ
557 あ\rubytest いうえおかきくけこ
558 あ\rubytest いうえおかきくけこ
559 あ\rubytest いうえおかきくけこ
560 あ\rubytest いうえおかきくけこ}
561 %\directlua{ltj.ext_show_node_list(tex.box[0], '? ', print)}
562 \fbox{\box0}
563
564 \def\rubytest{\ruby{国府津}{こうづ}\relax}
565 % グループルビ
566
567 \setbox0=\vbox{\hsize=18\zw%
568 あ\rubytest いうえおかきくけこ
569 あ\rubytest いうえおかきくけこ
570 あ\rubytest いうえおかきくけこ
571 あ\rubytest いうえおかきくけこ
572 あ\rubytest いうえおかきくけこ
573 あ\rubytest いうえおかきくけこ}
574 %\directlua{ltj.ext_show_node_list(tex.box[0], '? ', print)}
575 \fbox{\box0}
576
577 \def\rubytest{\ruby{●●|◆}{◆◆◆◆◆◆|●●●}\relax}
578 \setbox0=\vbox{\hsize=19\zw%
579 あ\rubytest いうえおかきくけこ
580 あ\rubytest いうえおかきくけこ
581 あ\rubytest いうえおかきくけこ
582 あ\rubytest いうえおかきくけこイ
583 あ\rubytest いうえおかきくけこ
584 あ\rubytest いうえおかきくけこウ
585 あ\rubytest いうえおかきくけこエ
586 あ\rubytest いうえおかきくけこ
587 あ\rubytest いうえおかきくけこ
588 あ\rubytest いうえおかきくけこ}
589 %\directlua{ltj.ext_show_node_list(tex.box[0], '? ', print)}
590 \fbox{\box0}
591
592 \def\rubytest{\ruby{●●|□}{◆◆◆|●●●}\relax}
593 \setbox0=\vbox{\hsize=19\zw%
594 あ\rubytest いうえおかきくけこ
595 あ\rubytest いうえおかきくけこ
596 あ\rubytest いうえおかきくけこ
597 あ\rubytest いうえおかきくけこイ
598 あ\rubytest いうえおかきくけこ
599 あ\rubytest いうえおかきくけこウ
600 あ\rubytest いうえおかきくけこエ
601 あ\rubytest いうえおかきくけこ
602 あ\rubytest いうえおかきくけこ
603 あ\rubytest いうえおかきくけこ}
604 %\directlua{ltj.ext_show_node_list(tex.box[0], '? ', print)}
605 \fbox{\box0}
606
607 \def\rubytest{\ruby{異|様}{い|よう}\relax}
608 \setbox0=\vbox{\hsize=19\zw%
609 あ\rubytest いうえくけ
610 あ\rubytest いうえくけこ
611 あ\rubytest いうえくけこ
612 あ\rubytest いうえくけこイ
613 あ\rubytest いうえおかきくけこ}
614 %\directlua{ltj.ext_show_node_list(tex.box[0], '? ', print)}
615 \fbox{\box0}
616
617 \def\rubytest{\ruby{□|■|□}{■■|□□□|■■}\relax}
618
619 \setbox0=\vbox{\hsize=23\zw%
620 あ\rubytest いうえおかきくけこうえおかきくけこ
621 あ\rubytest いうえおかきくけこうえおかきくけこ
622 あ\rubytest いう□おかきくけこうえおかきくけこ
623 あ\rubytest いう□おかきくけこうえおかきくけこ
624 あ\rubytest いう□おかきくけこうえおかきくけこ
625 あ\rubytest いうえおかきくけこ}
626 \fbox{\box0}
627
628 \begin{description}
629 \def\sample{又\ruby{承}{うけたまわ}る\quad \ruby{疎}{そ}\quad は\ruby{俄}{にわか}勉強
630   \quad 後\ruby{俄}{にわか}勉強\quad は\ruby{暁}{あかつき}に
631   は\ruby{俄}{にわか}に
632   \quad \ruby{休|憩|中}{きゆう|けい|ちゆう}かつ\ruby{視|聴|中}{し|ちよう|ちゆう}}
633 \item[標準] \sample
634 \item[肩つき] {\ltjsetruby{kata}\sample}
635 \end{description}
636
637 \newpage
638 \begin{LTXexample}[pos=t]
639 {\ltjsetruby{stretch=101}% 親文字均等割り禁止
640     \ruby{休|憩|中}{きゆう|けい|ちゆう}かつ\ruby{視|聴|中}{し|ちよう|ちゆう}%
641 }\quad
642 \textgt{\ruby{勉|強}{べん|きよう}と%
643     \ruby[fontcmd=\mcfamily]{勉|強}{べん|きよう}}\quad% ルビは明朝体
644 \ruby{コギト・エルゴ・スム}{Cogito ergo sum}\quad   % 欧文空白は伸長しない
645 \ruby[size=1]{Cogito ergo sum}{コギト・エルゴ・スム}% 欧文空白は伸長しない
646 \end{LTXexample}
647
648 \newpage
649 \section{『日本語組版処理の要件』20120403の例}
650
651 \newcommand*{\噂}{\CID{7642}}
652 \newcommand*{\倦}{\CID{7674}}
653 %================================== 横組
654 \paragraph{3.3.1節}\ 
655 \begin{LTXexample}[pos=t]
656 \obeylines
657 3.49 \ruby{君|子}{くん|し}は\ruby{和}{わ}して\ruby{同}{どう}ぜず
658 3.50 \ruby{人}{ひと}に\ruby{誨}{おし}えて\ruby{\倦}{う}まず
659 % モノルビ.面倒でも複数回の実行が必要
660 3.51 \ruby{鬼}{き}\ruby{門}{もん}の\ruby{方}{ほう}\ruby{角}{がく}を%
661      \ruby{凝}{ぎょう}\ruby{視}{し}する
662 % 熟語ルビ
663 3.52 \ruby{鬼|門}{き|もん}の\ruby{方|角}{ほう|がく}を\ruby{凝|視}{ぎよう|し}する
664 3.53 \ruby{茅場町}{かやばちよう}\quad\ruby{茅|場}{かや|ば}\ruby{町}{ちよう}
665 % 熟字訓
666 3.54 \ruby{紫陽花}{あじさい}\quad\ruby{坩堝}{るつぼ}\quad\ruby{田舎}{いなか}
667 % グループルビ
668 3.55 \ruby{模型}{モデル}\quad\ruby{顧客}{クライアント}\quad%
669      \ruby{境界面}{インターフエース}\quad\ruby{避難所}{アジール}
670 3.56 \ruby{編集者}{editor}\quad \ruby{editor}{エデイター}
671 \end{LTXexample}
672
673 \paragraph{3.3.3節}\ 
674 \begin{LTXexample}[pos=t]
675 \obeylines
676 3.58 に\ruby{幟}{のぼり}を\quad に\ruby[kata]{幟}{のぼり}を\quad%
677      \ruby{韋}{い}\ruby{編}{へん}\ruby{三}{さん}\ruby{絶}{ぜつ}
678 % 三分ルビ.JY3/mc/mc は本文書のプリアンブルで独自に定義
679 3.59 に\ruby[fontcmd=\kanjifamily{mc}\kanjiseries{mc}]{幟}{のぼり}を
680 % ルビ文字を小さくする
681 3.60 {\Large%
682   \ruby{韋}{い}\ruby{編}{へん}\ruby{三}{さん}\ruby{絶}{ぜつ}\quad% 比較用
683   \ltjsetruby{size=0.375}% 0.5 -> 0.375
684   \ruby{韋}{い}\ruby{編}{へん}\ruby{三}{さん}\ruby{絶}{ぜつ}}
685 \end{LTXexample}
686
687 \paragraph{3.3.4節}
688 3.61図(両側ルビ)は未サポートにより省略
689
690 \newpage
691 \paragraph{3.3.5節 モノルビ}\ 
692 \begin{LTXexample}[pos=t]
693 \obeylines
694 3.62 の\ruby{葯}{やく}に
695 3.63 版面の\ruby{地}{ち}に\quad 版面の\ruby[kata]{地}{ち}に
696 % 横組肩つきはしないが,現状では縦組未サポートだし,仕方ないね
697 3.65 の\ruby{砦}{とりで}に
698 {\ltjsetruby{kata}%
699 3.66上 の\ruby{旬}{しゆん}に\quad 後\ruby{旬}{しゆん}に
700 3.66下 の\ruby{旬}{しゆん}又\quad 後\ruby{旬}{しゆん}又}
701 \end{LTXexample}
702
703
704 \paragraph{3.3.6節 グループルビ}\ 
705 \begin{LTXexample}[pos=t]
706 \obeylines
707 3.67 は\ruby{冊子体}{コーデツクス}と
708 3.68 \ruby{模型}{モデル}\quad \ruby{利用許諾}{ライセンス}
709 % 両端を揃える流儀
710 3.69 {\ltjsetruby{stretchruby=010}%
711      \ruby{模型}{モデル}\quad \ruby{利用許諾}{ライセンス}}
712 % ルビが極端に短い場合
713 3.70 \ruby{なげきの聖母像}{ピエタ}\quad% ルビ全角まで許容
714      \ruby[maxmargin=0.75]{なげきの聖母像}{ピエタ}% ルビ全角1.5倍まで
715 % ルビが長い場合
716 3.71 \ruby{顧客}{クライアント}\quad \ruby{境界面}{インターフエース}
717 3.72 {\ltjsetruby{stretch=010, stretchbol=010, stretcheol=010}% はみ出さない流儀
718      \ruby{顧客}{クライアント}\quad \ruby{境界面}{インターフエース}}
719 \end{LTXexample} 
720
721 \newpage
722 \paragraph{3.3.7節 熟語ルビ}\ 
723 \begin{LTXexample}[pos=t]
724 \obeylines
725 3.73 \ruby{杞|憂}{き|ゆう}\quad \ruby{畏|怖}{い|ふ}\quad%
726      \ruby[kata]{杞|憂}{き|ゆう}\quad \ruby[kata]{畏|怖}{い|ふ}
727 3.74 の\ruby{流|儀}{りゆう|ぎ}を\quad   の\ruby{無|常}{む|じよう}を\quad%
728      の\ruby{成|就}{じよう|じゆ}を\quad の\ruby{紋|章}{もん|しよう}を\quad%
729      の\ruby{象|徴}{しよう|ちよう}を
730 % 熟語の構成を考慮した方法は現行ではできない.
731 % 行分割はできるのだが,「他の漢字にルビ全角までかかって良い」は難しい.
732 3.75 {\ltjsetruby{kata}%
733      の\ruby{流|儀}{りゆう|ぎ}を\quad   の\ruby{無|常}{む|じよう}を\quad%
734      の\ruby{成|就}{じよう|じゆ}を\quad の\ruby{紋|章}{もん|しよう}を\quad%
735      の\ruby{象|徴}{しよう|ちよう}を}
736 % モノルビ配置.望ましくない
737 3.76× の\ruby{流}{りゆう}\ruby{儀}{ぎ}を\quad の\ruby{無}{む}\ruby{常}{じよう}を\quad%
738
739 要調整 3.77\ {\ltjsetruby{stretchbol=121, stretcheol=121}% 行頭・行末揃えず
740      \hbox{\vrule\vbox{\hsize=10\zw ああああああああの%
741         \ruby{流|儀}{りゆう|ぎ}がある.}\vrule}\textbf{←なぜ改行できない}\quad%
742      \hbox{\vrule\vbox{\hsize=5\zw ……等の\ruby{無|常}{む|じよう}を}\vrule}}
743 \end{LTXexample} 
744
745 \paragraph{3.3.8節 ルビはみ出し}\ 
746 \begin{LTXexample}[pos=t]
747 \obeylines
748 3.78 \ruby{人}{ひと}は\ruby{死}{し}して\ruby{名}{な}を\ruby{残}{のこ}す
749 % 現在の自動設定の仕様では「脚」の前が四分だけ「要件」の例より空く
750 3.79 漢字の部首には\ruby{偏}{へん}・\ruby{冠}{かんむり}・\ruby{脚}{きやく}・%
751      \ruby{旁}{つくり}がある
752 3.79 漢字の部首には\ruby{偏}{へん},\ruby{冠}{かんむり},\ruby{脚}{きやく},%
753      \ruby{旁}{つくり}がある
754 \end{LTXexample}
755 \begin{LTXexample}[pos=t]
756 \obeylines
757 % もちろん手動で進入量を指定すれば話は別
758 3.79 漢字の部首には\ruby{偏}{へん}・\ruby{冠}{かんむり}・\ruby[pre=1]{脚}{きやく}・%
759      \ruby{旁}{つくり}がある
760 3.79 漢字の部首には\ruby{偏}{へん},\ruby{冠}{かんむり},\ruby[pre=1]{脚}{きやく},%
761      \ruby{旁}{つくり}がある
762 3.79 この\ruby{\噂}{うわさ}の好きな人は\ruby{懐}{ふところ}ぐあいもよく、\ruby{檜}{ひのき}を
763 3.80 漢字の部首には「\ruby{偏}{へん}」「\ruby{冠}{かんむり}」「\ruby{脚}{きやく}」%
764 「\ruby{旁}{つくり}」がある
765 3.80 この\ruby{\噂}{うわさ}好きな人は\ruby{懐}{ふところ}具合もよく、\ruby{檜}{ひのき}材を
766 3.81× に\ruby{暁}{あかつき}の\kern-1\zw の\ruby{趣}{おもむき}を
767 3.82 に\ruby{暁}{あかつき}の\ruby{趣}{おもむき}を
768
769 % 漢字にルビを2分まで掛けても良い流儀
770 {%
771   \ltjsetparameter{rubypostintrusion={`好,0.5}}
772   \ltjsetparameter{rubypostintrusion={`具,0.5}}
773   \ltjsetparameter{rubypostintrusion={`材,0.5}}
774 3.83 この\ruby{\噂}{うわさ}の好きな人は\ruby{懐}{ふところ}ぐあいもよく、\ruby{檜}{ひのき}を
775 3.83 この\ruby{\噂}{うわさ}好きな人は\ruby{懐}{ふところ}具合もよく、\ruby{檜}{ひのき}材を
776 }
777 % 平仮名にもルビを掛けない流儀
778 {\catcode`\<12%
779   \makeatletter\count@="3040\loop\relax\ifnum \count@<"30A0%
780   \ltjsetparameter{rubypreintrusion={\the\count@,0}, %
781     rubypostintrusion={\the\count@,0}}%
782   \advance\count@1 \repeat
783 3.84 この\ruby{\噂}{うわさ}の好きな人は\ruby{懐}{ふところ}ぐあいもよく、\ruby{檜}{ひのき}を
784 3.84 この\ruby{\噂}{うわさ}好きな人は\ruby{懐}{ふところ}具合もよく、\ruby{檜}{ひのき}材を
785 }
786 \end{LTXexample}
787 \begin{LTXexample}[pos=t]
788 \obeylines
789 3.85\ {\ltjsetruby{stretchbol=121, stretcheol=121}% 行頭・行末揃えず
790 \hbox{\vrule\vbox{\hsize=15\zw
791  \hskip9.5\zw……の\ruby{徑}{こみち}を……%
792 \hskip9\zw……の\ruby{徑}{こみち}を……}\vrule}}
793 3.86\ \hbox{\vrule\vbox{\hsize=15\zw
794  \hskip10\zw……の\ruby{徑}{こみち}を……%
795 \hskip9\zw……の\ruby{徑}{こみち}を……}\vrule}
796 3.87\  \hbox{\vrule\vbox{\hsize=15\zw
797  \hskip8\zw……共\ruby{飾り}{アクセサリー}等……%
798 \hskip9\zw……共\ruby{飾り}{アクセサリー}等……}\vrule}
799 \end{LTXexample}
800
801
802 \paragraph{圏点の例(常用漢字表前書きより)}
803 この表は,法令,公⽤⽂書,新聞,雑誌,放送など,⼀般の社会⽣活におい%
804 て\kenten[kenten=﹅]{現代の国語を書き表す}場合の\kenten{漢字使⽤の⽬安を⽰す}ものである。
805
806 \subparagraph{「﹅」の大きさを親文字の0.33倍にした例}
807 この表は,法令,公⽤⽂書,新聞,雑誌,放送など,⼀般の社会⽣活におい%
808 て\kenten[size=0.33, kenten=﹅]{現代の国語を書き表す}場合の\kenten{漢字使⽤の⽬安を⽰す}ものである。
809 \end{document}