OSDN Git Service

Japanese version of the manual (Section 5 and 6).
authorKazuki Maeda <kmaeda@users.sourceforge.jp>
Sun, 8 Apr 2012 15:08:42 +0000 (00:08 +0900)
committerKazuki Maeda <kmaeda@users.sourceforge.jp>
Sun, 8 Apr 2012 15:08:42 +0000 (00:08 +0900)
 * Section 5 is incomplete (both English and Japanese).

doc/man-ja.pdf
doc/manual.dtx

index 0188c74..7351fe2 100644 (file)
Binary files a/doc/man-ja.pdf and b/doc/man-ja.pdf differ
index 39ad3db..2d462b4 100644 (file)
@@ -2562,13 +2562,24 @@ Then, the position of glyphs is shifted up by
 %<ja>\section{パラメータ}
 %<en>\subsection{\texttt{\char92 ltjsetparameter} primitive}
 %<ja>\subsection{\texttt{\char92 ltjsetparameter} プリミティブ}
+
+%<*en>
 As noted before, \verb+\ltjsetparameter+ and \verb+\ltjgetparameter+ are
 primitives for accessing most parameters of \LuaTeX-ja. One of the main
 reason that \LuaTeX-ja didn't adopted the syntax similar to that of \pTeX\
 (\textit{e.g.},~\verb+\prebreakpenalty`)=10000+)
 is the position of \verb+hpack_filter+ callback in the source
 of \LuaTeX, see Section~\ref{sec-para}.
+%</en>
+%<*ja>
+先に述べたように,\verb+\ltjsetparameter+ と \verb+\ltjgetparameter+ は
+\LuaTeX-ja のほとんどのパラメータにアクセスするためのプリミティブである.
+\LuaTeX-ja が \pTeX のような文法(例えば,\verb+\prebreakpenalty`)=10000+)を
+採用しない理由の一つは,\LuaTeX のソースにおける \verb+\hpack_filter+
+コールバックの位置にある.\ref{sec-para} 節を見よ.
+%</ja>
 
+%<*en>
 \verb+\ltjsetparameter+ and \verb+\ltjglobalsetparameter+ are primitives
 for assigning parameters. These take one argument which is a
 \texttt{<key>=<value>} list. Allowed keys are described in the next
@@ -2580,46 +2591,107 @@ scope of assignment;
 \verb+\ltjglobalsetparameter+ does a global one.
 They also obey the value of \verb+\globaldefs+,
 like other assignment.
+%</en>
+%<*ja>
+\verb+\ltjsetparameter+ と \verb+\ltjglobalsetparameter+ はパラメータを
+指定するためのプリミティブである.これらは \texttt{<key>=<value>} のリストを
+引数としてとる.許されるキーは次の節に記述する.
+\verb+\ltjsetparameter+ と \verb+\ltjglobalsetparameter+ の違いはスコープの
+違いのみである.
+\verb+\ltjsetparameter+ はローカルな指定,\verb+\ltjglobalsetparameter+ は
+グローバルな指定を行う.
+これらは他のパラメータ指定と同様に \verb+\globaldefs+ の値に従う.
+%</ja>
 
+%<*en>
 \verb+\ltjgetparameter+ is the primitive for acquiring parameters. It
 always takes a parameter name as first argument, and also takes the
 additional argument---a character code, for example---in some cases.
+%</en>
+%<*ja>
+\verb+\ltjgetparameter+ はパラメータの値を取得するためのプリミティブであり,
+常にパラメータの名前を第一引数にとる.
+そして,いくつかの場合には加えてさらに引数(例えば文字コード)をとる.
+%</ja>
 \begin{LTXexample}
 \ltjgetparameter{differentjfm},
 \ltjgetparameter{autospacing},
 \ltjgetparameter{prebreakpenalty}{`)}.
 \end{LTXexample}
+%<*en>
 \emph{The return value of\/ {\normalfont\tt\char92ltjgetparameter} is
 always a string}. This is outputted by \texttt{tex.write()}, so any
 character other than space~`\texttt{\char32}'~(U+0020) has the category code
 12~(other), while the space has 10~(space).
+%</en>
+%<*ja>
+\textbf{{\normalfont\tt\char92ltjgetparameter} の戻り値は常に文字列である.}
+これは \texttt{tex.write()} によって出力しているためで,スペース `\texttt{\char32}'~(U+0020) を除いた文字のカテゴリーコードは全て 12~(other) となる.
+一方,スペースのカテゴリーコードは 10~(space) である.
+%</ja>
 
 %<en>\subsection{List of Parameters}
 %<ja>\subsection{パラメータ一覧}
