summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/platex/pxjahyper/pxjahyper.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-02-22 22:20:48 +0000
committerKarl Berry <karl@freefriends.org>2021-02-22 22:20:48 +0000
commit1f8a99f91f89d808a685fb90434693017786a8a6 (patch)
treec0adb02e7b8fd39fc9335d04d8dcd020fb37b570 /Master/texmf-dist/doc/platex/pxjahyper/pxjahyper.tex
parent4220324e99226b427519e0380034f951f67a011f (diff)
parentd9e54ef03db8d244f5386fc89efffccb3d483a5e (diff)
sync with trunk 57841 to continue testing
git-svn-id: svn://tug.org/texlive/branches/branch2020@57848 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/platex/pxjahyper/pxjahyper.tex')
-rw-r--r--Master/texmf-dist/doc/platex/pxjahyper/pxjahyper.tex107
1 files changed, 92 insertions, 15 deletions
diff --git a/Master/texmf-dist/doc/platex/pxjahyper/pxjahyper.tex b/Master/texmf-dist/doc/platex/pxjahyper/pxjahyper.tex
index e4633e8da37..4c121b14385 100644
--- a/Master/texmf-dist/doc/platex/pxjahyper/pxjahyper.tex
+++ b/Master/texmf-dist/doc/platex/pxjahyper/pxjahyper.tex
@@ -1,18 +1,17 @@
% 文字コードは UTF-8
-% platex で組版する
-\documentclass[a4paper]{jsarticle}
+% uplatex で組版する
+\documentclass[uplatex,a4paper]{jsarticle}
+\renewcommand{\headfont}{\gtfamily\romanseries{sbc}\sffamily}
\usepackage{shortvrb}
\MakeShortVerb{\|}
-\newcommand{\PkgVersion}{0.4}
-\newcommand{\PkgDate}{2019/10/25}
+\usepackage{bxtexlogo}
+\bxtexlogoimport{*}
+\newcommand{\PkgVersion}{0.7}
+\newcommand{\PkgDate}{2021/02/13}
\newcommand{\Pkg}[1]{\textsf{#1}}
\newcommand{\Meta}[1]{$\langle$\mbox{}#1\mbox{}$\rangle$}
\newcommand{\Note}{\par\noindent ※}
-\newcommand{\Means}{~:\quad}
-\providecommand{\pTeX}{p\TeX}
-\providecommand{\upTeX}{u\pTeX}
-\providecommand{\pLaTeX}{p\LaTeX}
-\providecommand{\upLaTeX}{u\pLaTeX}
+\newcommand{\Means}{:\quad}
%-----------------------------------------------------------
\begin{document}
\title{\Pkg{pxjahyper} パッケージ}
@@ -69,8 +68,30 @@
使えるようにする。
具体的には、当該のAJ1のグリフに“対応”するUnicode文字が
あればそれを出力し、なければ(警告を出した上で)削除する。
-\item |nootfcid| \Means
+\item |nootfcid|\Means
|otfcid| の否定。
+ \Note |otfcid| の利用には、エンジンの{\eTeX}拡張および
+ \Pkg{etoolbox}と\Pkg{bxjatoucs}パッケージインストールが必要。
+\item |disablecmds|(既定)\Means
+ 「PDF文字列中のテキスト装飾命令の無効化」を有効にする。
+ \Note 詳細は\ref{ssec:disablecmds}節を参照。
+\item |nodisablecmds|\Means
+ |disablecmds| の否定。
+\item |otfmacros|(既定)\Means
+ \Pkg{japanese-otf}付属の\Pkg{ajmacros}パッケージが提供する
+ 文字入力命令(|\ajMaru|、|\ajLig| 等)をPDF文字列中で
+ “可能な限り”使えるようにする。
+ \Note Unicode文字で表現可能であればそれを出力し、
+ なければ代替表現を出力する。
+ \Note |otfmacros| を指定する場合は |otfcid| も有効にする必要がある。
+ \Note \Pkg{ajmacros}パッケージの多くの命令は“脆弱(fragile)”である。
+ そのため、節見出し(|\section| 等の引数)で |\ajMaru| 等の命令を
+ 使いたい場合は、命令の前に |\protect| 付ける必要がある。
+ \footnote{ちなみに、引数がPDF文字列として解釈される場合には、
+ |\protect| は全く結果に影響しない。}
+\item |nootfmacros|\Means
+ |otfmacros| の否定。
+ \Note 0.6版より既定を |otfmacros| に変更した。
\item |bigcode|(既定)\Means
{\upTeX}でのToUnicode CMapとして既定のUTF8-UCSの代わりに\
UTF8-UTF16を用いる。
@@ -80,12 +101,13 @@
\Note 0.3a版より既定を |bigcode| に変更した。
\item |dvipdfmx|\Means
dvipdfmxを前提とした動作を行う。
-\item |nodriver|/|none|\Means
+\item |nodvidriver|\Means
dvipdfmxを前提とした動作を抑止する。
- 現状では、この場合には本パッケージは実質的に何の動作も行わない。
+ \Note 現状では、この場合には本パッケージは実質的に何の動作も行わない。
+ \Note 0.5版より、|nodvidriver| の別名の |none| は非推奨の扱いとする。
\item |auto|(既定)\Means
\Pkg{hyperref}のドライバがdvipdfmx用ならば |dvipdfmx|、
- それ以外は |none| の動作。
+ それ以外は |nodvidriver| の動作。
\end{itemize}
%===========================================================
@@ -94,9 +116,20 @@
「概要」で述べた機能は(オプション設定に応じて)
自動的に実施される。
-\paragraph{Unicode符号値による入力}
+%-------------------
+\subsection{Unicode符号値による入力}
+
PDF文字列入力中で、|\Ux| が以下の意味になる。
PDF文字列以外では |\Ux| は以前の定義(または未定義)に戻る。
+\footnote{|\Ux| という命令名は\Pkg{bxbase}パッケージの
+Unicode符号値入力用の命令が使っているものである。
+従って、\Pkg{bxbase}パッケージを読み込んでいれば、
+「PDF文字列と版面出力の両方に使われる」ようなテキストにおいて、
+|\Ux| でUnicode符号値入力が可能になる。
+ただし、Unicode符号値入力用の命令としては
+「\Pkg{japanese-otf}パッケージの |\UTF| 命令」
+の方が有名であり、\Pkg{pxjahyper}は |\UTF| も正しく扱えるので、
+こちらを使う方が無難かもしれない。}
\begin{itemize}
\item |\Ux{|Unicode符号値|}|\Means
@@ -111,7 +144,9 @@ out2uni用の出力を行うように設計されているが、
|\UTF| も(PDF文字列中では)|\Ux| と同じ動作
(つまりtounicode用の出力)になるように変更される。
-\paragraph{PDF文字列用の文字命令の定義}
+%-------------------
+\subsection{PDF文字列用の文字命令の定義}
+
以下の命令が提供される。(プリアンブルでのみ使用可能。)
\begin{itemize}
@@ -140,4 +175,46 @@ PDF文字列中で |\textschwa|(schwa記号)や |\d{t}|(\d{t})が
\pxDeclarePdfTextComposite{\d}{t}{}{1E6D}
\end{verbatim}\end{quote}
+%-------------------
+\subsection{PDF文字列用中のテキスト装飾命令の無効化}
+\label{ssec:disablecmds}
+
+PDF文字列は単なるUnicode文字列として扱われるものなので、
+|\textit| や |\large| 等のテキスト装飾用の命令は意味をなさず、
+またそれらの命令の実装はPDF文字列の解釈中は正常に処理できない。
+PDF文字列と版面出力の両方に使われるテキスト(節見出し等)
+についてテキスト装飾命令が支障なく使えるように、
+\Pkg{hyperref}では基本的なテキスト装飾命令
+(多くは{\LaTeX}カーネルが提供するもの)
+について、「PDF文字列として扱う場合は自動的に無力化
+\footnote{例えば、“|\textit{text}|”や“|{\large text}|”は
+ 単に“|text|”と書いたものと見なされる。}
+する」機構を実装している。
+これにより、例えば節見出しのテキストに“|\textit{text}|”が
+含まれていたとすると、
+版面に出力する場合には“\textit{text}”のように装飾が施され、
+一方で、PDF文字列としては“|text|”と解釈されることになる。
+
+0.5版以降の\Pkg{pxjahyper}では、この無効化の対象に
+「和文用のテキスト装飾命令(およびそれに準じるもの)」
+を追加するようになった。
+以下の命令が対象になる。
+
+\begin{itemize}
+\item 和文のフォント選択命令\Means
+ |\textmc| |\gtfamily| |\kanjifamily| |\useroman| |\userelfont|
+ など
+\item 次の{\pLaTeX}カーネル命令\Means
+ |\<|
+\item 次の{\pTeX}プリミティブ\Means
+ |\inhibitglue| |\|(|no|)|autospacing| |\|(|no|)|autoxspacing|
+\item 次の\Pkg{plext}の命令\Means
+ |\bou| |\kasen| |\rensuji|
+\item 次の\Pkg{japanese-otf}の命令\Means
+ |\textmg| |\mgfamily| |\ltseries| |\ebseries| |\propshape|
+\end{itemize}
+
+
+
+
\end{document}