OSDN Git Service

regenerated PDFs
[luatex-ja/luatexja.git] / doc / luatexja.dtx
index 5e3e1f5..7e6ccb9 100644 (file)
 \setmonofont[RawFeature=-notdef, Ligatures=CommonOff, %CharacterVariant={31,45,61,36},
 %<en>  Scale=0.8132073118633364, FakeStretch=1.183236,
 %<ja>  Scale=MatchLowercase, FakeStretch=1.137121,
-  Contextuals=AlternateOff,
-  ItalicFont=Iosevka Term Slab Oblique,
-  BoldFont=Iosevka Term Slab Bold, BoldItalicFont=Iosevka Term Slab Bold Oblique,
-]{Iosevka Term Slab}
+  Contextuals=AlternateOff, Kerning=Off,
+  Ligatures={CommonOff,RequiredOff,ContextualOff,RareOff,HistoricOff,TeXOff},
+  ItalicFont=Iosevka Slab Oblique,
+  BoldFont=Iosevka Slab Bold, BoldItalicFont=Iosevka Slab Bold Oblique,
+]{Iosevka Slab}
 \setsansfont[Scale=MatchLowercase,Ligatures=TeX,RawFeature=-notdef]{Linux Biolinum O}
 \usepackage[match]{luatexja-fontspec}
 \usepackage[haranoaji]{luatexja-preset}
 }
 
 \catcode`\<=13
-\def<#1>{{\normalfont\rm\itshape$\langle$#1\/$\rangle$}}
+\def<#1>{{\normalfont\rmfamily\itshape$\langle$#1\/$\rangle$}}
 \let\LARG=<
 \maketitle
 
@@ -652,17 +653,15 @@ and \emph{Japanese fonts} for fonts used in \textbf{JAchar}.
 %<ja>  (DVI出力(\cs{outputmode=0})は対応していない.)
 \item recent \href{https://github.com/latex3/luaotfload}{\Pkg{luaotfload}} (v3.1 or later recommended)
 \item \Pkg{adobemapping} (Adobe cmap and pdfmapping files)
-\item \LaTeX\ 2020-02-02 patch level 5 or later
+\item \LaTeXe\ 2020-02-02 patch level 5 or later
 %<en>  (if you want to use \LuaTeX-ja with \LaTeXe)
 %<ja>  (\LaTeXe 下で\LuaTeX-jaを使う場合)
-\item \href{https://github.com/josephwright/etoolbox/}{\Pkg{etoolbox}},
-  \Pkg{everysel}
+\item \href{https://github.com/josephwright/etoolbox/}{\Pkg{etoolbox}}
 %<en>  (if you want to use \LuaTeX-ja with \LaTeXe)
 %<ja>  (\LaTeXe 下で\LuaTeX-jaを使う場合)
+\item \Pkg{everysel} (only for \LaTeXe\ 2020-02-02~and~2020-10-01)
+\item \Pkg{filehook}, \Pkg{atbegshi}  (only for \LaTeXe\ 2020-02-02)
 \item \Pkg{ltxcmds}, \Pkg{pdftexcmds}
-\item \Pkg{filehook}, \Pkg{atbegshi}
-%<en>  (not needed if you want to use \LuaTeX-ja with \LaTeXe~2020-10-01 or later)
-%<ja>  (\LaTeXe 2020-10-01以降で\LuaTeX-jaを使う場合はどちらも不要)
 \item \href{https://github.com/wspr/fontspec/}{\Pkg{fontspec}} v2.7c (or later)
 %<*en>
 \item \emph{Harano Aji fonts} (\url{https://github.com/trueroad/HaranoAjiFonts})\\
@@ -3585,8 +3584,8 @@ JFMもサイズも同じなので,普通に「)\nobreak【」と入力した
 \label{fig:jfmfeat}
 \end{figure}
 
-%<en>\paragraph{Default horizontal JFMs}
-%<ja>\paragraph{æ¨\99æº\96ã\81®æ¨ªçµ\84ç\94¨JFM}
+%<en>\paragraph{Horizontal JFMs}
+%<ja>\paragraph{横組用JFM}
 \begin{table}[t]
 %<en>\caption{Differences between horizontal JFMs shipped with \LuaTeX-ja}
 %<ja>\caption{\LuaTeX-ja に同梱されている横組用JFMの違い}
@@ -3675,30 +3674,32 @@ JFMもサイズも同じなので,普通に「)\nobreak【」と入力した
 (\verb+min10.tfm+)に相当し,行末で文字が揃うようにするために「っ」など一部の文字幅が変わっ
           ている.\verb+min10.tfm+ については\cite{min10}が詳しい.
 %</ja>
-\end{description}
 %<*en>
-The difference among these three~JFMs is  shown in \autoref{tab-difjfm}.
+\item[\texttt{jfm-prop.lua}] A JFM for proportional typesetting.
+  This JFM doesn't have any information of character dimension (width, height, depth), nor glues/kerns information.
 %</en>
 %<*ja>
-これら3つのJFMの違いは\autoref{tab-difjfm}に示した.表中の文例の一部には,
-\cite{min10}の図3,~4のものを用いた
+\item[\texttt{jfm-prop.lua}] プロポーショナル組用のJFM.
+  文字幅・高さ・深さの情報も自動挿入されるグルー・カーンの情報は持たない(つまりグリフの文字幅をそのまま採用する)
 %</ja>
-
+%<*en>
+\item[\texttt{jfm-propw.lua}] Another JFM for proportional typesetting.
+  In contrast to \texttt{jfm-prop.lua}, this JFM has informations of character height and depth.
+%</en>
 %<*ja>
-また,プロポーショナル組用に\texttt{jfm-prop.lua}と\texttt{jfm-propw.lua}も用意されている.
-どちらのJFMも文字幅の情報と自動挿入されるグルー・カーンの情報は持たない(つまりグリフの文字幅をそのまま採用する).
-\texttt{jfm-prop.lua}と\texttt{jfm-propw.lua}の差は,前者が
-文字の高さ・深さ情報も持たないのに対し,後者は持っている点である
-\footnote{プロポーショナル組の状況でルビをつけたい,などという状況では\texttt{jfm-propw.lua}が有用かもしれない.}.
+\item[\texttt{jfm-propw.lua}] プロポーショナル組用のさらなるJFM.
+  \texttt{jfm-prop.lua}と異なり,高さ・深さの情報は持っている.
 %</ja>
+\end{description}
 %<*en>
-Furthermore, \LuaTeX-ja also ship two JFMs, namely \texttt{jfm-prop.lua}~and~\texttt{jfm-propw.lua},
-  for ``proportional typesetting''.
-Both JFMs don't have any character width information, nor glues/kerns information.
-\texttt{jfm-prop.lua} also also not have character height and depth information, while \texttt{jfm-propw.lua} has them.
+See \autoref{tab-difjfm} for the difference among \texttt{jfm-ujis.lua}, \texttt{jfm-jis.lua},
+\texttt{jfm-min.lua}.
 %</en>
-
-
+%<*ja>
+\texttt{jfm-ujis.lua}, \texttt{jfm-jis.lua},
+\texttt{jfm-min.lua}の違いは\autoref{tab-difjfm}に示した.表中の文例の一部には,
+\cite{min10}の図3,~4のものを用いた.
+%</ja>
 
 \begin{figure}
 \begin{LTXexample}[pos=t]
@@ -4073,7 +4074,7 @@ makes that IPA~Mincho and IPA~Gothic will be used as default Japanese fonts, ins
 Harano Aji fonts.
 %IPAex~Mincho and IPAex~Gothic.
 
-This feature is intended for classes which use special JFMs
+This feature is intended for classes which use special JFMs%
 \footnote{This is because commands has \texttt{@} in their names.}.
 It is recommended to use \cs{luatexja-preset}~or~\cs{luatexja-fontspec} package
 to select standard fonts in ordinary \LaTeX\ sources.
@@ -4810,13 +4811,13 @@ Hence we have the following result:
 
 「実際のグリフの幅に合わせて文字幅を整数倍する」際のしきい値を指定する.
 より正確に述べると,次のようになる.このフィールドに正の数$r$が指定されていたとし,
-文字クラス0で指定されている文字幅が$w$,文字クラス0に属する文字のグリフの幅が$w'$であったとする.
-$n=\nint(w/w')$とした
+JFM中で「文字クラス0の文字幅」と指定されている値が$w$,文字クラス0に属する文字のあるグリフの実際の幅が$w'$であったとする.
+$n=\nint(w'/w)$とした
 \footnote{ここで,$\nint(a)=\lfloor a+0.5\rfloor$は$a$に「もっとも近い整数」を表す.}
-とき,もし$w'>w$かつ$|w/w'-n|\char`<r$であれば,JFMで文字幅$nw$が指定されたものとして扱う.
+とき,もし$w'>w$かつ$\lvert w'/w-n\rvert \char`<r$であれば,JFMで文字幅$nw$が指定されたものとして扱う.
 
 この機能は,ほとんど源ノ明朝・源ノ角ゴシックにおける2倍角・3倍角ダッシュの合字のために実装されたと
-言ってもよい.これらのグリフは\LuaTeX 内部ではUnicodeの私用領域に割り当てられるので,
+è¨\80ã\81£ã\81¦ã\82\82ã\82\88ã\81\84ï¼\88ã\81\93ã\81®å ´å\90\88$w'=2$,~$3$ã\81§ã\81\82ã\82\8bï¼\89ï¼\8eã\81\93ã\82\8cã\82\89ã\81®ã\82°ã\83ªã\83\95ã\81¯\LuaTeX å\86\85é\83¨ã\81§ã\81¯Unicodeã\81®ç§\81ç\94¨é \98å\9f\9fã\81«å\89²ã\82\8aå½\93ã\81¦ã\82\89ã\82\8cã\82\8bã\81®ã\81§ï¼\8c
 JFM側で番号を指定することができない.
 %</ja>
 %<*en>
@@ -5667,7 +5668,7 @@ The default value is \texttt{paverage}. \dots
 \item[\DParam{jacharrange}\,=<ranges>]
 \item[\DParam{kansujichar}\,=\{<digit>, <chr\_code>\}$^\ast$] [\cs{kansujichar}]
 
-\item[\DParam{direction}\,=<dir>\ \hbox{\rm (always local)}]\
+\item[\DParam{direction}\,=<dir>\ \hbox{\normalfont\rmfamily (always local)}]\
 
 %<*en>
 Assigning to this parameter has the same effect as
@@ -6161,7 +6162,7 @@ With the help of this example, we remark the specification of \cs{inhibitglue}:
 In other words, \cs{disinhibitglue} allows the insertion of a glue/kern specified by JFM.
 If \cs{inhibitglue}~and~\cs{disinhibitglue} both specified at the same time,
 the latest one is effective.
-This commans is added in the version 2020****.0.
+This commans is added in the version 20201224.0.
 
 Note that \cs{disinhibitglue} also cancels ligatures and kernings.
 %</en>
@@ -6169,7 +6170,7 @@ Note that \cs{disinhibitglue} also cancels ligatures and kernings.
 \cs{disinhibitglue}は\cs{inhibitglue}の効果を無効化する.
 言い換えれば,(\cs{inhibitglue}で抑制されたはずの))JFM由来グルー/カーンの挿入を許可する.
 同じ箇所に\cs{inhibitglue}と\cs{disinhibitglue}が両方ある場合は,後ろの指定が有効になる.
-この命令はバージョン2020****.0で追加された.
+この命令はバージョン20201224.0で追加された.
 
 なお,\cs{disinhibitglue}もリガチャやカーニングを打ち消すことに注意されたい.これは
 (\cs{inhibitglue}と同様に)whatsitノードを使って実装されていることによる.
@@ -6237,9 +6238,9 @@ As an example, the example above can be improved as follows:
 \subsection{\cs{insertxkanjiskip}, \cs{insertkanjiskip}}
 %<*en>
 There are some situations which one wants to insert \Param{xkanjiskip} manually.
-A simple approach is to use \cs{hskip}\cs{ltjgetparamter\{xkanjiskip\}}, but this approach has
+A simple approach is to use \cs{hskip}\cs{ltjgetparameter\{xkanjiskip\}}, but this approach has
 several weak points. To cope with these weak points, \LuaTeX-ja defines a command \cs{insertxkanjiskip} which
-inserts \Param{xkanjiskip} glue manually, from the version 2020****.0.
+inserts \Param{xkanjiskip} glue manually, from the version 20201224.0.
 \begin{itemize}
   \item ``\cs{insertxkanjiskip}'' (without any keyword) uses the value of \Param{xkanjiskip} at the place.
   \item ``\cs{insertxkanjiskip late}'' (with ``\texttt{late}''~keyword) uses the value of \Param{xkanjiskip}
@@ -6250,21 +6251,21 @@ See the example below.
 %<*ja>
 \TeX で日本語の文章を作成していると,
 しばしば「手動で和欧文間空白\Param{xkanjiskip}を挿入したい」という状況に遭遇する.
-このような場合,\cs{hskip}\cs{ltjgetparamter\{xkanjiskip\}}\+とするのがよくある対応であったが,これらには
+このような場合,\cs{hskip}\cs{ltjgetparameter\{xkanjiskip\}}\+とするのがよくある対応であったが,これらには
 次のような難点がある:
 \begin{itemize}
   \item \cs{xkanjiskip}は「段落やhboxでの終端での値がその段落/hbox全体で用いられる」となっているため,
-  \cs{hskip}\cs{ltjgetparamter\{xkanjiskip\}}\+以降に\Param{xkanjiskip}の値が変わる場合に対応できない.
+  \cs{hskip}\cs{ltjgetparameter\{xkanjiskip\}}\+以降に\Param{xkanjiskip}の値が変わる場合に対応できない.
   \item \LuaTeX-jaでは,\cs{xkanjiskip}の自然長が$\cs{maxdimen}=(2^{30}-1)\,\mbox{sp}$であった場合,
   JFMで指定された値を実際に利用することになっているが,それに対応できていない.
   \item \Pkg{luatexja-adjust}(\ref{ssec:adj}節)による優先度行長調整では,
-  \cs{hskip}\cs{ltjgetparamter\{xkanjiskip\}}\+は手動で挿入したグルーであるから,
+  \cs{hskip}\cs{ltjgetparameter\{xkanjiskip\}}\+は手動で挿入したグルーであるから,
   自動で挿入された\Param{xkanjiskip}とは
   伸縮の優先順序が異なってしまう.
 \end{itemize}
 
 これらの難点に対処した,\Param{xkanjiskip}をグルーとして手動挿入する命令が\cs{insertxkanjiskip}である.
-これはバージョン2020****.0で追加された.
+これはバージョン20201224.0で追加された.
 以下の実行例に示すように,
 \begin{itemize}
   \item 単独で\cs{insertxkanjiskip}とした場合は,その時点での\Param{xkanjiskip}の値を使用する
@@ -10458,7 +10459,7 @@ If this attempt fails, \LuaTeX-ja use the method ``\textsf{\Param{kanjiskip}~[K]
 \item \textit{Np}の中身の文字コードについて,「直前への\Param{xkanjiskip}の挿入」が禁止されている
 (つまり,\Param{jaxspmode}~(or \Param{alxspmode})パラメータが偶数).
 \end{itemize}
-\item ユーザ側から見た\Param{xkanjiskip}パラメータの自然長が$\cs{maxdimen}=(2^{30}-1)\,{\rm sp}$で
+\item ユーザ側から見た\Param{xkanjiskip}パラメータの自然長が$\cs{maxdimen}=(2^{30}-1)\,\textrm{sp}$で
 なければ,\Param{xkanjiskip}パラメータの値を持つglueを採用する.
 \item 2.でない場合は,\textit{Nq}, \textit{Np}(\textsf{和文A}/\textsf{和文B}なのは片方だけ)
 で使われているJFMに指定されている\Param{xkanjiskip}の値を用いる.