+
+%<*en>
 The following is the list of parameters which can be specified by the
 \verb+\ltjsetparameter+ command. [\verb+\cs+] indicates the counterpart
 in \pTeX, and symbols beside each parameter has the following meaning:
+%</en>
+%<*ja>
+以下は \verb+\ltjsetparameter+ に指定することができるパラメータの一覧である.
+[\verb+\cs+] は \pTeX における対応物を示す.
+また,それぞれのパラメータの右上にある記号には次の意味がある:
+%</ja>
 \begin{itemize}
+%<*en>
 \item No mark: values at the end of the paragraph or the hbox are
       adopted in the whole paragraph/hbox.
+%</en>
+%<*ja>
+\item 記号なし:段落や hbox の終端での値がその段落/hbox 全体で用いられる.
+%</ja>
+%<*en>
 \item `\ast' : local parameters, which can change everywhere inside a paragraph/hbox.
+%</en>
+%<*ja>
+\item `\ast':ローカルなパラメータであり,段落/hbox 内のどこででも値を変えることができる.
+%</ja>
+%<*en>
 \item `\dagger': assignments are always global.
+%</en>
+%<*ja>
+\item `\dagger':指定は常にグローバルになる.
+%</ja>
 \end{itemize}
 
 \begin{list}{}{\def\makelabel{\ttfamily}\def\{{\char`\{}\def\}{\char`\}}\advance\leftmargin1\zw}
 \item[\Param{jcharwidowpenalty}\,=<penalty>] [\verb+\jcharwidowpenalty+]
 
+%<*en>
 Penalty value for suppressing orphans. This penalty is inserted just
             after the last \textbf{JAchar} which is not regarded as a
             (Japanese) punctuation mark.
+%</en>
+%<*ja>
+パラグラフの最後の字が孤立して改行されるのを防ぐためのペナルティの値.
+このペナルティは(日本語の)句読点として扱われない最後の \textbf{JAchar} の直後に
+挿入される.
+%</ja>
 
 \item[\Param{kcatcode}\,=\{<chr\_code>,<natural number>\}]\
 
-An additional attributes having each character whose character code is <chr\_code>.
+%<*en>
+An additional attributes which each character whose character code is <chr\_code> has.
 At the present version, the lowermost bit of <natural number> indicates
             whether the character is considered as a punctuation mark
             (see the description of \Param{jcharwidowpenalty} above).
-
+%</en>
+%<*ja>
+文字コードが <chr\_code> の文字が持つ付加的な属性値 (attribute).
+現在のバージョンでは,<natural number> の最下位ビットが,その文字が句読点と
+みなされるかどうかを表している(上の \Param{jcharwidowpenalty} の記述を見よ).
+%</ja>
 
 \item[\Param{prebreakpenalty}\,=\{<chr\_code>,<penalty>\}] [\verb+\prebreakpenalty+]\
 %<*ja>
@@ -2653,43 +2725,76 @@ At the present version, the lowermost bit of <natural number> indicates
 という制限があったが,\LuaTeX-ja ではこれらの制限は解消されている.
 %</ja>
 
-\item[\Param{jatextfont}\,=\{<jfam>,<jfont\_cs>\}] [\verb+\textfont+ in \TeX]
-\item[\Param{jascriptfont}\,=\{<jfam>,<jfont\_cs>\}] [\verb+\scriptfont+ in \TeX]
-\item[\Param{jascriptscriptfont}\,=\{<jfam>,<jfont\_cs>\}] [\verb+\scriptscriptfont+ in \TeX]
+\item[\Param{jatextfont}\,=\{<jfam>,<jfont\_cs>\}]
+%<en>[\verb+\textfont+ in \TeX]
+%<ja>[\TeX の \verb+\textfont+]
+\item[\Param{jascriptfont}\,=\{<jfam>,<jfont\_cs>\}]
+%<en>[\verb+\scriptfont+ in \TeX]
+%<ja>[\TeX の \verb+\scriptfont+]
+\item[\Param{jascriptscriptfont}\,=\{<jfam>,<jfont\_cs>\}]
+%<en>[\verb+\scriptscriptfont+ in \TeX]
+%<ja>[\TeX の \verb+\scriptscriptfont+]
 \item[\Param{yjabaselineshift}\,=<dimen>$^\ast$]\
 \item[\Param{yalbaselineshift}\,=<dimen>$^\ast$] [\verb+\ybaselineshift+]
 
 \item[\Param{jaxspmode}\,=\{<chr\_code>,<mode>\}]
 
-Setting whether inserting  \Param{xkanjiskip} is allowed before/after a \textbf{JAchar} whose character code is <chr\_code>.
+%<*en>
+Setting whether inserting \Param{xkanjiskip} is allowed before/after a \textbf{JAchar} whose character code is <chr\_code>.
 The followings are allowed for <mode>:
