doc/luatexja-ruby.tex

   1 %#! lualatex
   2 %%% a test of ruby.
   3 \documentclass[a4paper,10ptj]{ltjsarticle}
   4 \usepackage[rgb]{xcolor}
   5 \usepackage{enumitem,mleftright}
   6 \usepackage{luatexja-otf,amsmath,bxghost}
   7 \usepackage[no-math]{fontspec}
   8 \usepackage[match]{luatexja-fontspec}
   9 \usepackage[haranoaji]{luatexja-preset}\normalsize
  10 \setmonojfont{HaranoAjiGothic-Regular.otf}
  11 \usepackage{unicode-math}
  12 \setmathfont{Latin Modern Math}
  13
  14 \def\emph#1{\textbf{\textgt{#1}}}
  15 \def\headfont{\normalfont\bfseries\gtfamily}
  16 \def\cs#1{\eghostguarded{\texttt{\textbackslash#1}}}
  17 \usepackage[textwidth=45\zw, lines=45, footskip=2\zh]{geometry}
  18 \advance\leftmargini-1\zw\advance\leftmarginii-1\zw
  19 \protected\def\Param#1{\eghostguarded{\underline{\smash{\textsf{\mdseries #1}}}}}
  20
  21 \usepackage{luatexja-ruby,showexpl,booktabs}
  22 \definecolor{mygreen}{rgb}{0,0.5,0}
  23 \lstset{
  24   preset=\normalsize, basicstyle=\small\ttfamily, basewidth=0.5em,
  25   explpreset={numberstyle=\tiny, numbers=left, numbersep=1em, columns=fixed},
  26   morecomment=[l]{\%}, commentstyle=\color{mygreen}
  27 }
  28 \makeatletter\let\SX@Info=\relax\makeatother
  29 \fboxsep=0mm
  30
  31 \usepackage{hyperref,bookmark,xcolor}
  32 \hypersetup{%
  33         unicode,
  34         colorlinks,
  35         allbordercolors=1 1 1,
  36         allcolors=blue,
  37         pdftitle={luatexja-ruby.sty}
  38 }
  39
  40 \def\Node#1#2{\,\vcenter{\hbox{\fboxsep=1pt\fbox{\vbox{\small\halign{\hfil##\hfil\cr
  41   #1\mathstrut\cr\noalign{\smallskip\hrule height.4pt\smallskip}\strut\<#2\cr}}}}}\,}
  42 \def\LuaTeX{Lua\TeX}
  43
  44 % 三分ルビ用
  45 \DeclareFontShape{JY3}{mc}{mc}{n}{<-> [0.92487]
  46   HaranoAjiMincho-Regular:extend=0.67;jfm=ujisc33}{}
  47
  48 %%%% \ltjruby 内に \texorpdfstring + | 除去を仕込む
  49 \RequirePackage{xparse}
  50 \makeatletter
  51 \def\removevert#1{\if\noexpand#1|%
  52     \expandafter\expandafter\expandafter\@firstofone\expandafter{%
  53   \else\ifnum0=1}\fi#1%
  54     \ifx#1\relax\expandafter\@gobble%
  55     \else\expandafter\@firstofone
  56     \fi{\expandafter\@firstofone
  57   \fi
  58   \removevert}}
  59 \makeatother
  60 \ExplSyntaxOn
  61 \cs_set_eq:NN \myorigltjruby \ltjruby
  62 \DeclareExpandableDocumentCommand {\ltjruby} { O{} m m } {%
  63    \texorpdfstring {
  64     \exp_not:n { \myorigltjruby[#1]{#2}{#3} }
  65   } {
  66     \removevert #2 \relax
  67   }
  68 }
  69 \cs_set_eq:NN \ruby \ltjruby
  70 \ExplSyntaxOff
  71 %%%%
  72
  73 \title{\textsf{luatexja-ruby}パッケージ}
  74 \author{\LuaTeX-jaプロジェクトチーム}
  75 \date{\texttt{\csname ver@luatexja-ruby.sty\endcsname}（\today）}
  76 \makeatletter
  77 \def\mybox#1{\unskip\ {\Large \fboxrule=0.1mm\fboxsep=0mm\fcolorbox{cyan}{white}{\hbox{\<\ltjjachar#1\<}}}\ }
  78
  79 \begin{document}
  80
  81 \catcode`\<=13
  82 \def<#1>{{\rmfamily\mdseries\itshape$\langle$#1\/$\rangle$}}
  83 %\fontsize{13.19873}{15}\selectfont%
  84
  85 \maketitle
  86
  87 \begin{abstract}
  88 \textsf{luatexja-ruby}パッケージは，\LuaTeX-jaの機能を利用してルビの組版処理を行う追加パッケージである．
  89 \LuaTeX, \LuaTeX-jaの内部処理に割り込むことにより，熟語ルビ中の行分割や，
  90 行頭形・行中形・行末形の自動検出，また進入許容量の自動設定などを可能とした．
  91
  92 v0.3より前とは親文字の高さの扱いが変わっている（\texttt{baseheight}キーを参照せよ）ほか，
  93 \Param{rubypreintrusion}, \Param{rubypostintrusion}パラメータの初期値が変わっているので注意すること．
  94 \end{abstract}
  95
  96 \tableofcontents
  97
  98 \newpage
  99 \section{\ltjruby{利|用|方|法}{り|よう|ほう|ほう}}
 100 パッケージ読み込みは，\verb+\usepackage{luatexja-ruby}+ で良く，
 101 必要ならば自動的に\LuaTeX-ja本体を読み込む．
 102 plain \LuaTeX でのロードはまだサポートしておらず，
 103 \LaTeXe のみサポートしている．
 104
 105 \subsection{\ltjruby{用|語}{よう|ご}}
 106 「進入(intrusion)」「突出(protrusion)」という用語は，
 107 \href{http://zrbabbler.sp.land.to/pxrubrica.html}{\textsf{pxrubrica}パッケージ}%
 108 での用法に準ずる．
 109
 110 \begin{quote}
 111   進入あり：と\ltjruby{暁}{あかつき}の\\
 112   進入なし：と\ltjruby[mode=0]{暁}{あかつき}の\\
 113   突出あり：\ltjruby[stretch={1}{2}{1}]{聴衆}{ちようしゆう}\\
 114   突出なし：\ltjruby[stretch={0}{2}{0}]{聴衆}{ちようしゆう}
 115 \end{quote}
 116
 117 なお，本パッケージでは親文字と直前・直後の文字の間に0でない和文処理グルー
 118 \footnote{JFMで指定されたグルーや，標準の和文間空白(\Param{kanjiskip})，標準の和欧文間空白(\Param{xkanjiskip})．}%
 119 がくることも考慮しているため，「\emph{前後の文字への}\underline{進入（許容）量}」と「進入（許容）量」とは異なる可能性がある．
 120 この文書では次のように称する：
 121 \begin{description}
 122   \item[\underline{文字進入量}] 前後の文字へルビ文字が実際にかかる長さ．常に下線を引くことにする．
 123   \item[進入量] 前後の文字，およびそれとルビの間の和文処理グルーにかかる長さ
 124 \end{description}
 125 多くの場合，和文処理グルーは0以上の長さのため，進入量は\underline{文字進入量}以上である．
 126
 127 例えば次の例では，直前の文字「来」への\underline{前文字進入量}は0であるが，
 128 前進入量は（和欧文間空白にかかる分まで含めるので）正である．
 129 \begin{quote}
 130   \Large
 131   本来\ltjruby{foohoge}{\vrule ほげほげふがふが\vrule}においては……\\
 132   本来foohogeにおいては……
 133 \end{quote}
 134
 135 \subsection{\ruby{命|令}{めい|れい}}
 136 \paragraph{\cs{ltjruby}}
 137 ルビ出力用命令の本体．\verb+\ruby+ という別名を定義している．
 138 \begin{quote}
 139 \ttfamily \textbackslash ltjruby[<option>]\{親|文|字\}\{おや|も|じ\}
 140 \end{quote}
 141 のように親文字→ルビの順序で指定する．
 142 第2・第3引数内の「\verb+|+」はグループの区切りを表す．詳細は\ref{ssec:grp}\nobreak 小節を参照．
 143
 144 \medskip
 145 <option>には以下の内容をkey-valueリストで指定可能である．
 146 <real>は10進の実数値を表す．<bool>は真偽値\texttt{true}（真）か\texttt{false}（偽）であり，
 147 値を省略したときには\texttt{true}の意味になる．
 148
 149 \begin{description}
 150 \def\makelabel#1{\ttfamily\bfseries #1}
 151 \item[pre=<real>] \underline{前文字進入許容量}をルビ全角単位で指定．
 152 負の長さを指定した場合は，ルビの状況や直前の文字に応じた自動指定を意味する．
 153 既定値は負（つまり，自動指定）．
 154
 155 \item[post=<real>] 同様に，\underline{後文字進入許容量}を指定する．既定値は負（自動指定）．
 156
 157 \item[mode] 進入処理のモードを表すbit vector．下位2\,bitは，\texttt{pre}や
 158 \texttt{post}が負である場合にしか効力を発揮しない．既定値は$(0001)_2 = 1$．
 159 \begin{description}
 160  \item[bit 0] 前後の\underline{文字への進入}を無効にするならば0，有効にするならば1．
 161  \item[bit 1] 前進入許容量$B$と後進入許容量$A$が異なった場合，
 162   そのまま処理する場合は0，小さい方に揃えるならば1．
 163  \item[bit 2--3] ルビ文字の突出量から実際の前・後進入量の計算方法を指定する．
 164   詳しい計算方法については\ref{ssec:calc_intrusion}\nobreak 小節を参照．
 165 \end{description}
 166 \item[intrude\_jfmgk=<bool>] 進入量算出の際に，前後のJFMグルーの自然長を考慮するか否か．既定値は真．
 167 \item[intrude\_kanjiskip=<bool>] 進入量算出の際に，ルビ前後に挿入される
 168   標準の和文間空白(\Param{kanjiskip})の自然長を
 169   考慮するか否か．既定値は真．
 170 \item[intrude\_xkanjiskip=<bool>] 進入量算出の際に，ルビ前後に挿入される
 171   標準の和欧文間空白(\Param{xkanjiskip})の自然長を考慮するか否か．既定値は真．
 172 \item[stretchruby=\{<left>\}\{<middle>\}\{<right>\}] 親文字の合計長が
 173 ルビ文字の合計長より長い時に，ルビ文字の前・間・後に入れる空白の割合であり，
 174 それぞれ0--7の自然数で指定する．
 175 既定値は\ \verb+{1}{2}{1}+ である．
 176 <left>はルビ文字の先頭までの空き量，<middle>はルビ文字間の空き量，<right>はルビ文字の末尾からの
 177 空き量（の比）を表す．以下が例である．
 178 \begin{LTXexample}[width=0.3\textwidth, preset=\Large]
 179 \ltjruby[stretchruby=123,maxmargin=2]%
 180   {◯◯◯◯}{◆◆}
 181 \end{LTXexample}
 182 \item[stretch=\{<left>\}\{<middle>\}\{<right>\}]
 183 行中形でルビ文字の方が長い場合，親文字の前・中・後に入れる空白の割合．
 184 既定値は\ \verb+{1}{2}{1}+ である．それ以外の代表的な値としては，例えば次のようなものがある．
 185 \begin{description}
 186 \item[親文字均等割禁止] \verb+{1}{0}{1}+\ など<middle>を0にした値
 187 \item[前突出禁止] \verb+{0}{1}{1}+
 188 \item[後突出禁止] \verb+{1}{1}{0}+
 189 \end{description}
 190
 191 \item[stretchbol=\{<left>\}\{<middle>\}\{<right>\}] 行頭形に対する\texttt{stretch}と同様の指定．
 192 既定値は\ \verb+{0}{1}{1}+ である．
 193 \item[stretcheol=\{<left>\}\{<middle>\}\{<right>\}] 行末形に対する\texttt{stretch}と同様の指定．
 194 既定値は\ \verb+{1}{1}{0}+ である．
 195
 196 \item[maxmargin=<real>] 親文字の方がルビより長い時に，ルビの先頭と親文字の先頭，及び
 197 ルビ末尾と親文字の末尾の間に許される最大の空白量．\textbf{親文字全角単位}で指定し，既定値は0.5．
 198
 199 \medskip
 200 \item[size=<real>] ルビ文字の親文字に対する大きさ．既定値は0.5．
 201 \item[intergap=<real>] ルビ文字と親文字との空きを親文字全角単位で指定．既定値は0．
 202 \item[rubysmash=<bool>] ルビの高さを0にするか．既定値は偽．次が例である．
 203 \begin{LTXexample}[width=0.3\textwidth, preset=\Large]
 204 \ \vrule width 0pt height 2\zw depth 1\zw
 205 \frame{\ltjruby[rubysmash=false]{本}{ほん}}\
 206 \frame{\ltjruby[rubysmash=true]{本}{ほん}}\
 207 \frame{\ltjruby[rubysmash=false,intergap=0.2]
 208   {本}{ほん}}\
 209 \frame{\ltjruby[rubysmash=true,intergap=0.2]
 210   {本}{ほん}}\
 211 \frame{\ltjruby[rubysmash=false,intergap=-1.5]
 212   {本}{ほん}}
 213 \end{LTXexample}
 214 \item[ybaseheight=<real>] 非負の値が指定された場合，
 215   \emph{縦組以外での}親文字の高さを親文字全角の<real>倍と強制的に固定する．
 216   負の値が指定された場合は「固定しない」（すなわち，v0.3より前の挙動と同じになる）．
 217   既定値は$0.88$．
 218 \item[tbaseheight=<real>] \texttt{ybaseheight}と同様だが，こちらは\emph{縦組での}親文字の高さを指定する．
 219   既定値は$0.5$．
 220 \item[baseheight=<real>] \texttt{ybaseheight}，\texttt{tbaseheight}を同時に指定したことと同義．
 221 \begin{LTXexample}[width=0.3\textwidth, preset=\Large]
 222 \noindent
 223 \ltjruby[baseheight=0.88]{本}{ほん}\
 224 \ltjruby[baseheight=0.88]{dvi}{ディーヴィーアイ}\\
 225 \ltjruby[baseheight=0.5]{本}{ほん}\
 226 \ltjruby[baseheight=0.5]{dvi}{ディーヴィーアイ}\\
 227 \ltjruby[baseheight=0]{本}{ほん}\
 228 \ltjruby[baseheight=0]{dvi}{ディーヴィーアイ}\\
 229 \ltjruby[baseheight=-1]{本}{ほん}\
 230 \ltjruby[baseheight=-1]{dvi}{ディーヴィーアイ}
 231 \end{LTXexample}
 232 \item[yrubydepth=<real>] 非負の値が指定された場合，
 233   \emph{縦組以外での}ルビの深さをルビ全角の<real>倍と強制的に固定する．
 234   負の値が指定された場合は「固定しない」（すなわち，v0.52以前の挙動と同じになる）．
 235   既定値は$0.12$．
 236 \item[trubydepth=<real>] \texttt{yrubydepth}と同様だが，こちらは\emph{縦組での}ルビの深さを指定する．
 237   既定値は$0.5$．
 238 \item[rubydepth=<real>] \texttt{yrubydepth}，\texttt{trubydepth}を同時に指定したことと同義．
 239 \begin{LTXexample}[width=0.3\textwidth, preset=\Large]
 240 \noindent
 241 \ltjruby[rubydepth=0.12]{◆}{ほん}\
 242 \ltjruby[rubydepth=0.12]{◆}{pdf}\
 243 \ltjruby[rubydepth=0.12]{◆}{dvi}\\
 244 \ltjruby[rubydepth=0]{◆}{ほん}\
 245 \ltjruby[rubydepth=0]{◆}{pdf}\
 246 \ltjruby[rubydepth=0]{◆}{dvi}\\
 247 \ltjruby[rubydepth=-1]{◆}{ほん}\
 248 \ltjruby[rubydepth=-1]{◆}{pdf}\
 249 \ltjruby[rubydepth=-1]{◆}{dvi}
 250 \end{LTXexample}
 251
 252
 253
 254 \item[kenten=<command>]各文字につく圏点の出力命令を指定する．
 255   既定値は「\verb+\textbullet+」である．
 256
 257 \item[fontcmd=<command>]ルビ用のフォント切り替え命令を指定する．
 258 このキーの内容が実行された後に\ \verb+\fontsize...\selectfont+\ が実行されるので，
 259 このキーの指定では最後に\ \verb+\selectfont+ を加える必要はない．
 260
 261 この \texttt{fontcmd} キーの内容は多くの回数実行される．
 262 例えば，\textsf{luatexja-fontspec}パッケージを用いてOpenTypeフォントを用いる場合，
 263 \begin{lstlisting}
 264  fontcmd=\addjfontfeatures{Style=Ruby}
 265 \end{lstlisting}
 266 のようにしてルビ用字形を用いることが可能だが，現在の実装ではタイプセットに時間がかかるようになる．
 267
 268 \end{description}
 269
 270 \medskip
 271 次の2つは，以上で説明した複数のオプションを一度に設定するためのものである．
 272 普通はこの2\nobreak つのうちいずれかを設定するだけで足りるだろう．
 273
 274 \begin{description}
 275 \def\makelabel#1{\ttfamily\bfseries #1}
 276 \item[naka] 以下のオプションを同時に設定する．主に中付きルビを組むときに用いる．
 277 \begin{verbatim}
 278 mode=1, stretch={1}{2}{1}, stretchruby={1}{2}{1}
 279 \end{verbatim}
 280 \item[kata] 同様に，肩付きルビ用に，次を設定する．
 281 \begin{verbatim}
 282 mode=9, stretch={1}{2}{1}, stretchruby={0}{0}{1}
 283 \end{verbatim}
 284 \end{description}
 285
 286 \paragraph{\cs{ltjsetruby}\{<option>\}}
 287 <option>の既定値を指定する．\textsf{luatexja-ruby}読み込み時の値は
 288 各項目の所で既に説明してあるが，次のようになっている．
 289 \begin{verbatim}
 290   pre=-1, post=-1, mode=1,
 291   stretchruby={1}{2}{1}, stretch = {1}{2}{1},
 292   stretchbol={0}{1}{1}, stretcheol={1}{1}{0},
 293   maxmargin=0.5, size=0.5, intergap=0, rubysmash=false,
 294   kenten=\textbullet, fontcmd=\relax, ybaseheight=0.88, tbaseheight=0.5,
 295   yrubydepth=0.12, trubydepth=0.5,
 296   intrude_jfmgk, intrude_kanjiskip, intrude_xkanjiskip
 297 \end{verbatim}
 298
 299 \paragraph{\cs{ltjsetparamater} に追加されるキー}
 300 \begin{description}
 301 \item[\Param{rubypreintrusion}\ttfamily =\{<chr\_code>, <pre\_int>\}]
 302   文字<chr\_code> に，その\textbf{直後}のルビによって掛けられるルビ文字列の最大長
 303   （つまり，\underline{前文字進入許容量}）をルビ全角単位で指定．
 304
 305   \textbf{v0.5以降での変更点}：もし$-a$~($a>0$)を指定した場合は，実際の\underline{前文字進入許容量}は$a$となるが，
 306   文字<chr\_code>の前のJFMグルーに進入が発生した場合には，\underline{前文字進入許容量}が0でなかった場合は，の後のJFMグルーにはルビの進入は発生しない．
 307
 308 \item[\Param{rubypostintrusion}\ttfamily =\{<chr\_code>, <post\_int>\}]
 309   文字<chr\_code> に，その\textbf{直前}のルビによって掛けられるルビ文字列の最大長
 310   （つまり，\underline{後文字進入許容量}）をルビ全角単位で指定．
 311
 312   \textbf{v0.5以降での変更点}：もし$-a$~($a>0$)を指定した場合は，実際の\underline{後文字進入許容量}は$a$となるが，
 313   実際の\underline{後文字進入量}が0でなかった場合は，文字<chr\_code>の後のJFMグルーにはルビの進入は発生しない．
 314 \end{description}
 315 以下の文字は\Param{rubypreintrusion},~\Param{rubypostintrusion}とも初期値は1である：
 316 \begin{quote}
 317  ひらがな(\texttt{U+3040}--\texttt{U+309F})，カタカナ(\texttt{U+30A0}--\texttt{U+30FF})，
 318  仮名補助など(\texttt{U+1B000}--\texttt{U+1B16F})，\\
 319  分離禁止文字
 320  \@for\@tmp:=`\―,`\‥,`\…,`〳,`\〴,`\〵,"2014 \do{\mybox{\@tmp}}
 321 \end{quote}
 322 次に，以下の文字は\Param{rubypreintrusion},~\Param{rubypostintrusion}とも初期値は0.5である：
 323 \begin{quote}
 324  中点類\@for\@tmp:=`\・,`\：,`\； \do{\mybox{\@tmp}}
 325 \end{quote}
 326 また，以下の文字は\Param{rubypreintrusion}のみ初期値は$-1$である：
 327 \begin{quote}
 328   始め括弧類
 329   \@for\@tmp:=`\‘,`\“,`\〈,`\《,`\「,`\『,`\【,`\〔,`\〖,`\〘,`\〝,`\（,`\［,`\｛,`\｟ \do{\mybox{\@tmp}}\unskip，
 330   「文字コード$-1$の文字
 331   \footnote{段落開始の\ \cs{parindent}分インデントを表す．
 332     通常の\LuaTeX-jaにおける指定では「文字コード$-1$」は文中数式境界を表していることに注意．}」
 333 \end{quote}
 334 さらに，以下の文字は\Param{rubypostintrusion}のみ初期値は$-1$である：
 335 \begin{quote}
 336   閉じ括弧類
 337   \@for\@tmp:=`\’,`\”,`\〉,`\》,`\」,`\』,`\】,`\〕,`\〗,`\〙,`\〟,`\）,`\］,`\｝,`\｠ \do{\mybox{\@tmp}}\unskip，
 338   句読点類\@for\@tmp:=`\、,`\，,`\。,`\． \do{\mybox{\@tmp}}
 339 \end{quote}
 340 \makeatother
 341
 342 以上で記述されていない\Param{rubypreintrusion},~\Param{rubypostintrusion}の初期値はすべて0である．
 343
 344
 345 \paragraph{\cs{ltjkenten}}
 346 圏点を出力する命令で，\verb+\kenten+ という別名を定義している．
 347 \begin{quote}
 348  \ttfamily\cs{ltjkenten}[<option>]\{親文字\}
 349 \end{quote}
 350 のように使用する．複数文字に圏点をつける場合でも，\verb+\ltjruby+ のように「\texttt{|}」を使って
 351 文字を区切る\textbf{必要はない}（\verb+\kenten+内では「\texttt{|}」は特別な意味を持たない）
 352 ことに注意してほしい．
 353
 354 圏点として出力される文字は\texttt{kenten}キーによって指定し，
 355 圏点自身の大きさは（ルビと同様に）\texttt{size}キーで指定する．
 356
 357 \subsection{グループの\ruby{指|定}{し|てい}}
 358 \label{ssec:grp}
 359 \begin{quote}
 360 \ttfamily\cs{ltjruby}[<option>]\{親|文|字\}\{おや|も|じ\}
 361 \end{quote}
 362 のように，\verb+\ltjruby+\ の第2・第3引数内の「\verb+|+」はグループの区切りを表す．
 363 グループの数は両者で一致しなければならず，
 364 \verb+\ltjruby{紋章}{もん|しよう}+ のようには\emph{できない}．
 365
 366 1グループのみのルビ（単純グループルビ）はグループルビとして組まれる．そのため，
 367 もしモノルビを使いたければ，面倒でも
 368 \begin{LTXexample}[width=0.4\textwidth, preset=\Large]
 369 の\ltjruby{紋}{もん}\ltjruby{章}{しよう}が
 370 \end{LTXexample}
 371 のように，複数回使用すること．
 372 また，全てのグループにおいて「ルビ文字列の長さは親文字列以下」
 373 \footnote{%
 374   実際には\TeX での長さの計算誤差（$2^{-16}$~ptの整数倍として計算していることによる）を考慮し，
 375   親文字全角の$1/1000$だけルビ文字列が長くなることを許容している．
 376 }であれば，
 377 単純グループルビの並びとして扱われる．すなわち，次ページ冒頭の2行は全くの等価となる．
 378 \newpage
 379 \begin{verbatim}
 380 \ltjruby{普|通|車}{ふ|つう|しや}
 381 \ltjruby{普}{ふ}\ltjruby{通}{つう}\ltjruby{車}{しや}
 382 \end{verbatim}
 383
 384 複数グループかつ上記の条件を満たさない場合は，
 385 所謂「可動グループルビ」であり，ルビの前後や各グループの切れ目で行分割が可能となる．
 386 例えば
 387 \begin{verbatim}
 388 …の\ltjruby{表|現|力}{ひよう|げん|りよく}は…
 389 \end{verbatim}
 390 という入力からは得られる組版結果は，次のいずれかになる．
 391 \begin{center}
 392  \begin{tabular}{ll}
 393  \toprule
 394  改行なし（行中形）&\Large …の\ltjruby{表|現|力}{ひよう|げん|りよく}は…\\
 395  直前で改行&\Large \vrule \ltjruby[stretch=011]{表|現|力}{ひよう|げん|りよく}は…\\
 396 &\Large …の\ltjruby[stretch=110]{表}{ひよう}
 397     \vrule\ltjruby[stretch=011]{現|力}{げん|りよく}は…\\
 398 &\Large …の\ltjruby[stretch=110]{表|現}{ひよう|げん}
 399     \vrule\ltjruby[stretch=011]{力}{りよく}は…\\
 400  直後に改行&\Large …の\ltjruby[stretch=110]{表|現|力}{ひよう|げん|りよく}\vrule\\
 401 \bottomrule
 402  \end{tabular}
 403 \end{center}
 404 \begin{itemize}
 405  \item これらの行分割によってペナルティは発生しない．
 406  \item 上記の例で見られるように，
 407 2ブロック以上をまとめて組むときは，全体を1つのグループルビのように組版する（JIS~X~4051と同様）．
 408 『日本語組版処理の要件』では，
 409 附属書Fに「熟語の構成，さらにその熟語の前後にくる文字の種類を考慮して配置する方法」として
 410 別の方法を解説しているが，こちらの方法は現時点ではサポートしていないので，
 411 面倒でも手動で \texttt{pre}, \texttt{post} などを使って頑張って欲しい．
 412  \item 実装方法の都合により，ルビの直前・直後・途中で2箇所以上の改行が起きる場合，例えば
 413 \begin{center}
 414  \Large …の\ltjruby[stretch=110]{表}{ひよう}
 415     \vrule\ltjruby[stretch=010]{現|力}{げん|りよく}\vrule\qquad
 416 \Large \vrule\ltjruby[stretch=010]{表|現}{ひよう|げん}
 417     \vrule\ltjruby[stretch=011]{力}{りよく}は…\qquad
 418 \Large \vrule\ltjruby[stretch=010]{表|現|力}{ひよう|げん|りよく}\vrule
 419
 420 \end{center}
 421 などの組み方は\emph{想定していない}．
 422 エラーが発生して止まることもあるし，エラーが発生しなくても正しく組まれない．
 423 \end{itemize}
 424
 425
 426 \section{\ruby{注|意|点}{ちゆう|い|てん}}
 427 \paragraph{前後からのルビ文字のはみ出し1}
 428 「日本語組版処理の要件」の図117\footnote{2020-08-11版での番号．2012-04-03版では図3.82．}のように，
 429 前後からのルビ文字のはみ出しが繋がらないようにする処理が組み込まれている．
 430 例えば，
 431 \begin{LTXexample}[preset=\Large,width=0.3\textwidth]
 432 \ltjruby{陵}{りよう}と\ltjruby{陵}{みささぎ}\\
 433 \ltjruby{陵}{りよう}と\ltjruby[pre=1]{陵}{みささぎ}
 434 \end{LTXexample}
 435 において，1行目右側の「\ltjruby{陵}{みささぎ}」のルビが前の「と」にかかる量は次のように決まる：
 436 \begin{enumerate}
 437 \item 1回目の実行では，行分割前に「\ltjruby{陵}{りよう}」の\underline{後文字進入量}は前もって知ることはでき
 438       ない．そのため，「\ltjruby{陵}{りよう}」は行中形で組まれるものと想定し，
 439 「\ltjruby{陵}{みささぎ}」の前文字進入許容量は
 440 \[
 441  \underbrace{0.5\,\mathrm{zw}}_{\text{元々の許容量}}
 442 -\underbrace{0.25\,\mathrm{zw}}_{\text{前のルビの\underline{後文字進入量}（行中形）}}=0.25\,\mathrm{zw}
 443 \]
 444 となる．行分割後，「\ltjruby{陵}{りよう}」の実際の\underline{後文字進入量}は
 445 <jobname>\texttt{.ltjruby}ファイルに記述される．
 446 \item 2回目以降の実行では，<jobname>\texttt{.ltjruby}ファイルに保存された「\ltjruby{陵}{りよう}」の\underline{後文字進入量}
 447 を用いて，「\ltjruby{陵}{みささぎ}」の\underline{前文字進入許容量}を次のように計算する：
 448 \[
 449  \underbrace{0.5\,\mathrm{zw}}_{\text{元々の許容量}}
 450 -\underbrace{0.25\,\mathrm{zw}}_{\text{前のルビの\underline{後文字進入量}(from \texttt{.ltjruby})}}=0.25\,\mathrm{zw}.
 451 \]
 452 \end{enumerate}
 453
 454 <jobname>\texttt{.ltjruby}ファイルに保存する際，各 \verb+\ltjruby+ 命令の呼び出しを識別するキーが必要になるが，
 455 そのキーとしては単純に「何個目の \verb+\ltjruby+ 命令か」である．
 456
 457 なお，以上の処理は，1行目と2行目を比較すれば分かるように，
 458 「\ltjruby{陵}{みささぎ}」の\emph{\underline{前文字進入許容量}指定(\texttt{pre})が自動}になっている場合のみ
 459 実施される．
 460
 461
 462 \paragraph{前後からのルビ文字のはみ出し2}
 463 また，本パッケージのv0.**以降では，「日本語組版処理の要件」にある
 464 \begin{quote}
 465   後ろにくる終わり括弧類，句点類若しくは読点類，又は前にくる始め括弧類には，
 466   最大でルビ文字サイズの全角までルビ文字を掛けてもよい．
 467   この場合，後ろにくる終わり括弧類，句点類若しくは読点類の後ろの空き量，
 468   又は前にくる始め括弧類の前の空き量に掛けてはならない．
 469 \end{quote}
 470 という処理も組み込まれており，<jobname>\texttt{.ltjruby}に「前後の和文処理グルーに正の量だけ進入したか」という情報を
 471 保存することによって実装されている．
 472
 473 \paragraph{段落末尾のルビ}
 474 段落がルビで終わった場合，そのルビが行末形で組まれることはない．
 475 これは，段落の「本当の」末尾には \verb+\penalty10000\parfillskip+ があるためで，
 476 ルビ処理用に作った最後のグルー（\ref{ssec:impl}\nobreak 小節の説明では$g_2$）が消去されないことによる．
 477
 478 \verb+\parfillskip+ の長さ（や，場合によっては \verb+\rightskip+）を実測し，
 479 それによって処理を変えるのも可能だが，そのようなことはしなかった．
 480 段落がルビで終わることは普通ない（最低でも句点が続くだろう）と思うからである．
 481
 482 \paragraph{段落先頭のルビ}
 483 同様に，段落先頭のルビは行頭形にはならない．
 484 \texttt{pre}が負（つまり，自動指定）のとき，段落最初の \verb+\parindent+ 分への
 485 進入は可能である．ここ\verb+\parindent+ 分のインデントへの\underline{進入許容量}は
 486 「文字$-1$」に対する\Param{rubypreintrusion}（既定値は1，ルビ全角単位）と
 487 \ \verb+\parindent+ の長さのうち小さい方である．
 488 \begin{LTXexample}[preset=\Large,width=0.4\textwidth]
 489 \parindent1\zw\noindent ０１２３４５\par
 490 \ltjruby{陵}{みささぎ}は……\par
 491 \ltjruby{承}{うけたまわ}り……\par
 492 \parindent0.25\zw\ltjruby{陵}{みささぎ}は……
 493 \end{LTXexample}
 494
 495 \paragraph{和文処理グルーの伸縮}
 496 現バージョンでは，進入量調整に和文処理グルーを考慮させる，
 497 \begin{quote}
 498 \texttt{intrude\_jfmgk}, \texttt{intrude\_kanjiskip}, \texttt{intrude\_xkanjiskip}キー
 499 \end{quote}
 500 の値が\texttt{true}（真）で
 501 あった状況でも，考慮されるのは\emph{自然長の値のみ}である．そのため，行の調整処理が発生した場合は
 502 意図しない結果となる．
 503
 504 例えば，標準設定での中黒「・」の直後のルビからの中黒への進入許容量は
 505 \begin{quote}
 506   中黒「・」への\underline{前進入許容量}はルビ全角の半分で，
 507   中黒本体の後の四分空きには進入可能
 508 \end{quote}
 509 となっている．そのため，下の例の1, 2行目ともルビの前進入量は0.5\,zwとなる．
 510 しかし，2行目では詰め量の0.5\,zwがほとんど中黒周囲の四分空きで負担されるため，
 511 実際には「中黒本体にほぼ0.5\,zwが進入する」という望ましくない結果が得られている．
 512 \begin{LTXexample}[preset=\Large,width=0.4\textwidth]
 513 \leavevmode\hbox{あ・\ltjruby{◆}{◆◆◆◆}漢字}\\
 514 \hbox spread-0.5\zw{あ・\ltjruby{◆}{◆◆◆◆}漢字}
 515 \end{LTXexample}
 516
 517 また，次の例では2行目では前後の\underline{文字進入量}がルビ1字分と等しくなっているが，
 518 3行目のように1全角伸ばすという調整が行われた後は\underline{文字進入量}が不揃いになってしまっている．
 519 これはもともと「\texttt{;}」には後側にのみ和欧文間空白が入ることと，3行目ではこの和欧文間空白が
 520 伸びているためである．
 521 \begin{LTXexample}[preset=\Large,width=0.4\textwidth]
 522 \leavevmode\hbox{……に%
 523   \ltjruby{\texttt{;}}{セミコロン}という……}\\
 524 \hbox spread\zw{……に%
 525   \ltjruby{\texttt{;}}{セミコロン}という……}
 526 \end{LTXexample}
 527
 528 \newpage
 529 \section{\ruby{実|装}{じつ|そう}について}
 530 \subsection{進入量の計算}
 531 \label{ssec:calc_intrusion}
 532 ルビ文字を自然に組んだときの幅が親文字のそれより多い場合，
 533 ルビの前後への進入量は次のように決定される．
 534 \begin{enumerate}[label=\emph{Step~\arabic*},labelindent=0pt,itemindent=*,itemsep=\medskipamount]
 535   \item \underline{前文字進入許容量}$B_0$，\underline{後進入文字許容量}$A_0$の算出．
 536
 537   ルビ全角の長さを$r$とする．
 538   \begin{enumerate}
 539    \item \texttt{pre}の指定値が非負であった場合は，それに$r$を掛けたものを$B_0$とする．\\
 540     そうでなかった場合は，「ルビの直前の文字」に対する
 541     \Param{rubypreintrusion}の値に$r$を掛けたものを$B_0$とする
 542     \footnote{%
 543       なお，「ルビの直前の文字」が段落最初の\cs{parindent}分のインデントであった場合，
 544       $B_0$を，「文字コード$-1$の文字」\Param{rubypreintrusion}の値に$r$を掛けた値と\cs{parindent}のうち
 545       小さい方とする．
 546     }．
 547    \item \texttt{post}の指定値が非負であった場合は，それに$r$を掛けたものを$A_0$とする．\\
 548     そうでなかった場合は，「ルビの直後の文字」に対する
 549     \Param{rubypostintrusion}の値にルビ全角の値を掛けたものを$A_0$とする．
 550    \item \texttt{mode}の最下位ビット(bit~0)が0であった場合は，$B_0\leftarrow 0$, $A\leftarrow 0$とする．
 551    \item もし2つ前の文字がルビで，その直後（つまりいま処理しているルビから見れば直前）
 552     の文字へ$a'$だけの進入があった場合，現在のルビについて$B_0←\min(0,B_0-a')$とする．
 553   \end{enumerate}
 554   \item 前進入許容量$B$，後進入許容量$A$の算出．
 555   \begin{enumerate}
 556     \item まず$B\leftarrow B_0$,\ \ $A\leftarrow A_0$とする．
 557     \item ルビとその直前の文字の間に和文処理グルー$g$が挿入された場合，
 558     \begin{itemize}
 559       \item $g$がJFMグルーの場合は，\texttt{intrude\_jfmgk}が真の場合に，
 560       \item $g$が標準の和文間空白(\Param{kanjiskip})の場合は，
 561       \texttt{intrude\_kanjiskip}が真の場合に，
 562       \item $g$が標準の和欧文間空白(\Param{xkanjiskip})の場合は，
 563       \texttt{intrude\_xkanjiskip}が真の場合に，
 564     \end{itemize}
 565     それぞれ$g$の自然長を$B$に加算する．
 566
 567     ルビとその直後の文字との間に和文処理グルーが挿入された場合も同様である．
 568
 569     \item \texttt{mode}の2番目のビット(bit~1)が0であった場合は，$B$,~$A\leftarrow \min(B,A)$とする．
 570   \end{enumerate}
 571   \item 実際の前進入量$b$，後進入量$a$の計算．
 572
 573   ルビ文字の突出量を$x$，
 574   親文字の文字数を$k+1$，親文字の前に入る空白量・間の空白量・後ろの空白量の比を$p:q:r$とする．
 575   このとき，\texttt{mode}のbit 2,~3の値によって$b$,~$a$を次のように算出する：
 576 \begin{description}[labelindent=\zw]
 577  \item[00] $b=\min(B, xp/(p+kq+r))$, \ $a=\min(A, xr/(p+kq+r))$
 578  \item[01] $b=\min(B, x)$, \ $a=\min(A, \max(x-b,0))$
 579  \item[10] $a=\min(A, x)$, \ $b=\min(B, \max(x-a,0))$
 580  \item[11] $M=\min(B,A)$とおく．もし$x\le 2M$ならば$b=a=x/2$．そうでなければ
 581 \[
 582  b=\min\mleft(B, M + \frac{(x-2M)p}{p+kq+r}\mright),\qquad
 583  a=\min\mleft(A, M + \frac{(x-2M)r}{p+kq+r}\mright).
 584 \]
 585 \end{description}
 586
 587 組み方の具体例を実際に示す．例示のため，平仮名にはルビが1字まで，「立」にはルビを
 588 0.5字分までかけてよいことにしている．
 589 \begin{description}[labelindent=\zw]
 590 \item[00]{\setkeys[ltj]{ruby}{mode=1}%
 591 \ltjsetparameter{rubypreintrusion={`立,0.5}, rubypostintrusion={`立,0.5}}%
 592 は\ltjruby{美}{うつく}しい
 593   \quad は\ltjruby{聴衆}{ちようしゆう}と\quad
 594 は\ltjruby{暁}{あかつき}立\quad
 595 は\ltjruby{峠}{とうげ}立\quad
 596 は\ltjruby{聴衆}{ちようしゆう}立\par}
 597 \item[01]{\setkeys[ltj]{ruby}{mode=5}%
 598 \ltjsetparameter{rubypreintrusion={`立,0.5}, rubypostintrusion={`立,0.5}}%
 599 は\ltjruby{美}{うつく}しい
 600   \quad は\ltjruby{聴衆}{ちようしゆう}と\quad
 601 は\ltjruby{暁}{あかつき}立\quad
 602 は\ltjruby{峠}{とうげ}立\quad
 603 は\ltjruby{聴衆}{ちようしゆう}立\par}
 604 \item[10]{%
 605 \setkeys[ltj]{ruby}{mode=9}%
 606 \ltjsetparameter{rubypreintrusion={`立,0.5}, rubypostintrusion={`立,0.5}}%
 607 は\ltjruby{美}{うつく}しい
 608   \quad は\ltjruby{聴衆}{ちようしゆう}と\quad
 609 は\ltjruby{暁}{あかつき}立\quad
 610 は\ltjruby{峠}{とうげ}立\quad
 611 は\ltjruby{聴衆}{ちようしゆう}立\par}
 612 \item[11]{\setkeys[ltj]{ruby}{mode=13}%
 613 \ltjsetparameter{rubypreintrusion={`立,0.5}, rubypostintrusion={`立,0.5}}%
 614 は\ltjruby{美}{うつく}しい\quad
 615 は\ltjruby{聴衆}{ちようしゆう}と\quad
 616 は\ltjruby{暁}{あかつき}立\quad
 617 は\ltjruby{峠}{とうげ}立\quad
 618 は\ltjruby{聴衆}{ちようしゆう}立\par}
 619 \end{description}
 620 \end{enumerate}
 621
 622 \subsection{ノードの扱い}
 623 \label{ssec:impl}
 624 次の例で内部実装の大まかな方法を説明する．
 625 \begin{LTXexample}[preset=\Large]
 626 ……を\ltjruby{流|暢}{りゆう|ちよう}に……
 627 \end{LTXexample}
 628
 629 \begin{enumerate}
 630 \item \verb|\ltjruby|コマンド自体は，一旦次のnode listを値とするwhatsit~$W$を作って，
 631 現在の水平リストへと挿入する（必要ならば\verb|\leavevmode|も実行）：
 632 \[
 633  \Node{whatsit $w$}{value: 2}\longrightarrow
 634  \Node{hlist $s_1$}{「りゆう」}\longrightarrow
 635  \Node{hlist $p_1$}{「流」}\longrightarrow
 636  \Node{hlist $s_2$}{「ちよう」}\longrightarrow
 637  \Node{hlist $p_2$}{「暢」}
 638 \]
 639 ここで，最初の$w$の値2は，ルビが2つのパーツ「\ltjruby{流}{りゆう}」「\ltjruby{暢}{ちよう}」からなっていることを
 640 表している．この値を$\mathit{cmp}$とおこう．
 641 $s_i$達の中の文字は既にルビの大きさである．
 642 \item \LuaTeX-jaの和文処理グルー挿入処理において，
 643 このwhatsit~$W$はまとめて
 644 「先頭が『流』，最後が『暢』であるようなhboxを \verb|\unhbox| で展開したもの」と扱われる．
 645 言い換えれば，ルビ部分を無視した単なる「流暢」という和文文字の並びとして扱われる\footnote{「流」「暢」の間のグルーは既に入っている，と扱われる．}．
 646 次のサンプルを参照
 647 \begin{LTXexample}[preset=\Large]
 648 \leavevmode\hbox{．}A\\
 649 %↑xkanjiskip
 650 \ltjruby{．}{}A
 651 %↑2分
 652 \end{LTXexample}
 653 \item 和文処理グルーの挿入が終わった後で，可動グループルビのためのノードの挿入に入る．
 654 \begin{enumerate}
 655 \item $W$の前後に$2\mathit{cmp}+1=5$個のノードが挿入され，$W$の周辺は次のようなノード列になる．
 656 \begin{align*}
 657  (\text{other nodes})&\longrightarrow
 658  \Node{glue $g_0$}{}\longrightarrow \Node{whatsit~$W$}{元からある}\longrightarrow \Node{rule $r_1$}{}
 659 \\&\longrightarrow
 660  \Node{glue $g_1$}{}\longrightarrow \Node{rule $r_2$}{}\longrightarrow
 661  \Node{glue $g_2$}{}\longrightarrow (\text{other nodes})
 662 \end{align*}
 663
 664 \item このようにノードを挿入する目的は，\TeX の行分割処理自体に影響を加えずに可動グループルビ
 665 を実現させることにある．
 666 \begin{gather*}
 667  (\text{other nodes})\longrightarrow
 668  \Node{glue $g_0$}{}\longrightarrow \Node{whatsit~$W$}{元からある}\longrightarrow \Node{rule $r_1$}{}\\
 669 \noalign{\hrulefill 行の境目\hrulefill}
 670 \Node{rule $r_2$}{}\longrightarrow
 671  \Node{glue $g_2$}{}\longrightarrow (\text{other nodes})
 672 \end{gather*}
 673 のようになったとしたら，「\ltjruby{流}{りゆう}」「\ltjruby{暢}{ちよう}」の間で行分割が起きた，ということがわかり，
 674 $g_i$,~$r_i$達のノードを適切に置き換えればよい（後で詳しく説明する）．
 675
 676 \begin{figure}\centering\small
 677 \begin{tabular}{cllll}
 678 \toprule
 679 \multicolumn{1}{c}{\bf ノード}&\multicolumn{1}{c}{\bf 組み方}&\multicolumn{1}{c}{\bf サンプル}%
 680 &\multicolumn{1}{c}{\bf 対応するノード並び}\\
 681 \midrule
 682 $n_1$&行末1グループ&
 683 \Large
 684 \fbox{を}{\color{blue!50!black}\gt\ltjruby[pre=1,mode=5,stretch=110]{流}{りゆう}}\vrule
 685 &
 686 $g_0\rightarrow W\rightarrow r_1$\\
 687 $n_2$&行末2グループ&
 688 \Large
 689 \fbox{を}{\color{blue!50!black}\gt\ltjruby[pre=1,mode=1,stretch=110]{流|暢}{りゆう|ちよう}}\vrule
 690 &
 691 $g_0\rightarrow W\rightarrow r_1\rightarrow g_2 \rightarrow r_2$\\
 692 $n_3$&行頭1グループ&
 693 \Large
 694 \vrule{\color{blue!50!black}\gt\ltjruby[post=1,mode=1,stretch=011]{暢}{ちよう}}\fbox{に}
 695 &
 696 $r_2\rightarrow g_2$\\
 697 $n_4$&行頭2グループ&
 698 \Large
 699 \vrule{\color{blue!50!black}\gt\ltjruby[post=1,mode=1,stretch=011]{流|暢}{りゆう|ちよう}}\fbox{に}
 700 &
 701 $W\rightarrow r_1\rightarrow g_2 \rightarrow r_2\rightarrow g_2$\\
 702 $n_5$&行中&
 703 \Large
 704 \fbox{を}{\color{blue!50!black}\gt\ltjruby[post=0.5,pre=0.5,mode=1]{流|暢}{りゆう|ちよう}}\fbox{に}
 705 &
 706 $g_0\rightarrow W\rightarrow r_1\rightarrow g_2 \rightarrow r_2\rightarrow g_2$\\
 707
 708 \bottomrule
 709 \end{tabular}
 710 \caption{ルビの組み方と対応するノード並び}
 711 \label{fig:node}
 712 \end{figure}
 713
 714 \item なお，$r_i$達の高さ・深さは組み上がった後のそれである．
 715 $g_i$,~$r_i$達の幅は，図\nobreak\ref{fig:node}に示したような対応に沿って算出する．
 716 例えばこの場合，行中形$n_5$に対して
 717 \[
 718  g_0+r_1+g_2+r_2+g_2 = (3-0.25\times 2)\,\mathrm{zw}=2.5\,\mathrm{zw}
 719 \]
 720 という方程式が立つ（zwは親文字全角の幅，進入量込）．
 721 $n_1$から$n_5$まで計5本の方程式が立つが，これらはGau\ss の消去法で解くことができて
 722 $g_i$,~$r_i$達の幅が求まる．
 723 \item また，ルビ処理を統括しているwhatsit~$W$の値も
 724 \[
 725  \Node{whatsit $w$}{value: 2}\longrightarrow
 726  \Node{vlist $n_1$}{末1}\longrightarrow
 727  \Node{vlist $n_2$}{末2}\longrightarrow
 728  \Node{vlist $n_3$}{頭1}\longrightarrow
 729  \Node{vlist $n_4$}{頭2}\longrightarrow
 730  \Node{vlist $n_5$}{中}
 731 \]
 732 に置き換えておく．
 733
 734 \end{enumerate}
 735
 736 \item \LuaTeX の行分割処理を普通に行う．
 737 \item 行分割の結果に従って，$g_i$,~$r_i$達を適切に置換する．
 738
 739 例えば行分割の結果
 740 \begin{gather*}
 741  (\text{other nodes})\longrightarrow
 742  \Node{glue $g_0$}{}\longrightarrow \Node{whatsit~$W$}{元からある}\longrightarrow \Node{rule $r_1$}{}
 743   \tag{行A}\\
 744 \noalign{\hrulefill 行の境目\hrulefill}
 745 \Node{rule $r_2$}{}\longrightarrow
 746  \Node{glue $g_2$}{}\longrightarrow (\text{other nodes})\tag{行B}
 747 \end{gather*}
 748 のようになったとしよう．
 749 \begin{enumerate}
 750 \item 処理は段落の上の行から順番に行われる．行Aの処理がまわってきたとしよう．
 751
 752 \item 行Aの先頭から順番に眺めていく．すると「whatsit~$W$由来」のノード，$g_0$,~$W$,~$r_1$が見つかり，
 753 行Aはここで終わっている．
 754
 755 まず，行Aのhboxの中身からwhatsit~$W$を消去（リストから取り除くだけで，$W$のメモリを解放するわけではない）する．
 756 $g_0$,~($W$,)~$r_1$というノードの並びは，「行末1グループ」$n_1$に対応しているので，
 757 $g_0$,~$r_1$を行Aから除去・メモリ解放し，代わりに$n_1$を行Aの中身に追加する．
 758
 759 \item 次に行Bの処理にうつる．行Aでルビの処理は完了していない（2グループのルビなのにまだ1グループしか使っていない）ので，
 760 「whatsit~$W$由来」のノードがいくつか行B内に残っているはずである．
 761
 762 案の定，$r_2$,~$g_2$というノード列が見つかった．これは「行頭1グループ」$n_3$に対応しているので，
 763 $r_2$,~$g_2$を行Bから除去・メモリ解放し，代わりに$n_3$を行Bの中身に挿入する．
 764
 765 \item これで2グループとも使い切ったことになるので，
 766 隔離しておいた$W$を，（使われなかった$n_2$,~$n_4$,~$n_5$などと共に）メモリ解放する．結果として
 767 次のようになった：
 768 \begin{gather*}
 769  (\text{other nodes})\longrightarrow
 770  \Node{vlist $n_1$}{末1}\tag{行A}\\
 771 \noalign{\hrulefill 行の境目\hrulefill}
 772 \Node{vlist $n_3$}{頭1}\longrightarrow (\text{other nodes})\tag{行B}
 773 \end{gather*}
 774 \end{enumerate}
 775 \end{enumerate}
 776
 777 \newpage
 778 \section{いくつかの例}
 779 \def\rubytest{\ruby{黄金橋}{ゴールデンゲートブリッジ}\relax}
 780
 781 \setbox0=\vbox{\hsize=22\zw%
 782 ああああ\rubytest いうえおかきくけこ
 783 あ\rubytest いうえおかきくけこ
 784 あ\rubytest いうえおかきくけこ
 785 あ\rubytest いうえおかきくけこ
 786 あ\rubytest いうえおかきくけこ
 787 あ\rubytest いうえおかきくけこ}
 788 %\directlua{ltj.ext_show_node_list(tex.box[0], '? ', print)}
 789 \fbox{\box0}
 790
 791 \setbox0=\vbox{\hsize=30\zw\noindent
 792 \texttt{baseheight=0.88}での例\\
 793   ふぁいる\ruby[baseheight=0.88]{dvi}{ディーヴィーアイ}ファイル
 794   \ruby[baseheight=0.88]{oo}{ほーげーふーが}漢字\\
 795   ファイル\ruby[baseheight=0.88]{dvi}{ディーヴィーアイ}ふぁいる
 796   \ruby[baseheight=0.88]{oo}{ほーげーふーが}漢字\\
 797   ああ（\ruby{ほげ}{ふがふがふがふが}）」\ruby{ほげ}{ふがふがふがふが}「
 798   【\ruby{ほげ}{ふがふがふがふが}】\ruby{ほげ}{ふがふがふがふが}…
 799 }
 800 \fbox{\box0}
 801
 802 \def\rubytest{\ruby{国府津}{こうづ}\relax}
 803 % グループルビ
 804
 805 \setbox0=\vbox{\hsize=18\zw%
 806 あ\rubytest いうえおかきくけこ
 807 あ\rubytest いうえおかきくけこ
 808 あ\rubytest いうえおかきくけこ
 809 あ\rubytest いうえおかきくけこ
 810 あ\rubytest いうえおかきくけこ
 811 あ\rubytest いうえおかきくけこ}
 812 %\directlua{ltj.ext_show_node_list(tex.box[0], '? ', print)}
 813 \fbox{\box0}
 814
 815 \def\rubytest{\ruby{●●|◆}{◆◆◆◆◆◆|●●●}\relax}
 816 \setbox0=\vbox{\hsize=19\zw%
 817 あ\rubytest いうえおかきくけこ
 818 あ\rubytest いうえおかきくけこ
 819 あ\rubytest いうえおかきくけこ
 820 あ\rubytest いうえおかきくけこイ
 821 あ\rubytest いうえおかきくけこ
 822 あ\rubytest いうえおかきくけこウ
 823 あ\rubytest いうえおかきくけこエ
 824 あ\rubytest いうえおかきくけこ
 825 あ\rubytest いうえおかきくけこ
 826 あ\rubytest いうえおかきくけこ}
 827 %\directlua{ltj.ext_show_node_list(tex.box[0], '? ', print)}
 828 \fbox{\box0}
 829
 830 \def\rubytest{\ruby{●●|□}{◆◆◆|●●●}\relax}
 831 \setbox0=\vbox{\hsize=19\zw%
 832 あ\rubytest いうえおかきくけこ
 833 あ\rubytest いうえおかきくけこ
 834 あ\rubytest いうえおかきくけこ
 835 あ\rubytest いうえおかきくけこイ
 836 あ\rubytest いうえおかきくけこ
 837 あ\rubytest いうえおかきくけこウ
 838 あ\rubytest いうえおかきくけこエ
 839 あ\rubytest いうえおかきくけこ
 840 あ\rubytest いうえおかきくけこ
 841 あ\rubytest いうえおかきくけこ}
 842 %\directlua{ltj.ext_show_node_list(tex.box[0], '? ', print)}
 843 \fbox{\box0}
 844
 845 \def\rubytest{\ruby{異|様}{い|よう}\relax}
 846 \setbox0=\vbox{\hsize=19\zw%
 847 あ\rubytest いうえくけ
 848 あ\rubytest いうえくけこ
 849 あ\rubytest いうえくけこ
 850 あ\rubytest いうえくけこイ
 851 あ\rubytest いうえおかきくけこ}
 852 %\directlua{ltj.ext_show_node_list(tex.box[0], '? ', print)}
 853 \fbox{\box0}
 854
 855 \def\rubytest{\ruby{□|■|□}{■■|□□□|■■}\relax}
 856
 857 \setbox0=\vbox{\hsize=23\zw%
 858 あ\rubytest いうえおかきくけこうえおかきくけこ
 859 あ\rubytest いうえおかきくけこうえおかきくけこ
 860 あ\rubytest いう□おかきくけこうえおかきくけこ
 861 あ\rubytest いう□おかきくけこうえおかきくけこ
 862 あ\rubytest いう□おかきくけこうえおかきくけこ
 863 あ\rubytest いうえおかきくけこ}
 864 \fbox{\box0}
 865
 866 \begin{description}
 867 \def\sample{又\ruby{承}{うけたまわ}る\quad \ruby{疎}{そ}\quad は\ruby{俄}{にわか}勉強
 868   \quad 後\ruby{俄}{にわか}勉強\quad は\ruby{暁}{あかつき}に
 869   は\ruby{俄}{にわか}に
 870   \quad \ruby{休|憩|中}{きゆう|けい|ちゆう}かつ\ruby{視|聴|中}{し|ちよう|ちゆう}}
 871 \item[標準] \sample
 872 \item[肩つき] {\ltjsetruby{kata}\sample}
 873 \end{description}
 874
 875 \newpage
 876 \begin{LTXexample}[pos=t]
 877 {\ltjsetruby{stretch=101}% 親文字均等割り禁止
 878     \ruby{休|憩|中}{きゆう|けい|ちゆう}かつ\ruby{視|聴|中}{し|ちよう|ちゆう}%
 879 }\quad
 880 \textgt{\ruby{勉|強}{べん|きよう}と%
 881     \ruby[fontcmd=\mcfamily]{勉|強}{べん|きよう}}\quad% ルビは明朝体
 882 \ruby{コギト・エルゴ・スム}{Cogito ergo sum}\quad   % 欧文空白は伸長しない
 883 \ruby[size=1]{Cogito ergo sum}{コギト・エルゴ・スム}% 欧文空白は伸長しない
 884 \end{LTXexample}
 885
 886
 887 \typeout{AAAAAA}
 888 \setbox0=\vbox{\hsize20\zw
 889   \ltjsetparameter{rubypreintrusion={`◆,1}}
 890   \ltjsetparameter{rubypostintrusion={`◆,1}}
 891   \def\TEST{\ruby{CD}{◆ンパクト・ディス◆}}
 892   %\ltjsetparameter{xkanjiskip=.25\zw}
 893   ◆◆◆\TEST ◆◆◆◆◆◆◆◆◆◆◆\TEST %
 894   ◆◆◆◆◆◆\kern1\zw ◆◆◆◆◆◆◆◆◆\kern0.5\zw ◆◆◆◆◆◆◆◆◆◆◆◆◆◆\TEST ◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆◆
 895
 896   値とは\ruby{\texttt{;}}{セミコロン}で区切\\
 897   ◆\ruby{A}{◆}◆\\◆\ruby{A}{◆◆}◆\\◆\ruby{A}{◆◆◆}◆\\◆\ruby{A}{◆◆◆◆}◆\\%
 898   ◆\ruby{A}{◆◆◆◆◆}◆\\◆\ruby{A}{◆◆◆◆◆◆}◆\\◆A◆
 899
 900   \makebox[10\zw][s]{値とは\ruby{\texttt{;}}{セミコロン}で区切}%
 901
 902   \ltjruby{痛}{いたみ}（\ltjruby{病}{びやう}あ
 903 }
 904 \fbox{\box0}
 905
 906 \newpage
 907 \section{『日本語組版処理の要件』20120403の例}
 908
 909 \newcommand*{\噂}{\CID{7642}}
 910 \newcommand*{\倦}{\CID{7674}}
 911 %================================== 横組
 912 \paragraph{3.3.1節}\
 913 \begin{LTXexample}[pos=t]
 914 \obeylines
 915 3.49 \ruby{君|子}{くん|し}は\ruby{和}{わ}して\ruby{同}{どう}ぜず
 916 3.50 \ruby{人}{ひと}に\ruby{誨}{おし}えて\ruby{\倦}{う}まず
 917 % モノルビ．面倒でも複数回の実行が必要
 918 3.51 \ruby{鬼}{き}\ruby{門}{もん}の\ruby{方}{ほう}\ruby{角}{がく}を%
 919      \ruby{凝}{ぎよう}\ruby{視}{し}する
 920 % 熟語ルビ
 921 3.52 \ruby{鬼|門}{き|もん}の\ruby{方|角}{ほう|がく}を\ruby{凝|視}{ぎよう|し}する
 922 3.53 \ruby{茅場町}{かやばちよう}\quad\ruby{茅|場}{かや|ば}\ruby{町}{ちよう}
 923 % 熟字訓
 924 3.54 \ruby{紫陽花}{あじさい}\quad\ruby{坩堝}{るつぼ}\quad\ruby{田舎}{いなか}
 925 % グループルビ
 926 3.55 \ruby{模型}{モデル}\quad\ruby{顧客}{クライアント}\quad%
 927      \ruby{境界面}{インターフエース}\quad\ruby{避難所}{アジール}
 928 3.56 \ruby{編集者}{editor}\quad \ruby{editor}{エデイター}
 929 \end{LTXexample}
 930
 931 \paragraph{3.3.3節}\
 932 \begin{LTXexample}[pos=t]
 933 \obeylines
 934 3.58 に\ruby{幟}{のぼり}を\quad に\ruby[kata]{幟}{のぼり}を\quad%
 935      \ruby{韋}{い}\ruby{編}{へん}\ruby{三}{さん}\ruby{絶}{ぜつ}
 936 % 三分ルビ．JY3/mc/mc は本文書のプリアンブルで独自に定義
 937 3.59 に\ruby[fontcmd=\kanjifamily{mc}\kanjiseries{mc}]{幟}{のぼり}を
 938 % ルビ文字を小さくする
 939 3.60 {\Large%
 940   \ruby{韋}{い}\ruby{編}{へん}\ruby{三}{さん}\ruby{絶}{ぜつ}\quad% 比較用
 941   \ltjsetruby{size=0.375}% 0.5 -> 0.375
 942   \ruby{韋}{い}\ruby{編}{へん}\ruby{三}{さん}\ruby{絶}{ぜつ}}
 943 \end{LTXexample}
 944
 945 \paragraph{3.3.4節}
 946 3.61図（両側ルビ）は未サポートにより省略
 947
 948 \newpage
 949 \paragraph{3.3.5節 モノルビ}\
 950 \begin{LTXexample}[pos=t]
 951 \obeylines
 952 3.62 の\ruby{葯}{やく}に
 953 3.63 版面の\ruby{地}{ち}に\quad 版面の\ruby[kata]{地}{ち}に
 954 % 横組肩つきはしないが，現状では縦組未サポートだし，仕方ないね
 955 3.65 の\ruby{砦}{とりで}に
 956 {\ltjsetruby{kata}%
 957 3.66上 の\ruby{旬}{しゆん}に\quad 後\ruby{旬}{しゆん}に
 958 3.66下 の\ruby{旬}{しゆん}又\quad 後\ruby{旬}{しゆん}又}
 959 \end{LTXexample}
 960
 961
 962 \paragraph{3.3.6節 グループルビ}\
 963 \begin{LTXexample}[pos=t]
 964 \obeylines
 965 3.67 は\ruby{冊子体}{コーデツクス}と
 966 3.68 \ruby{模型}{モデル}\quad \ruby{利用許諾}{ライセンス}
 967 % 両端を揃える流儀
 968 3.69 {\ltjsetruby{stretchruby=010}%
 969      \ruby{模型}{モデル}\quad \ruby{利用許諾}{ライセンス}}
 970 % ルビが極端に短い場合
 971 3.70 \ruby{なげきの聖母像}{ピエタ}\quad% ルビ全角まで許容
 972      \ruby[maxmargin=0.75]{なげきの聖母像}{ピエタ}\\% ルビ全角1.5倍まで
 973 % ルビが長い場合
 974 3.71 \ruby{顧客}{クライアント}\quad \ruby{境界面}{インターフエース}
 975 3.72 {\ltjsetruby{stretch=010, stretchbol=010, stretcheol=010}% はみ出さない流儀
 976      \ruby{顧客}{クライアント}\quad \ruby{境界面}{インターフエース}}
 977 \end{LTXexample}
 978
 979 \newpage
 980 \paragraph{3.3.7節 熟語ルビ}\
 981 \begin{LTXexample}[pos=t]
 982 \obeylines
 983 3.73 \ruby{杞|憂}{き|ゆう}\quad \ruby{畏|怖}{い|ふ}\quad%
 984      \ruby[kata]{杞|憂}{き|ゆう}\quad \ruby[kata]{畏|怖}{い|ふ}
 985 3.74 の\ruby{流|儀}{りゆう|ぎ}を\quad   の\ruby{無|常}{む|じよう}を\quad%
 986      の\ruby{成|就}{じよう|じゆ}を\quad の\ruby{紋|章}{もん|しよう}を\quad%
 987      の\ruby{象|徴}{しよう|ちよう}を
 988 % 熟語の構成を考慮した方法は現行ではできない．
 989 % 行分割はできるのだが，「他の漢字にルビ全角までかかって良い」は難しい．
 990 3.75 {\ltjsetruby{kata}%
 991      の\ruby{流|儀}{りゆう|ぎ}を\quad   の\ruby{無|常}{む|じよう}を\quad%
 992      の\ruby{成|就}{じよう|じゆ}を\quad の\ruby{紋|章}{もん|しよう}を\quad%
 993      の\ruby{象|徴}{しよう|ちよう}を}
 994 % モノルビ配置．望ましくない
 995 3.76× の\ruby{流}{りゆう}\ruby{儀}{ぎ}を\quad の\ruby{無}{む}\ruby{常}{じよう}を\quad%
 996
 997 3.77  {\ltjsetruby{stretchbol=121, stretcheol=121}% 行頭・行末揃えず
 998      \hbox{\vrule\vbox{\hsize=10\zw\noindent\kern.75\zw
 999        あああああああの\ruby{流|儀}{りゆう|ぎ}がある．}\vrule}\quad%
1000      \hbox{\vrule\vbox{\hsize=5\zw ……等の\ruby{無|常}{む|じよう}を}\vrule}}
1001 \end{LTXexample}
1002
1003 \paragraph{3.3.8節 ルビはみ出し}\
1004 \begin{LTXexample}[pos=t]
1005 \obeylines
1006 3.78 \ruby{人}{ひと}は\ruby{死}{し}して\ruby{名}{な}を\ruby{残}{のこ}す
1007 3.79 漢字の部首には\ruby{偏}{へん}・\ruby{冠}{かんむり}・\ruby{脚}{きやく}・%
1008      \ruby{旁}{つくり}がある
1009 3.79 漢字の部首には\ruby{偏}{へん}，\ruby{冠}{かんむり}，\ruby{脚}{きやく}，%
1010      \ruby{旁}{つくり}がある
1011 \end{LTXexample}
1012 \begin{LTXexample}[pos=t]
1013 \obeylines
1014 3.79 この\ruby{\噂}{うわさ}の好きな人は\ruby{懐}{ふところ}ぐあいもよく、\ruby{檜}{ひのき}を
1015 3.80 漢字の部首には「\ruby{偏}{へん}」「\ruby{冠}{かんむり}」「\ruby{脚}{きやく}」%
1016 「\ruby{旁}{つくり}」がある
1017 3.80 この\ruby{\噂}{うわさ}好きな人は\ruby{懐}{ふところ}具合もよく、\ruby{檜}{ひのき}材を
1018 3.81× に\ruby{暁}{あかつき}の\kern-1\zw の\ruby{趣}{おもむき}を（良くない例）
1019 3.82 に\ruby{暁}{あかつき}の\ruby{趣}{おもむき}を
1020
1021 % 漢字・ひらがな・カタカナにルビを2分まで掛けても良い流儀
1022 {%
1023   \catcode`\<12%
1024   \makeatletter\count@="3040\loop\relax\ifnum \count@<"30FF%
1025   \ltjsetparameter{rubypreintrusion={\the\count@,0.5}, %
1026     rubypostintrusion={\the\count@,0.5}}%
1027   \advance\count@1 \repeat
1028   \ltjsetparameter{rubypostintrusion={`好,0.5}}
1029   \ltjsetparameter{rubypostintrusion={`具,0.5}}
1030   \ltjsetparameter{rubypostintrusion={`材,0.5}}
1031 3.83 この\ruby{\噂}{うわさ}の好きな人は\ruby{懐}{ふところ}ぐあいもよく、\ruby{檜}{ひのき}を
1032 3.83 この\ruby{\噂}{うわさ}好きな人は\ruby{懐}{ふところ}具合もよく、\ruby{檜}{ひのき}材を
1033 }
1034 % 平仮名にもルビを掛けない流儀
1035 {\catcode`\<12%
1036   \makeatletter\count@="3040\loop\relax\ifnum \count@<"30A0%
1037   \ltjsetparameter{rubypreintrusion={\the\count@,0}, %
1038     rubypostintrusion={\the\count@,0}}%
1039   \advance\count@1 \repeat
1040 3.84 この\ruby{\噂}{うわさ}の好きな人は\ruby{懐}{ふところ}ぐあいもよく、\ruby{檜}{ひのき}を
1041 3.84 この\ruby{\噂}{うわさ}好きな人は\ruby{懐}{ふところ}具合もよく、\ruby{檜}{ひのき}材を
1042 }
1043 \end{LTXexample}
1044 \begin{LTXexample}[pos=t]
1045 \obeylines
1046 3.85\ {\ltjsetruby{stretchbol=121, stretcheol=121}% 行頭・行末揃えず
1047 \hbox{\vrule\vbox{\hsize=15\zw
1048 　\hskip9.5\zw……の\ruby{徑}{こみち}を……%
1049 \hskip9\zw……の\ruby{徑}{こみち}を……}\vrule}}
1050 3.86\ \hbox{\vrule\vbox{\hsize=15\zw
1051 　\hskip10\zw……の\ruby{徑}{こみち}を……%
1052 \hskip9\zw……の\ruby{徑}{こみち}を……}\vrule}
1053 3.87\  \hbox{\vrule\vbox{\hsize=15\zw
1054 　\hskip8\zw……共\ruby{飾り}{アクセサリー}等……%
1055 \hskip9\zw……共\ruby{飾り}{アクセサリー}等……}\vrule}
1056 \end{LTXexample}
1057
1058
1059 \paragraph{圏点の例（常用漢字表前書きより）}
1060 この表は，法令，公⽤⽂書，新聞，雑誌，放送など，⼀般の社会⽣活におい%
1061 て\kenten[kenten=﹅]{現代の国語を書き表す}場合の\kenten{漢字使⽤の⽬安を⽰す}ものである。
1062
1063 \subparagraph{「﹅」の大きさを親文字の0.33倍にした例}
1064 この表は，法令，公⽤⽂書，新聞，雑誌，放送など，⼀般の社会⽣活におい%
1065 て\kenten[size=0.33, kenten=﹅]{現代の国語を書き表す}場合の\kenten{漢字使⽤の⽬安を⽰す}ものである。
1066 \end{document}