summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/platex/pxrubrica
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-04-27 21:35:21 +0000
committerKarl Berry <karl@freefriends.org>2017-04-27 21:35:21 +0000
commit6165f44cf87ca75b6071efd3b3d171f9f7cf9f5f (patch)
treec4ac588e1ab0dd9ba8d00923fae646389c415ea0 /Master/texmf-dist/doc/platex/pxrubrica
parent47a48398c30bb42ac7944d0f1481a436647d27b2 (diff)
pxrubrica (27apr17)
git-svn-id: svn://tug.org/texlive/trunk@44082 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/platex/pxrubrica')
-rw-r--r--Master/texmf-dist/doc/platex/pxrubrica/README-ja.md8
-rw-r--r--Master/texmf-dist/doc/platex/pxrubrica/README.md11
-rw-r--r--Master/texmf-dist/doc/platex/pxrubrica/pxrubrica-en.pdfbin52216 -> 52345 bytes
-rw-r--r--Master/texmf-dist/doc/platex/pxrubrica/pxrubrica-en.tex4
-rw-r--r--Master/texmf-dist/doc/platex/pxrubrica/pxrubrica.pdfbin371210 -> 440838 bytes
-rw-r--r--Master/texmf-dist/doc/platex/pxrubrica/sample/test-sample.pdfbin0 -> 299469 bytes
-rw-r--r--Master/texmf-dist/doc/platex/pxrubrica/sample/test-sample.tex136
7 files changed, 154 insertions, 5 deletions
diff --git a/Master/texmf-dist/doc/platex/pxrubrica/README-ja.md b/Master/texmf-dist/doc/platex/pxrubrica/README-ja.md
index fb4d4a9657c..249c2581590 100644
--- a/Master/texmf-dist/doc/platex/pxrubrica/README-ja.md
+++ b/Master/texmf-dist/doc/platex/pxrubrica/README-ja.md
@@ -7,13 +7,15 @@ JIS 規格「JIS X 4051」および W3C 技術ノート「[日本語組版処理
で述べられているような、日本において一般的な様式に従ってルビを付ける
機能を提供する。
+1.3 版より、圏点出力機能が追加された。
+
[日本語組版処理の要件]: <http://www.w3.org/TR/jlreq/ja/>
### 前提環境
* フォーマット: LaTeX
* エンジン: pTeX/upTeX/LuaTeX/XeTeX
- * DVI ウェア: pTeX 対応のもの
+ * DVI ウェア(DVI 出力時): pTeX 対応のもの
### 構成物
@@ -45,6 +47,10 @@ MITライセンスの下で配布される。
更新履歴
--------
+ * Version 1.3 〈2017/04/27〉
+ - 圏点出力機能(ルビ圏点同時付加を含む)。
+ - 和文ゴースト処理の改良。
+ - hyperref の PDF 文字列に対する対策。
* Version 1.2 〈2017/04/20〉
- 自動切換のモノルビ・熟語ルビ。
- 安全モード。
diff --git a/Master/texmf-dist/doc/platex/pxrubrica/README.md b/Master/texmf-dist/doc/platex/pxrubrica/README.md
index f013d0ee34a..f826a14bcd0 100644
--- a/Master/texmf-dist/doc/platex/pxrubrica/README.md
+++ b/Master/texmf-dist/doc/platex/pxrubrica/README.md
@@ -8,13 +8,16 @@ follows the style conventional in Japanese typography, as described in
the W3C technical note “Requirements for Japanese Text Layout” ([JLREQ])
and the JIS specification JIS X 4051.
+Starting with version 1.3, this package also provides function to add
+kenten (emphasis marks) to Japanese text.
+
[JLREQ]: <http://www.w3.org/TR/jlreq/>
### SYSTEM REQUIREMENTS
* TeX format: LaTeX.
- * TeX engine: pTeX and its derivatives.
- * DVI driver: Anything that supports pTeX DVI.
+ * TeX engine: pTeX, upTeX, LuaTeX, XeTeX.
+ * DVI driver (in DVI output): Anything that supports pTeX DVI.
### CONTENT
@@ -47,6 +50,10 @@ This package is distributed under the MIT License.
Revision History
----------------
+ * Version 1.3 〈2017/04/27〉
+ - Kenten function.
+ - Improve Japanese-text ghost insertion.
+ - Support the use in PDF strings.
* Version 1.2 〈2017/04/20〉
- Mono-ruby and jukugo-ruby with switching.
- Safe mode.
diff --git a/Master/texmf-dist/doc/platex/pxrubrica/pxrubrica-en.pdf b/Master/texmf-dist/doc/platex/pxrubrica/pxrubrica-en.pdf
index 5c126debab3..5508115bfd2 100644
--- a/Master/texmf-dist/doc/platex/pxrubrica/pxrubrica-en.pdf
+++ b/Master/texmf-dist/doc/platex/pxrubrica/pxrubrica-en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/platex/pxrubrica/pxrubrica-en.tex b/Master/texmf-dist/doc/platex/pxrubrica/pxrubrica-en.tex
index 53cb23a1686..3f4b244e1a5 100644
--- a/Master/texmf-dist/doc/platex/pxrubrica/pxrubrica-en.tex
+++ b/Master/texmf-dist/doc/platex/pxrubrica/pxrubrica-en.tex
@@ -8,8 +8,8 @@
\newcommand*{\Eg}{E.\,g.\mbox{}}
\newcommand*{\eg}{e.\,g.\mbox{}}
\newcommand*{\ie}{i.\,e.\mbox{}}
-\newcommand*{\myfileversion}{1.2}
-\newcommand*{\myfiledate}{2017/04/20}
+\newcommand*{\myfileversion}{1.3}
+\newcommand*{\myfiledate}{2017/04/27}
\newsavebox{\myexample}
\begin{document}
diff --git a/Master/texmf-dist/doc/platex/pxrubrica/pxrubrica.pdf b/Master/texmf-dist/doc/platex/pxrubrica/pxrubrica.pdf
index 10d6ea72fb1..ece8940db9b 100644
--- a/Master/texmf-dist/doc/platex/pxrubrica/pxrubrica.pdf
+++ b/Master/texmf-dist/doc/platex/pxrubrica/pxrubrica.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/platex/pxrubrica/sample/test-sample.pdf b/Master/texmf-dist/doc/platex/pxrubrica/sample/test-sample.pdf
new file mode 100644
index 00000000000..8c295a0915e
--- /dev/null
+++ b/Master/texmf-dist/doc/platex/pxrubrica/sample/test-sample.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/platex/pxrubrica/sample/test-sample.tex b/Master/texmf-dist/doc/platex/pxrubrica/sample/test-sample.tex
new file mode 100644
index 00000000000..667848d4c76
--- /dev/null
+++ b/Master/texmf-dist/doc/platex/pxrubrica/sample/test-sample.tex
@@ -0,0 +1,136 @@
+\documentclass[autodetect-engine,dvi=dvipdfmx,ja=standard,
+ a4paper]{bxjsarticle}
+\usepackage{setspace}
+\usepackage{pxrubrica}
+\newcommand*{\vb}{\symbol{`\|}}
+\newcommand*{\Opt}[1]{\texttt{#1}}
+\newcommand*{\PKN}[1]{\textsf{#1}}
+\newsavebox{\myexample}
+\rubysetup{f}
+\begin{document}
+
+\title{\PKN{pxrubrica}パッケージサンプル}
+\author{某ZR}
+\date{コンパイル日付: \today}
+\maketitle
+
+\section{サンプル}
+
+\subsection{基本的な用法}
+
+\begin{itemize}
+\item モノルビ(\Opt{m}オプション):各漢字に一つのルビブロック\\
+例:\quad
+\verb+\ruby[m]{鷹}{たか}+ → \ruby[m]{鷹}{たか}\quad
+\verb+\ruby[m]{鶯}{うぐいす}+ → \ruby[m]{鶯}{うぐいす}
+\item グループルビ(\Opt{m}オプション):漢字列全体に一つのルビブロック\\
+例:\quad
+\verb+\ruby[g]{雲雀}{ひばり}+ → \ruby[g]{雲雀}{ひばり}\quad
+\verb+\ruby[g]{不如帰}{ほととぎす}+ → \ruby[g]{不如帰}{ほととぎす}
+\item 熟語ルビ(\Opt{j}オプション):各漢字にルビを対応させるが熟語として読む\\
+例:\quad
+\verb+\ruby[j]{孔雀}{く|じゃく}+ → \ruby[j]{孔雀}{く|じゃく}\quad
+\verb+\ruby[j]{七面鳥}{しち|めん|ちょう}+ → \ruby[j]{七面鳥}{しち|めん|ちょう}
+\item ルビ文字列中の \verb+|+ は各漢字の読みの境界を示す。
+(孔=く、雀=じゃく)。
+グループルビでは不要である。
+\item 組版結果の比較:
+\begin{quote}\begin{tabular}{ll@{\ }l@{\ }c*3{@{\quad}c}}
+モノルビ & (\verb+\ruby[m]{小鳩}{こ|ばと}+) & →
+ & \ruby[m]{小鳩}{こ|ばと}
+ & \ruby[m]{鶺鴒}{せき|れい}
+ & \ruby[m]{雷鳥}{らい|ちょう}
+ & \ruby[m]{燕}{つばめ}
+\\
+グループルビ & (\verb+\ruby[g]{小鳩}{こばと}+) & →
+ & \ruby[g]{小鳩}{こばと}
+ & \ruby[g]{鶺鴒}{せきれい}
+ & \ruby[g]{雷鳥}{らいちょう}
+ & \ruby[g]{燕}{つばめ}
+\\
+熟語ルビ & (\verb+\ruby[j]{小鳩}{こ|ばと}+) & →
+ & \ruby[j]{小鳩}{こ|ばと}
+ & \ruby[j]{鶺鴒}{せき|れい}
+ & \ruby[j]{雷鳥}{らい|ちょう}
+ & \ruby[j]{燕}{つばめ}
+\end{tabular}\end{quote}
+熟語の各漢字とルビが対応する場合は、熟語ルビ(\Opt{j})を使い、
+そうでない(熟字訓の)場合はグループルビ(\Opt{g})を使うのが通例である。
+特に熟語の各漢字ごとの読みを明示したい場合は
+モノルビ(\Opt{m})を使うとよい。
+なお、漢字一文字に対するルビの場合は、
+\Opt{m}、\Opt{g}、\Opt{j}の何れも同じ結果になる。
+\item オプションの既定値を \verb+\rubysetup+ 命令で設定できる。
+例えば、\verb+\rubysetup{g}\ruby{軍鶏}{しゃも}+
+は \verb+\ruby[g]{軍鶏}{しゃも}+ と等価になる。
+“既定値の既定値”は\Opt{|cjPeF|}である。
+\end{itemize}
+
+\subsection{進入・突出}
+
+\begin{itemize}
+\item ルビの進入の制御:
+\begin{center}\begin{tabular}{ll@{\ }l@{\ }c*2{@{\quad}c}}
+進入無し & \verb+この\ruby[|-|]{鵲}{かささぎ}の+ & →
+ & この\ruby[|-|]{鵲}{かささぎ}の
+ & この\ruby[|-|]{鸛}{こうのとり}の
+ & この\ruby[|-|]{鵜}{う}の
+\\
+進入量小 & \verb+この\ruby[(-)]{鵲}{かささぎ}の+ & →
+ & この\ruby[(-)]{鵲}{かささぎ}の
+ & この\ruby[(-)]{鸛}{こうのとり}の
+ & この\ruby[(-)]{鵜}{う}の
+\\
+進入量大 & \verb+この\ruby[<->]{鵲}{かささぎ}の+ & →
+ & この\ruby[<->]{鵲}{かささぎ}の
+ & この\ruby[<->]{鸛}{こうのとり}の
+ & この\ruby[<->]{鵜}{う}の
+\end{tabular}\end{center}
+\item もし「ルビは仮名にはかけてよいが漢字はダメ」という場合は、
+“\verb+この\ruby[<-|]{鵲}{かささぎ}等+”
+と書くと「この\ruby[<-|]{鵲}{かささぎ}等」の出力が得られる。
+\item 基本モード(\Opt{m}/\Opt{g}/\Opt{j})と進入を同時に指定したい場合は、
+オプション文字列を \Opt{|g|} や \Opt{|m>} のようにする。
+ここで、“\Opt{-}”は「基本モードは既定値を用いる」ことを意味する。
+\item 突出の制御:
+オプション \Opt{||} で突出が抑止される。
+\begin{quote}
+\begin{lrbox}{\myexample}
+\small$\leftarrow$ \verb+\ruby[||->]{雀}{すずめ}+
+\end{lrbox}
+\fbox{\parbox{.42\linewidth}{%
+\ruby[||->]{雀}{すずめ}の…
+\quad \usebox{\myexample}%
+\rule{0pt}{12pt}\\
+インコの
+}}\quad vs.\quad
+\begin{lrbox}{\myexample}
+\small$\leftarrow$ \verb+\ruby[|->]{雀}{すずめ}+
+\end{lrbox}
+\fbox{\parbox{.42\linewidth}{%
+\ruby[|->]{雀}{すずめ}の…
+\quad \usebox{\myexample}%
+\rule{0pt}{12pt}\\
+インコの
+}}
+\end{quote}
+\end{itemize}
+
+\subsection{発展的な用法}
+
+\begin{itemize}
+\item \verb+\aruby+:欧文に対してルビを付ける:
+\par\noindent 例:\quad
+\verb+\aruby{Get out}{ゲラウッ}!+ →\
+ \aruby{Get out}{ゲラウッ}!
+\item \verb+\rubyfontsetup+:ルビ出力のためのフォントを指定する。
+例えば、ゴシック体の漢字列に対して明朝体のルビを振りたい場合は、
+次のようにする:
+\par\noindent
+{\small
+\verb+\rubyfontsetup{\mcfamily}この{\gtfamily \ruby[j]{明朝体}{みん|ちょう|たい}}+}
+→\
+{\rubyfontsetup{\mcfamily}この{\gtfamily \ruby[j]{明朝体}{みん|ちょう|たい}}}
+\end{itemize}
+
+\end{document}