+%</en>
+%<*ja>
+文字コードが <chr\_code> の \textbf{JAchar} の前/後ろに \Param{xkanjiskip} の
+挿入を許すかどうかの設定.
+以下の <mode> が許される:
+%</ja>
 \begin{description}
-\item[0, \texttt{inhibit}] Insertion of \Param{xkanjiskip} is inhibited before the character, nor after the character.
-\item[1, \texttt{preonly}] Insertion of \Param{xkanjiskip} is allowed before the character, but not after.
-\item[2, \texttt{postonly}] Insertion of \Param{xkanjiskip} is allowed after the character, but not before.
-\item[3, \texttt{allow}] Insertion of \Param{xkanjiskip} is allowed before the character and after the character.
-This is the default value.
+%<en>\item[0, \texttt{inhibit}] Insertion of \Param{xkanjiskip} is inhibited before the character, nor after the character.
+%<ja>\item[0, \texttt{inhibit}] \Param{xkanjiskip} の挿入は文字の前/後ろのいずれでも禁止される.
+%<en>\item[1, \texttt{preonly}] Insertion of \Param{xkanjiskip} is allowed before the character, but not after.
+%<ja>\item[1, \texttt{preonly}] \Param{xkanjiskip} の挿入は文字の前では許されるが,後ろでは許されない.
+%<en>\item[2, \texttt{postonly}] Insertion of \Param{xkanjiskip} is allowed after the character, but not before.
+%<ja>\item[2, \texttt{postonly}] \Param{xkanjiskip} の挿入は文字の後ろでは許されるが,前では許されない.
+%<en>\item[3, \texttt{allow}] Insertion of \Param{xkanjiskip} is allowed both before the character and after the character. This is the default value.
+%<ja>\item[3, \texttt{allow}] \Param{xkanjiskip} の挿入は文字の前/後ろのいずれでも許される.これがデフォルトの値である.
 \end{description}
+%<*en>
 This parameter is similar to the \verb+\inhibitxspcode+ primitive of \pTeX, but not compatible with \verb+\inhibitxspcode+.
-
+%</en>
+%<*ja>
+このパラメータは \pTeX の \verb+\inhibitxspcode+ プリミティブと似ているが,
+互換性はない.
+%</ja>
 
 \item[\Param{alxspmode}\,=\{<chr\_code>,<mode>\}] [\verb+\xspcode+]
 
+%<*en>
 Setting whether inserting \Param{xkanjiskip} is allowed before/after a
             \textbf{ALchar} whose character code is <chr\_code>.
-The followings are allowed for <mode>:
+             The followings are allowed for <mode>:
+%</en>
+%<*ja>
+文字コードが <chr\_code> の \textbf{ALchar} の前/後ろに \Param{xkanjiskip} の
+挿入を許すかどうかの設定.
+以下の <mode> が許される:
+%</ja>
 \begin{description}
-\item[0, \texttt{inhibit}] Insertion of \Param{xkanjiskip} is inhibited
-          before the character, nor after the character.
-\item[1, \texttt{preonly}] Insertion of \Param{xkanjiskip} is allowed
-          before the character, but not after.
-\item[2, \texttt{postonly}] Insertion of \Param{xkanjiskip} is allowed
-          after the character, but not before.
-\item[3, \texttt{allow}] Insertion of \Param{xkanjiskip} is allowed both
-          before the character and after the character.
-This is the default value.
+%<en>\item[0, \texttt{inhibit}] Insertion of \Param{xkanjiskip} is inhibited before the character, nor after the character.
+%<ja>\item[0, \texttt{inhibit}] \Param{xkanjiskip} の挿入は文字の前/後ろのいずれでも禁止される.
+%<en>\item[1, \texttt{preonly}] Insertion of \Param{xkanjiskip} is allowed before the character, but not after.
+%<ja>\item[1, \texttt{preonly}] \Param{xkanjiskip} の挿入は文字の前では許されるが,後ろでは許されない.
+%<en>\item[2, \texttt{postonly}] Insertion of \Param{xkanjiskip} is allowed after the character, but not before.
+%<ja>\item[2, \texttt{postonly}] \Param{xkanjiskip} の挿入は文字の後ろでは許されるが,前では許されない.
+%<en>\item[3, \texttt{allow}] Insertion of \Param{xkanjiskip} is allowed before the character and after the character. This is the default value.
+%<ja>\item[3, \texttt{allow}] \Param{xkanjiskip} の挿入は文字の前/後ろのいずれでも許される.これがデフォルトの値である.
 \end{description}
