X-Git-Url: http://git.osdn.jp/view?a=blobdiff_plain;f=doc%2Fluatexja.dtx;h=ed343fefb84d78727519ec40731c93ff7280f25d;hb=ad5ab423c468a7b55785fc540c1b5e09766aed4f;hp=98ad53fbfd3da95d69d0f448c5375261814413aa;hpb=09fa919ae761b3ba95df5d55681fdf888c979432;p=luatex-ja%2Fluatexja.git
diff --git a/doc/luatexja.dtx b/doc/luatexja.dtx
index 98ad53f..ed343fe 100644
--- a/doc/luatexja.dtx
+++ b/doc/luatexja.dtx
@@ -47,7 +47,7 @@
%
\usepackage{amsmath,array,tikz,pict2e,multienum,float}
-\usepackage{booktabs,multicol}
+\usepackage{booktabs,multicol,luatexja-ruby}
%%%%%%%% listings
@@ -180,6 +180,7 @@
\catcode`\<=13
\def<#1>{{\normalfont\rm\itshape$\langle$#1\/$\rangle$}}
+\let\LARG=<
\maketitle
\tableofcontents
@@ -937,7 +938,7 @@ Okumura), namely, \Pkg{ltjclasses} and \Pkg{ltjsclasses}.
%\section{ãã©ã³ãã®å¤æ´}
\subsection{plain \TeX~and~\LaTeXe}
-\label{ssub-chgfnt}
+\label{ssec-chgfnt}
\paragraph{plain \TeX}
%<*en>
@@ -1011,7 +1012,7 @@ auto select&\verb+\fontencoding+&\verb+\fontfamily+&---&---&\verb+\usefont+\\
alphabetic fonts to \texttt{T1}.
\verb+\fontfamily+ also changes the current Japanese font family,
the current alphabetic font family, \emph{or both}.
- For the detail, see Subsection~\ref{ssub-nfsspat}.
+ For the detail, see Subsection~\ref{ssec-nfsspat}.
%
%<*ja>
ããã§ï¼\verb+\fontencoding{+\verb+}+ ã¯ï¼å¼æ°ã«ããåæå´ã欧æ
@@ -1020,7 +1021,7 @@ auto select&\verb+\fontencoding+&\verb+\fontfamily+&---&---&\verb+\usefont+\\
\texttt{JY3}ã«å¤æ´ãï¼\verb+\fontencoding{T1}+ ã¯æ¬§æãã©ã³ãå´ã
\texttt{T1}ã¸ã¨å¤æ´ããï¼\verb+\fontfamily+ ãå¼æ°ã«ããåæå´ï¼æ¬§æ
å´ï¼\emph{ãããã¯ä¸¡æ¹}ã®ãã©ã³ããã¡ããªãå¤æ´ããï¼è©³ç´°ã¯
- \ref{ssub-nfsspat}ç¯ãåç
§ãããã¨ï¼
+ \ref{ssec-nfsspat}ç¯ãåç
§ãããã¨ï¼
%
%<*en>
@@ -1043,7 +1044,7 @@ auto select&\verb+\fontencoding+&\verb+\fontfamily+&---&---&\verb+\usefont+\\
%<*ja>
ä»®åæ¸ä½ã使ãå ´åãªã©ï¼è¤æ°ã®åæãã©ã³ããçµã¿åããã¦ä½¿ãããå ´åã¯
\ref{ssec-altfont}ç¯ã® \verb+\ltjdeclarealtfont+ ã¨ï¼ãã®\LaTeX çã®\
-\verb+\DeclareAlternateKanjiFont+ï¼\ref{ssub-nfsspat}ç¯ï¼ãåç
§ããï¼
+\verb+\DeclareAlternateKanjiFont+ï¼\ref{ssec-nfsspat}ç¯ï¼ãåç
§ããï¼
%
\end{itemize}
@@ -1644,7 +1645,7 @@ If you want to use these functions, load \Pkg{luatexja-otf} package.
ããã3ãªãã·ã§ã³ã«ã¤ãã¦ã¯ï¼
\Pkg{luatexja-preset} ããã±ã¼ã¸ã«ããªã»ããã使ãæã«ä¸ç·ã«æå®ãããï¼
-ãããã¯å¯¾å¿ããå
容ã\ref{ssub-chgfnt}ç¯ï¼\ref{ssub-nfsspat}ç¯ (NFSS2) ã
+ãããã¯å¯¾å¿ããå
容ã\ref{ssec-chgfnt}ç¯ï¼\ref{ssec-nfsspat}ç¯ (NFSS2) ã
\ref{ssec-fontspec}ç¯ (\Pkg{fontspec}) ã®æ¹æ³ã§æåã§æå®ããå¿
è¦ãããï¼
%
@@ -2666,7 +2667,7 @@ because of the compatibility with previous versions of \LuaTeX-ja.
å³\ref{fig:kern-jfm}ãåç
§ï¼
\begin{itemize}
\item \emph{\texttt{\textbackslash jfont} ãï¼
-NFSS2ç¨ã®å½ä»¤ï¼\ref{ssub-chgfnt}ç¯ï¼\ref{ssub-nfsspat}ç¯ï¼ã«ãããæå®ã§ã¯
+NFSS2ç¨ã®å½ä»¤ï¼\ref{ssec-chgfnt}ç¯ï¼\ref{ssec-nfsspat}ç¯ï¼ã«ãããæå®ã§ã¯
ã«ã¼ãã³ã°æ
å ±ã¯æ¨æºã§ä½¿ç¨ãã}ãã¨ã«ãªã£ã¦ããããã§ããï¼
è¨ãæããã°ï¼ã«ã¼ãã³ã°æ
å ±ã使ç¨ããªãè¨å®ã«ããã«ã¯ï¼é¢åã§ã
\begin{verbatim}
@@ -4294,30 +4295,19 @@ are typeset by \verb+\piyo+.
%\subsection{Patch for NFSS2}
%\subsection{NFSS2ã¸ã®ããã}
-\label{ssub-nfsspat}
+\label{ssec-nfsspat}
\begin{figure}[!tb]
-\begin{lstlisting}[numberstyle=\tiny, numbers=left, numbersep=1em]
+\begin{LTXexample}[pos=b]
\DeclareKanjiFamily{JY3}{edm}{}
-\DeclareFontShape{JY3}{edm}{m}{n} {<-> s*KozMinPr6N-Regular:jfm=ujis;-kern}{}
-\DeclareFontShape{JY3}{edm}{m}{green}{<-> s*KozMinPr6N-Regular:jfm=ujis;-kern;color=007F00}{}
-\DeclareFontShape{JY3}{edm}{m}{blue} {<-> s*KozMinPr6N-Regular:jfm=ujis;-kern;color=0000FF}{}
+\DeclareFontShape{JY3}{edm}{m}{n} {<-> s*KozMinPr6N-Regular:jfm=ujis;}{}
+\DeclareFontShape{JY3}{edm}{m}{green}{<-> s*KozMinPr6N-Regular:jfm=ujis;color=007F00}{}
+\DeclareFontShape{JY3}{edm}{m}{blue} {<-> s*KozMinPr6N-Regular:jfm=ujis;color=0000FF}{}
\DeclareAlternateKanjiFont{JY3}{edm}{m}{n}{JY3}{edm}{m}{green}{"4E00-"67FF,{-2}-{-2}}
\DeclareAlternateKanjiFont{JY3}{edm}{m}{n}{JY3}{edm}{m}{blue}{ "6800-"9FFF}
{\kanjifamily{edm}\selectfont
æ¥æ¬å½æ°ã¯ãæ£å½ã«é¸æãããå½ä¼ã«ããã代表è
ãéãã¦è¡åããâ¦â¦}
-\end{lstlisting}
-\begin{quote}
-\DeclareKanjiFamily{JY3}{edm}{}
-\DeclareFontShape{JY3}{edm}{m}{n} {<-> s*KozMinPr6N-Regular:jfm=ujis;-kern}{}
-\DeclareFontShape{JY3}{edm}{m}{green}{<-> s*KozMinPr6N-Regular:jfm=ujis;-kern;color=007F00}{}
-\DeclareFontShape{JY3}{edm}{m}{blue} {<-> s*KozMinPr6N-Regular:jfm=ujis;-kern;color=0000FF}{}
-\DeclareAlternateKanjiFont{JY3}{edm}{m}{n}{JY3}{edm}{m}{green}{"4E00-"67FF,{-2}-{-2}}
-\DeclareAlternateKanjiFont{JY3}{edm}{m}{n}{JY3}{edm}{m}{blue}{ "6800-"9FFF}
-
-{\kanjifamily{edm}\selectfont
-æ¥æ¬å½æ°ã¯ãæ£å½ã«é¸æãããå½ä¼ã«ããã代表è
ãéãã¦è¡åããâ¦â¦}
-\end{quote}
+\end{LTXexample}
%\caption{\texttt{\textbackslash DeclareAlternateKanjiFont} ã®ä½¿ç¨ä¾}
%\caption{An example of \texttt{\textbackslash DeclareAlternateKanjiFont}}
\label{fig:altkanji}
@@ -4327,13 +4317,13 @@ are typeset by \verb+\piyo+.
Japanese patch for NFSS2 in \LuaTeX-ja
is based on \texttt{plfonts.dtx} which plays the same role in \pLaTeXe.
We will describe
-commands which are not described in Subsection~\ref{ssub-chgfnt}.
+commands which are not described in Subsection~\ref{ssec-chgfnt}.
%
%<*ja>
\LuaTeX-jaã®NFSS2ã¸ã®æ¥æ¬èªãããã¯
\pLaTeXe ã§åæ§ã®å½¹å²ãæãã \texttt{plfonts.dtx} ããã¼ã¹ã«ï¼
åæã¨ã³ã³ã¼ãã£ã³ã°ã®ç®¡ççãLuaã§æ¸ããªããããã®ã§ããï¼
-ããã§ã¯\ref{ssub-chgfnt}ç¯ã§è¿°ã¹ã¦ããªãã£ãå½ä»¤ã«ã¤ãã¦
+ããã§ã¯\ref{ssec-chgfnt}ç¯ã§è¿°ã¹ã¦ããªãã£ãå½ä»¤ã«ã¤ãã¦
è¨è¿°ãã¦ããï¼
%
@@ -4571,7 +4561,7 @@ In this case, the default family for font substitution is used for
\item[DeclareAlternateKanjiFont\{\}\{\}\{\}\{\}\\
\null\hfill\{\}\{\}\{\}\{\}\{\}]
%<*ja>
-\ref{ssec-altfont}ç¯ã®
+\ref{ssec-altfont}ç¯ã®\
\verb+\ltjdeclarealtfont+ ã¨åæ§ã«ï¼ååã®4å¼æ°ã®åæãã©ã³ãï¼åºåºãã©ã³ãï¼ã®ãã¡ä¸ã®æåã
第5--第8å¼æ°ã®åæãã©ã³ãã使ã£ã¦çµãããã«æ示ããï¼ä½¿ç¨ä¾ãå³\ref{fig:altkanji}ã«è¼ããï¼
@@ -4696,6 +4686,60 @@ will not be embedded in the output PDF file. See Subsection~\ref{ssec-psft}.
ãããæå®ãããã¨ã§ï¼PDFã«åãè¾¼ã¾ããªããååã ããã®ãã©ã³ããæå®ãããã¨ã
ã§ããï¼\ref{ssec-psft}ç¯ãåç
§ï¼
%
+
+
+\begin{figure}[!tb]
+\begin{LTXexample}[pos=b]
+\jfontspec[
+ AltFont={
+ {Range="4E00-"67FF, Color=007F00},
+ {Range="6800-"9EFF, Color=0000FF},
+ {Range="3040-"306F, Font=KozGoPr6N-Regular},
+ }
+]{KozMinPr6N-Regular}
+æ¥æ¬å½æ°ã¯ãæ£å½ã«é¸æãããå½ä¼ã«ããã代表è
ãéãã¦è¡åãããããã¨ãããã®åå«ã®ããã«ã
+諸å½æ°ã¨ã®ååã«ããææã¨ãããå½å
¨åã«ããã¤ã¦èªç±ã®ããããæµæ²¢ã確ä¿ããâ¦â¦
+\end{LTXexample}
+%\caption{\texttt{AltFont} ã®ä½¿ç¨ä¾}
+%\caption{An example of \texttt{AltFont}}
+\label{fig:altkanji-fontspec}
+\end{figure}
+
+\item[AltFont]\
+
+%<*en>
+As \verb+\ltjdeclarealtfont+~(Subsection~\ref{ssec-altfont}) and
+\verb+\DeclareAlternateKanjiFont+~(Subsection~\ref{ssec-nfsspat}),
+with this key, one can typeset some Japanese characters
+by a different font and/or using different features.
+The \texttt{AltFont} feature takes a comma-separated list of comma-separated lists,
+as the following:
+%
+%<*ja>
+\ref{ssec-altfont}ç¯ã® \verb+\ltjdeclarealtfont+ ãï¼
+\ref{ssec-nfsspat}ç¯ã® \verb+\DeclareAlternateKanjiFont+ ã¨åæ§ã«ï¼
+ãã®ãã¼ãç¨ããã¨ä¸é¨ã®æåãç°ãªã£ããã©ã³ããfont featureã使ã£ã¦çµããã¨ãã§ããï¼
+\texttt{AltFont} ã«æå®ããå¤ã¯ï¼æ¬¡ã®ããã«äºéã®ã³ã³ãåºåããªã¹ãã§ããï¼
+%
+\begin{lstlisting}[escapechar=\#]
+AltFont = {
+ ...
+ { Range=#\LARG range>#, #\LARG features>#},
+ { Range=#\LARG range>#, Font=#\LARG font~name>#, #\LARG features># },
+ { Range=#\LARG range>#, Font=#\LARG font~name># },
+ ...
+}
+\end{lstlisting}
+%<*en>
+Each sublist should have the \texttt{Range} key
+(sublist which does not contain \texttt{Range} key is simply ignored).
+A demonstrartion is shown in Figure~\ref{fig:altkanji-fontspec}.
+%
+%<*ja>
+åé¨åãªã¹ãã«ã¯ \texttt{Range} ãã¼ãå¿
é ã§ããï¼å«ã¾ããªãé¨åãªã¹ãã¯
+åç´ã«ç¡è¦ãããï¼ï¼
+æå®ä¾ã¯å³\ref{fig:altkanji-fontspec}ã«ç¤ºããï¼
+%
\end{list}
%<*ja>
@@ -4704,7 +4748,6 @@ will not be embedded in the output PDF file. See Subsection~\ref{ssec-psft}.
%
-
\subsection{\texttt{luatexja-otf.sty}}
\label{ssec-ltjotf}
%<*en>
@@ -4949,15 +4992,113 @@ for making the difference obvious.
\item[\textsf{adjust}\,=] \verb+\ltjsetparameter+ ã§æå®å¯è½ãªè¿½å ãã©ã¡ã¼ã¿ã§ããï¼
ã\textit{true}ãªã \verb+\ltjenableadjust+ ãï¼
ããã§ãªããã° \verb+\ltjdisableadjust+ ãå®è¡ããï¼
-
-
\end{list}
+%
+
+\subsection{\texttt{luatexja-ruby.sty}}
+%<*en>
+This addon package provides functionality of ``ruby'' (\emph{furigana}) annotations
+using callbacks of \LuaTeX-ja.
+There is no detailed manual of \Pkg{luatexja-ruby.sty} in English.
+(Japanese manual is another PDF file, \url{luatexja-ruby.pdf}.)
+%
+%<*ja>
+ãã®è¿½å ããã±ã¼ã¸ã¯ï¼\LuaTeX-jaã®æ©è½ãå©ç¨ããã«ãï¼æ¯ãä»®åï¼ã®çµçæ©è½ãæä¾ããï¼
+åå¾ã®æå種ã«å¿ããåå¾ã¸ã®èªåé²å
¥ãï¼
+è¡é å½¢ã»è¡ä¸å½¢ã»è¡æ«å½¢ã®èªåçãªä½¿ãåããç¹å¾´ã§ããï¼
+ã«ãçµçã«è¨å®å¯è½ãªé
ç®ã注æäºé
ãå¤ãããï¼æ¬è¿½å ããã±ã¼ã¸ã®è©³ç´°ãªèª¬æã¯
+使ç¨ä¾ã¨å
±ã« \url{luatexja-ruby.pdf}\ ã¨ããå¥ãã¡ã¤ã«ã«è¼ãã¦ããï¼
+ãã®ç¯ã§ã¯ç°¡åãªä½¿ç¨æ¹æ³ã®ã¿è¿°ã¹ãï¼
+%
+\begin{description}
+%<*en>
+ \item[Group-ruby]
+By default, ruby characters (the second argument of \verb+\ruby+)
+are attached to base characters (the first argument), as one object.
+This type of ruby is called \emph{group-ruby}.
+%
+%<*ja>
+ \item[ã°ã«ã¼ãã«ã] æ¨æºã§ã¯ã°ã«ã¼ãã«ãã®å½¢ã§çµã¾ããï¼ç¬¬1å¼æ°ã«è¦ªæåï¼
+第2å¼æ°ã«ã«ããè¨è¿°ããï¼
+%
+\begin{LTXexample}[width=0.3\textwidth]
+æ±è¥¿ç·\ruby{å¦å
¸}{ã¿ããã§ã}é§
ã¯â¦â¦\\
+æ±è¥¿ç·ã®\ruby{å¦å
¸}{ã¿ããã§ã}é§
ã¯â¦â¦\\
+æ±è¥¿ç·ã®\ruby{å¦å
¸}{ã¿ããã§ã}ã¨ããé§
â¦â¦\\
+æ±è¥¿ç·\ruby{è西}{ããã}é§
ã¯â¦â¦
+\end{LTXexample}
+%<*en>
+As the above example, ruby hangover is allowed on the Hiragana before/after
+its base characters.
+%
+% ãã®ä¾ã®ããã«ï¼æ¨æºã§ã¯åå¾ã®å¹³ä»®åã«ã«ãå
¨è§ã¾ã§ãããããã«ãªã£ã¦ããï¼
+%<*en>
+\item[Mono-ruby]
+To attach ruby characters to each base characters (\emph{mono-ruby}),
+one should use \verb+\ruby+ multiple times:
+%
+%<*ja>
+ \item[ã¢ãã«ã] 親æåã1æåã«ããã¨ã¢ãã«ãã¨ãªãï¼
+2æå以ä¸ã®çèªãã¢ãã«ãã®å½¢ã§çµã¿ããå ´åã¯ï¼é¢åã§ã
+ãã®æ°ã ã \verb+\ruby+ ãæ¸ãå¿
è¦ãããï¼
+%
+\begin{LTXexample}[width=0.3\textwidth]
+æ±è¥¿ç·ã®\ruby{å¦}{ã¿ãã}\ruby{å
¸}{ã§ã}é§
ã¯â¦â¦
+\end{LTXexample}
+%<*en>
+ \item[Jukugo-ruby]
+Vertical bar~\verb+|+ denotes a boundary of \emph{groups}.
+%
+%<*ja>
+ \item[çèªã«ã] å¼æ°å
ã®ç¸¦æ£ \verb+|+ ã¯ã°ã«ã¼ãã®åºåãã表ãï¼
+è¤æ°ã°ã«ã¼ãã®ã«ãã¯çèªã«ãã¨ãã¦çµã¾ããï¼
+\cite{x4051}ã«ããããã«ï¼
+ã©ã®ã°ã«ã¼ãã§ãã親æåãã対å¿ããã«ã以ä¸ã®é·ãã®å ´åã¯
+åã°ã«ã¼ããã¨ã«ï¼ããã§ãªãã¨ãã¯å
¨ä½ãã¾ã¨ãã¦1ã¤ã®ã°ã«ã¼ãã«ãã¨ãã¦çµã¾ããï¼
+\cite{jlreq}ã§è¦å®ããã¦ããçµã¿æ¹ã¨ã¯ç°ãªãã®ã§æ³¨æï¼
+%
+\begin{LTXexample}
+\ruby{å¦|å
¸}{ã¿ãã|ã§ã}\
+\ruby{è|西}{ã|ãã}\
+\ruby{ç¥æ¥½|å}{ããã|ãã}
+\end{LTXexample}
+%<*en>
+If there are multiple groups in one \verb+\ruby+ call,
+A linebreak between two groups is allowed.
+%
+% è¤æ°ã«ãã§ã¯ã°ã«ã¼ãã¨ã°ã«ã¼ãã®éã§æ¹è¡ãå¯è½ã§ããï¼
+\begin{LTXexample}[width=0.3\textwidth]
+\vbox{\hsize=6\zw\noindent
+ \hbox to 2.5\zw{}\ruby{京|æ¥|è²|ç°}{ãã|ããã|ãã¾|ã}
+ \hbox to 2.5\zw{}\ruby{京|æ¥|è²|ç°}{ãã|ããã|ãã¾|ã}
+ \hbox to 3\zw{}\ruby{京|æ¥|è²|ç°}{ãã|ããã|ãã¾|ã}
+}
+\end{LTXexample}
+\end{description}
+%<*en>
+If the width of ruby characters are longer than that of base characters,
+\verb+\ruby+ automatically selects the appropriate form
+among the line-head form, the line-middle form, and the line-end form.
+%
+%<*ja>
+ã¾ãï¼ã«ãæåã®ã»ãã親æåãããé·ãå ´åã¯ï¼èªåçã«
+è¡é å½¢ã»è¡ä¸å½¢ã»è¡æ«å½¢ã®ããããé©åãªãã®ãé¸æããï¼
%
+\begin{LTXexample}[width=0.3\textwidth]
+\vbox{\hsize=8\zw\noindent
+\null\kern3\zw â¦â¦ã\ruby{æ¿}{ãããã¾ã}ã
+ \kern1\zw â¦â¦ã\ruby{æ¿}{ãããã¾ã}ã\\
+\null\kern5\zw â¦â¦ã\ruby{æ¿}{ãããã¾ã}ã
+}
+\end{LTXexample}
+
+
+
@@ -6597,7 +6738,7 @@ Consider the following input:
ä¾ãã°æ¬¡ã®ãããªå
¥åãèãããï¼
%
\begin{verbatim*}
-\begin{lstlisting}[escapechar=`\#]
+\begin{lstlisting}[escapechar=\#]
#\ã»ã xã´ã#
\end{lstlisting}
\end{verbatim*}