From 75514ad93d6ce5ed759579702f8059c7a48c1d86 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 17 Aug 2018 22:07:02 +0000 Subject: pxrubrica (17aug18) git-svn-id: svn://tug.org/texlive/trunk@48421 c570f23f-e606-0410-a88d-b1316a301751 --- .../source/platex/pxrubrica/pxrubrica.dtx | 107 +++++++++++++++------ 1 file changed, 77 insertions(+), 30 deletions(-) (limited to 'Master/texmf-dist/source/platex') diff --git a/Master/texmf-dist/source/platex/pxrubrica/pxrubrica.dtx b/Master/texmf-dist/source/platex/pxrubrica/pxrubrica.dtx index b000b547ac2..354a64cab3b 100644 --- a/Master/texmf-dist/source/platex/pxrubrica/pxrubrica.dtx +++ b/Master/texmf-dist/source/platex/pxrubrica/pxrubrica.dtx @@ -3,7 +3,7 @@ % % This is file 'pxrubrica.dtx'. % -% Copyright (c) 2017 Takayuki YATO (aka. "ZR") +% Copyright (c) 2018 Takayuki YATO (aka. "ZR") % GitHub: https://github.com/zr-tex8r % Twitter: @zr_tex8r % @@ -20,7 +20,7 @@ %<*driver> \ProvidesFile{pxrubrica.dtx} % - [2017/11/19 v1.3b PX Japanese-style ruby] + [2018/08/16 v1.3c PX Japanese-style ruby] %<*driver> \documentclass[uplatex]{jsarticle} \usepackage{doc} @@ -63,6 +63,12 @@ % \date{\fileversion \quad[\filedate]} % \maketitle % +% \begin{abstract} +% JIS規格「JIS X~4051」およびW3C技術ノート「日本語組版処理の要件」 +% で述べられているような、 +% 日本において一般的な様式に従ってルビおよび圏点を付ける機能を提供する。 +% \end{abstract} +% % \MakeShortVerb{\|} % % \setcounter{tocdepth}{3} @@ -84,21 +90,26 @@ % % 本パッケージで独自の意味をもつ単語を挙げる。 % \begin{itemize} -% \item 突出: ルビ文字出力の端が親文字よりも外側になること。 -% \item 進入: ルビ文字出力が親文字に隣接する文字の(水平)領域に -% 配置されること。 +% \item 突出: ルビ文字出力の端が親文字よりも外側に出ること。 +% \item 進入: ルビ文字出力が親文字に隣接する文字の領域 +% (水平方向に見た場合)に配置されること。 % \item 和文ルビ: 親文字が和文文字であることを想定して処理されるルビ。 % \item 欧文ルビ: 親文字が欧文文字であることを想定して処理されるルビ。 % \item グループ: ユーザにより指定された、親文字列・ルビ文字列の処理単位。 +% \item クラスタ: 入力文字列中の |{ }| で囲った部分のこと。 +% \footnote{本来の{\LaTeX}の用語では「グループ」と呼ぶが、ここでは +% 「グループ」が別の意味をもつので別の用語を当てた。} % \item 《文字》: 均等割りにおいて不可分となる単位のこと。 -% 通常は、本来の意味での文字となるが、ユーザ指定で変更できる。 +% 本来の意味での文字の他、クラスタも《文字》と扱われる。 % \item ブロック: 複数の親文字・ルビ文字の集まりで、大域的な配置決定の % 処理の中で内部の相対位置が固定されているもの。 % \end{itemize} % -% 次の用語については、『日本語組版の要件』に従う。 +% 次の用語については、『日本語組版の要件』% +% \footnote{|http://www.w3.org/TR/jlreq/ja/|}% +% に従う。 % \begin{quote} -% ルビ、親文字、中付き、肩付き、モノルビ、グループルビ、熟語ルビ +% ルビ、親文字、中付き、肩付き、モノルビ、グループルビ、熟語ルビ、圏点 % \end{quote} % % \subsection{ルビ用命令} @@ -137,7 +148,7 @@ % \end{tabular} % \end{quote} % -% \jmeta{前補助設定}は以下の値の何れか。 +% \jmeta{前補助設定}は以下の値の何れか(複数指定可)。 % \begin{quote} % \begin{tabular}[t]{ll} % \texttt{:} & 和欧文間空白挿入 \\ @@ -158,7 +169,7 @@ % \item ゴースト処理が有効の場合はここの設定は無視される。 % \end{itemize} % -% \jmeta{モード}は以下の値の何れか。 +% \jmeta{モード}は以下の値の何れか(複数指定可)。 % \begin{quote} % \newcommand*\fro[1]{{\scriptsize($<$\,\textit{#1})}} % \begin{tabular}[t]{l@{ }ll} @@ -204,7 +215,7 @@ % 複数ある場合は |m| および |j| と等価になる。 % \end{itemize} % -% \jmeta{後補助設定}は以下の値の何れか。 +% \jmeta{後補助設定}は以下の値の何れか(複数指定可)。 % \begin{quote} % \begin{tabular}[t]{ll} % \texttt{:} & 和欧文間空白挿入 \\ @@ -248,7 +259,7 @@ % 未定義である場合にのみ定義される。 % これに対して |\jruby| は常に定義される。 % なお、|\ruby| 以外の命令(|\jruby| を含む)が定義済であった -% (命令名の衝突)場合にはエラーとなる。 +% (命令名が衝突した)場合にはエラーとなる。 % % \item |\aruby[|\jmeta{オプション}|]{|\jmeta{親文字}^^A % |}{|\jmeta{ルビ文字}|}| @@ -299,15 +310,57 @@ % % \end{itemize} % -% \subsection{入力文字列のグループの指定} +% \subsection{ルビ命令の入力文字列の入力規則} +% +% ルビの処理では入力文字列(親文字列・ルビ文字列)を +% 文字毎に分解する必要がある。 +% このため、ルビ命令の入力文字列は一定の規則に従って +% 書かれる必要がある。 +% +% ルビ命令の入力文字列には以下のものを含めることができる。 +% +% \begin{itemize} +% \item \texttt{\vb}\Means グループの区切りを表す。 +% \begin{itemize} +% \item 現在の版では、親文字列でグループ区切りを利用する機能はない。 +% \footnote{将来の機能拡張において、親文字列が複数グループをもつような +% 使用法が想定されている。}% +% 従って、親文字列中に \texttt{\vb} があると常にエラーになる。 +% \item ルビ文字列中では、一つのグループが一つの親文字に対応する +% 範囲を表す(モノルビ・熟語ルビの場合)。 +% \end{itemize} +% +% \item 通常文字\Means {\LaTeX}の命令や特殊文字や欧文空白 +% や \texttt{\vb} でない、欧文または和文の文字を指す。 +% これは一つの《文字》と見なされる。 +% \begin{itemize} +% \item 和文ルビ命令の親文字列に欧文文字を含めた場合、 +% その文字は組版上“和文文字のように”振舞う。 +% \end{itemize} +% +% \item クラスタ\Means すなわち、|{ }| に囲まれたテキスト。 +% 全体が一つの《文字》と見なされる。 +% \begin{itemize} +% \item クラスタの中では任意の{\LaTeX}の“インライン\mbox{”}% +% \footnote{「強制改行や改段落を含まない」ということ。 +% {\LaTeX}の用語では「LRモード」と呼ぶ。}% +% の命令が使える。 +%\begin{quote}\begin{verbatim} +%\ruby[j]{{\CID{7652}}飾区}{かつ|し{\color{red}{か}}|く} +%\end{verbatim}\end{quote} +% \item クラスタ中の \texttt{\vb} は通常文字として扱われる。 +% \end{itemize} +% +% \Note 例外的に、欧文ルビの親文字列は、あたかもそれ全体が +% 一つのクラスタであるように振舞う。 +% つまり、任意の“インライン”の命令が使えて、 +% 全体で一つの欧文文字であるのと同様に振舞う。 % -% 入力文字列(親文字列 -% \footnote{後述の通り、現在の版では親文字列を複数グループにする -% 使用法は存在しないため、親文字列中では「\texttt{\vb}」は使われない。}% -% ・ルビ文字列)の中で「\texttt{\vb}」は -% グループの区切りとみなされる(ただし |{ }| の中にあるものは -% 文字とみなされる)。 +% \end{itemize} % +% \subsection{ルビ文字列のグループの指定} +% +% ルビ文字列の \texttt{\vb} はグループの区切りを表す。 % 例えば、ルビ文字列 %\begin{quote}\begin{verbatim} %じゆく|ご @@ -316,8 +369,7 @@ % 1文字からなる。 % % 長さを合わせるために均等割りを行う場合、その分割の単位は -% 通常は文字であるが、|{ }| で囲ったものは1文字とみなされる -% (本文書ではこの単位のことを《文字》と記す)。 +% 《文字》(通常文字またはクラスタ)となる。 % 例えば %\begin{quote}\begin{verbatim} %ベクタ{\<(ー)\<} @@ -325,8 +377,6 @@ % は1つのグループからなり、それは4つの《文字》からなる。 % % グループや《文字》の指定はルビの付き方に影響する。 -% その詳細を説明する。 -% なお、非拡張機能では親文字のグループは常に1つに限られる。 % \begin{itemize} % \item モノルビ・熟語ルビでは親文字列の1つの《文字》にルビ文字列の % 1つのグループが対応する。 @@ -343,9 +393,6 @@ %\end{verbatim}\end{quote} % は、「五月雨+さみだれ」の1つのブロックからなる。 % \end{itemize} -% -% 拡張機能では、親文字列が複数グループをもつような使用法が -% 存在する予定である。 % % \subsection{ゴースト処理} % @@ -561,7 +608,7 @@ % % \end{itemize} % -% \subsection{圏点命令の親文字列} +% \subsection{圏点命令の親文字列の入力規則} % % 圏点付加の処理では親文字列を文字毎に分解する必要がある。 % このため、圏点命令の親文字列は一定の規則に従って @@ -591,8 +638,8 @@ % (\verb|\hspace{\kanjiskip}|)を出力する専用のマクロを用意して % おくと便利かもしれない。} % \end{itemize} -% \item グループ\Means すなわち、|{ }| に囲まれた任意のテキスト。 -% ルビ命令のグループと同様に、一つの《文字》として扱われ、 +% \item クラスタ\Means すなわち、|{ }| に囲まれた任意のテキスト。 +% ルビ命令のクラスタと同様に、一つの《文字》として扱われ、 % 全体に対して一つの圏点が付加される。 % \begin{itemize} % \item \PKN{japanese-otf}パッケージの |\CID| 命令のような、 @@ -1013,7 +1060,7 @@ % \begin{macrocode} \def\pxrr@fatal@bad@movable{% \pxrr@fatal@error{% - Novable group ruby is not allowed here% + Movable group ruby is not allowed here% }\pxrr@eh@fatal } % \end{macrocode} -- cgit v1.2.3