+%<*en>
 Note that parameters \Param{jaxspmode} and \Param{alxspmode} use a common table, hence these two parameters are synonyms of each other.
+%</en>
+%<*ja>
+\Param{jaxspmode} と \Param{alxspmode} は共通のテーブルを用いているため,
+これら2つのパラメータは互いの異名となっていることに注意する.
+%</ja>
 
 \item[\Param{autospacing}\,=<bool>$^\ast$] [\verb+\autospacing+]
 \item[\Param{autoxspacing}\,=<bool>$^\ast$] [\verb+\autoxspacing+]
@@ -2698,8 +2803,15 @@ Note that parameters \Param{jaxspmode} and \Param{alxspmode} use a common table,
 
 \item[\Param{differentjfm}\,=<mode>$^\dagger$]
 
+%<*en>
 Specify how glues/kerns between two \textbf{JAchar}s whose JFM (or size) are different.
 The allowed arguments are the followings:
+%</en>
+%<*ja>
+JFM(もしくはサイズ)が異なる2つの \textbf{JAchar} の間にグルー/カーンをどのように
+入れるかを指定うる.
+許される値は以下の通り:
+%</ja>
 \begin{description}
 \item[\texttt{average}]
 \item[\texttt{both}]
@@ -2716,7 +2828,13 @@ The allowed arguments are the followings:
 %<ja>\section{その他のプリミティブ}
 %<en>\subsection{Primitives for Compatibility}
 %<ja>\subsection{互換プリミティブ}
+
+%<*en>
 The following primitives are implemented for compatibility with \pTeX:
+%</en>
+%<*ja>
+以下のプリミティブは \pTeX との互換性のために実装されている:
+%</ja>
 \begin{list}{}{\def\makelabel{\ttfamily\char92 }\advance\leftmargin1\zw}
 \item[kuten]
 \item[jis]
@@ -2725,11 +2843,20 @@ The following primitives are implemented for compatibility with \pTeX:
 \item[ucs]
 \item[kansuji]
 \end{list}
+
 %<en>\subsection{\texttt{\char92 inhibitglue} primitive}
 %<ja>\subsection{\texttt{\char92 inhibitglue} プリミティブ}
+
+%<*en>
 The primitive \verb+\inhibitglue+ suppresses the insertion of \textbf{JAglue}.
 The following is an example, using a special JFM that there will be a glue between
 the beginning of a box and `あ', and also between `あ' and `ウ'.
+%</en>
+%<*ja>
+\verb+\inhibitglue+ プリミティブは \textbf{JAglue} の挿入を抑制する.
+以下は,ボックスの始めと`あ'の間,`あ'と`ウ'の間にグルーが入る特別な JFM を用いた例で
+ある.
+%</ja>
 
 \begin{LTXexample}
 \jfont\g=psft:Ryumin-Light:jfm=test \g
@@ -2740,16 +2867,42 @@ the beginning of a box and `あ', and also between `あ' and `ウ'.
 \par\inhibitglue\hrule あoff\inhibitglue ice
 \end{LTXexample}
 
+%<*en>
 With the help of this example, we remark the specification of \verb+\inhibitglue+:
+%</en>
+%<*ja>
+この例を援用して,\verb+\inhibitglue+ の仕様について述べる.
+%</ja>
 \begin{itemize}
+%<*en>
 \item The call of \verb+\inhibitglue+ in the (internal) vertical mode is
       effective at the beginning of the next paragraph. This is realized
       by hacking \verb+\everypar+.
+%</en>
+%<*ja>
+\item \verb+\inhibitglue+ の垂直モード中での呼び出しは次の段落の始めで効力を持つ.
+  これは \verb+\everypar+ のハックによって実現されている.
+%</ja>
+
+%<*en>
 \item The call of \verb+\inhibitglue+ in the (restricted) horizontal
       mode is only effective on the spot; does not get over boundary of
       paragraphs. Moreover, \verb+\inhibitglue+ cancels ligatures and
       kernings, as shown in line~4 of above example.
+%</en>
+%<*ja>
+\item \verb+\inhibitglue+ の(制限された)水平モード中での呼び出しはその場でのみ
+  有効であり,段落の境界を乗り越えない.
+  さらに,\verb+\inhibitglue+ は上の例の4行目のようにリガチャとカーニングを
+  打ち消す.
+%</ja>
+
+%<*en>
 \item The call of \verb+\inhibitglue+ in math mode is just ignored.
+%</en>
+%<*ja>
+\item \verb+\inhibitglue+ を数式モード中で呼び出した場合はただ無視される.
+%</ja>
 \end{itemize}
 
 %<en>\section{Control Sequences for \LaTeXe}