X-Git-Url: http://git.osdn.jp/view?a=blobdiff_plain;ds=sidebyside;f=doc%2Fluatexja.dtx;h=b7809c9a2c03001daceca6bf2fbd3f557decd92c;hb=2530f35ee3fc227da8df0bcfe8839cdf1c4ad505;hp=e8cbcf496f63d7d070577c24bcb626a19e1e2710;hpb=7db5773a2a845e695a6572f163cf2c6a7f43613a;p=luatex-ja%2Fluatexja.git
diff --git a/doc/luatexja.dtx b/doc/luatexja.dtx
index e8cbcf4..b7809c9 100644
--- a/doc/luatexja.dtx
+++ b/doc/luatexja.dtx
@@ -275,13 +275,16 @@ scripts for appropriate callbacks.
%<*en>
The \LuaTeX-ja package is under much influence of \pTeX\ engine. The initial
-target of development was to implement features of \pTeX. However,
-\emph{\LuaTeX-ja is not a just porting of \pTeX; unnatural
+target of development was to implement features of \pTeX. However,
+implementing all feature of \pTeX\ is impossible,
+since all process of \LuaTeX-ja must be implemented only by Lua and \TeX\ macros.
+Hence \emph{\LuaTeX-ja is not a just porting of \pTeX; unnatural
specifications/behaviors of \pTeX\ were not adopted}.
%
%<*ja>
\LuaTeX-jaã¯ï¼\pTeX ã«å¤å¤§ãªå½±é¿ãåãã¦ããï¼åæã®éçºç®æ¨ã¯ï¼\pTeX ã®æ©
-è½ãLuaã³ã¼ãã«ããå®è£
ãããã¨ã§ãã£ãï¼ãããï¼éçºãé²ãã«ã¤ãï¼\pTeX
+è½ãLuaã³ã¼ãã«ããå®è£
ãããã¨ã§ãã£ãï¼ãããï¼ï¼\pTeX ã¯ã¨ã³ã¸ã³æ¡å¼µã§ãã£ãã®ã«å¯¾ãï¼
+\LuaTeX-jaã¯Luaã³ã¼ãã¨\TeX ãã¯ããç¨ãã¦å
¨ã¦ãå®è£
ãã¦ããªããã°ãªããªãããï¼\pTeX
ã®å®å
¨ãªç§»æ¤ã¯ä¸å¯è½ã§ããï¼ã¾ã\pTeX ã«ãããå®è£
ãããããä¸å¯è§£ã«ãªã£
ã¦ãããããªç¶æ³ãçºè¦ãããï¼ãã®ããï¼\emph{\LuaTeX-jaã¯ï¼ãã¯ã
\pTeX ã®å®å
¨ãªç§»æ¤ã¯ç®æ¨ã¨ã¯ããªãï¼\pTeX ã«ãããä¸èªç¶ãªä»æ§ã»æåãã
@@ -289,34 +292,25 @@ specifications/behaviors of \pTeX\ were not adopted}.
%
%<*en>
-The followings are major changes from \pTeX:
+The followings are major changes from \pTeX.
+For more detailed information, see Part~\ref{part-imp} or other sections of this manual.
%
%<*ja>
以ä¸ã¯ \pTeX ããã®ä¸»ãªå¤æ´ç¹ã§ããï¼
+ãã詳細ã«ã¤ãã¦ã¯ç¬¬\ref{part-imp}é¨ãªã©æ¬ææ¸ã®æ®ããåç
§ï¼
%
-\begin{itemize}
-%<*en>
-\item \emph{\LuaTeX-ja does all process only with Lua and \TeX\ macros},
-while \pTeX\ is an engine extension of \TeX82.
-This means that several features of \pTeX\ are not completely implemented
-in \LuaTeX-ja.
-%
-%<*ja>
-\item \pTeX ã¯ã¨ã³ã¸ã³æ¡å¼µã§ãã£ãã®ã«å¯¾ãï¼
-\emph{\LuaTeX-jaã¯Luaã³ã¼ãã¨\TeX ãã¯ããç¨ãã¦å
¨ã¦ãå®è£
ãã¦ãã}ï¼
-ãã®ããï¼\pTeX ã®ããã¤ãã®æ©è½ã¯\LuaTeX-ja ã«ï¼ãã®ã¾ã¾ã®å½¢ã§ã¯ï¼å®è£
ãã¦ããªãï¼
-%
-\begin{itemize}
%<*en>
- \item \pTeX\ addes several primitives, such as \cs{kanjiskip},
+\paragraph{Command names} \pTeX\ addes several primitives, such as \cs{kanjiskip},
\cs{prebreakpenalty},~and,~\cs{ifydir}. They can be used as follows:
%
%<*ja>
- \item ä¾ãã°\pTeX ã§è¿½å ããã次ã®ãããªããªããã£ã
+\paragraph{å½ä»¤ã®å称} ä¾ãã°\pTeX ã§è¿½å ããã次ã®ãããªããªããã£ã
%
\begin{verbatim}
\kanjiskip=10pt \dimen0=kanjiskip
+\tbaselineshift=0.1zw
+\dimen0=\tbaselineshift
\prebreakpenalty`ã=100
\ifydir ... \fi
\end{verbatim}
@@ -324,37 +318,48 @@ in \LuaTeX-ja.
% Instead of them, we have to write as the following.
% ã¯\LuaTeX-jaã«ã¯åå¨ããªãï¼\LuaTeX-jaã§ã¯ä»¥ä¸ã®ããã«è¨è¿°ãããã¨ã«ãªãï¼
\begin{verbatim}
-\ltjsetparameter{kanjiskip} \dimen0=\ltjgetparameter{kanjiskip}
+\ltjsetparameter{kanjiskip=10pt} \dimen0=\ltjgetparameter{kanjiskip}
+\ltjsetparameter{talbaselineshift=0.1\zw}
+\dimen0=\ltjgetparameter{talbaselineshift}
\ltjsetparameter{prebreakpenalty={`ã,100}}
\ifnum\ltjgetparemeter{direction}=4 ... \fi
\end{verbatim}
+%<*en>
+Note that \pTeX\ adds new two useful units, namely \texttt{zw}~and~\texttt{zh}.
+As shown above, they are changed by \cs{zw}~and\cs{zh} respectively, in \LuaTeX-ja.
+%
+%<*ja>
+ç¹ã«æ³¨æãã¦ã»ããã®ã¯ï¼\pTeX ã§è¿½å ããã \texttt{zw} 㨠\texttt{zh} ã¨ããåä½ã
+\LuaTeX-ja ã§æ±ãã«ã¯ï¼\cs{zw}, \cs{zh} ã¨å¶å¾¡ç¶´ã®å½¢ã«ããªãã¨ãããªãã¨ããç¹ã§ããï¼
+%
%<*en>
-\item In \pTeX, a line break after Japanese character is ignored (and
+\paragraph{Linebreak after a Japanese character}
+In \pTeX, a line break after Japanese character is ignored (and
doesn't yield a space), since line breaks (in source files) are
permitted almost everywhere in Japanese texts. However, \LuaTeX-ja
doesn't have this feature completely, because of a specification
of \LuaTeX. For the detail, see Section~\ref{sec-lbreak}.
%
%<*ja>
-\item æ¥æ¬èªã®ææ¸ä¸ã§ã¯æ¹è¡ã¯ã»ã¨ãã©ã©ãã§ã許ãããã®ã§ï¼\pTeX ã§ã¯åææå
+\paragraph{åææåç´å¾ã®æ¹è¡}
+æ¥æ¬èªã®ææ¸ä¸ã§ã¯æ¹è¡ã¯ã»ã¨ãã©ã©ãã§ã許ãããã®ã§ï¼\pTeX ã§ã¯åææå
ç´å¾ã®æ¹è¡ã¯ç¡è¦ãããï¼ã¹ãã¼ã¹ãå
¥ããªãï¼ããã«ãªã£ã¦ããï¼ãããï¼
\LuaTeX-ja ã§ã¯ \LuaTeX ã®ä»æ§ã®ããã«ãã®æ©è½ã¯å®å
¨ã«ã¯å®è£
ããã¦ããªãï¼
詳ããã¯\ref{sec-lbreak}ç« ãåç
§ï¼
%
-\end{itemize}
-
-
-
%<*en>
-\item The insertion process of glues/kerns between two Japanese
+
+\paragraph{Spaces related to Japanese characters}
+The insertion process of glues/kerns between two Japanese
characters and between a Japanese character and other characters
(we refer glues/kerns of both kinds as \textbf{JAglue}) is rewritten from
scratch.
%
%<*ja>
-\item 2ã¤ã®åææåã®éãï¼åææåã¨æ¬§ææåã®éã«å
¥ãã°ã«ã¼ï¼ã«ã¼ã³
+\paragraph{åæé¢é£ã®ç©ºç½}
+2ã¤ã®åææåã®éãï¼åææåã¨æ¬§ææåã®éã«å
¥ãã°ã«ã¼ï¼ã«ã¼ã³
ï¼ä¸¡è
ããããã¦\textbf{JAglue}ã¨å¼ã¶ï¼ã®æ¿å
¥å¦çã0ããæ¸ãç´ããã¦ããï¼
%
@@ -402,7 +407,6 @@ in \LuaTeX-ja.
ã¡ã\hbox{}ã£ã¨
\end{lstlisting}
-
%<*en>
\item In the process, two Japanese fonts which only differ in their ``real''
fonts are identified.
@@ -413,28 +417,34 @@ in \LuaTeX-ja.
%
\end{itemize}
-%<*ja>
-\item ****çããã¯ï¼ä¸å®å®ãªããã\LuaTeX-ja ã«ããã縦çµã¿ããµãã¼ããã¦ããï¼
-\LuaTeX ã®ã³ã¼ã«ããã¯ã®å¶éãªã©ã«ããï¼ç¹ã«ç°ãªã£ãçµæ¹åã®ããã¯ã¹ãæ±ãå ´åã«ã¯
-ä»æ§ãç°ãªãã®ã§æ³¨æï¼
-%
-
%<*en>
-\item Japanese characters in discretionary break (\cs{discretionary}) is not supported.
+\paragraph{Directions}
+From version ********, \LuaTeX-ja supports vertical writing;
+but this feature must \emph{not} be confused with $\Omega$-style direction support of \LuaTeX\
+itself. ...
%
%<*ja>
-\item \cs{discretionary} å
ã«ç´æ¥åææåãè¨è¿°ãããã¨ã¯ãµãã¼ããããªãï¼åææåãã©ã
- ãã¦ã使ãããå ´å㯠\cs{hbox} ã§æ¬ããã¨ï¼
+\paragraph{çµæ¹å}
+****çããã¯ï¼ä¸å®å®ãªããã\LuaTeX-ja ã«ããã縦çµã¿ããµãã¼ããã¦ããï¼
+ãªãï¼\LuaTeX æ¬ä½ãï¼$\Omega$æµã®çµæ¹åããµãã¼ããã¦ãããï¼ããã¨ã¯å
¨ãã®å¥ç©ã§ãããã¨
+ã«æ³¨æãã¦ã»ããï¼
+\LuaTeX ã®ã³ã¼ã«ããã¯ãå®è£
ã«ããï¼ç¹ã«ç°ãªã£ãçµæ¹åã®ããã¯ã¹ãæ±ãå ´åã«ã¯
+\cs{wd}, \cs{ht}, \cs{dp}çã®ä»æ§ãç°ãªãã®ã§æ³¨æï¼è©³ç´°ã¯ç¬¬\ref{sec-direction}ç¯ãåç
§ï¼
%
-\end{itemize}
%<*en>
-For detailed information, see Part~\ref{part-imp}.
+\paragraph{\cs{discretionary}}
+Japanese characters in discretionary break (\cs{discretionary}) is not supported.
%
%<*ja>
-詳細ã«ã¤ãã¦ã¯ç¬¬\ref{part-imp}é¨ãåç
§ï¼
+\paragraph{\cs{discretionary}}
+ \cs{discretionary} å
ã«ç´æ¥åææåãè¨è¿°ãããã¨ã¯ï¼\pTeX ã«ããã¦ãæ³å®ããã¦ããªãã£ã
+ æããããï¼\LuaTeX-jaã«ããã¦ãæ³å®ãã¦ããªãï¼åææåãã©ã
+ ãã¦ã使ãããå ´å㯠\cs{hbox} ã§æ¬ããã¨ï¼
%
+
+
%\subsection{Notations}
%\subsection{ç¨èªã¨è¨æ³}
@@ -451,12 +461,12 @@ In this document, the following terms and notations are used:
(see Subsection~\ref{ssec-setrange}).
%
%<*ja>
-\item æåã¯æ¬¡ã®2種é¡ã«åããããï¼ãã®é¡å¥ã¯ã¦ã¼ã¶ãå¾ããå¤æ´å¯è½ã§ãã
+\item æåã¯æ¬¡ã®2種é¡ã«åããããï¼ãã®é¡å¥ã¯åºå®ããã¦ãããã®ã§ã¯ãªãï¼ã¦ã¼ã¶ãå¾ããå¤æ´å¯è½ã§ãã
ï¼\ref{ssec-setrange}ç¯ãåç
§ï¼ï¼
%
\begin{itemize}
%<*en>
-\item \textbf{JAchar}: standing for characters which used in Japanese typesetting,
+\item \textbf{JAchar}: standing for characters which is used in Japanese typesetting,
such as Hiragana,~Katakana, Kanji, and~other Japanese punctuation marks.
%
%<*ja>
@@ -717,9 +727,15 @@ Note that \texttt{*.\{dtx,ins\}} and \texttt{ltj-kinsoku\_make.tex} are not need
%
\end{enumerate}
-%\subsection{Cautions}
-%\subsection{注æç¹}
-
+%<*en>
+\subsection{Cautions}
+For changes from \pTeX, see Subsection~\ref{ssec:chgptex}.
+%
+%<*ja>
+\subsection{注æç¹}
+\pTeX ããã®å¤æ´ç¹ã¨ãã¦ï¼\ref{ssec:chgptex}ç¯ãçèªããã®ãæã¾ããï¼
+ããã§ã¯ä¸è¬çãªæ³¨æç¹ãè¿°ã¹ãï¼
+%
\begin{itemize}
%<*en>
\item The encoding of your source file must be UTF-8. No other
@@ -1010,11 +1026,12 @@ Okumura), namely, \Pkg{ltjclasses}\footnote{%
è注ã¨ããã ããã¼ãã®é åºã¯\LaTeX éãã¨ããï¼ãã\pLaTeX ã®åºåé åºã好ã¿ãªãã°ï¼
\Pkg{stfloats}ããã±ã¼ã¸ãå©ç¨ãã¦
\begin{lstlisting}
- \usepackage{stfloats} \fnbelowfloat
+ \usepackage{stfloats}\fnbelowfloat
\end{lstlisting}
ã®ããã«ããã°ããï¼\Pkg{footmisc}ããã±ã¼ã¸ã \texttt{bottom}\ ãªãã·ã§ã³ãæå®ãã¦
èªã¿è¾¼ãã¨ããæ¹æ³ããããï¼ããã ã¨ããã ããã¼ãã¨è注ã®éãéãã¦ãã¾ãï¼
%
+%%% âã¯è±è¨³ããªã
%\section{Changing Fonts}
%\section{ãã©ã³ãã®å¤æ´}
@@ -1472,7 +1489,7 @@ In above table, starred fonts (KozGo\dots-Regular) are used for medium series of
\emph{if and only if \texttt{deluxe} option is specified}.
%
%<*ja>
-ä¸ã®è¡¨ã«ããã¦ï¼*ã¤ãã®ãã©ã³ã(KozGo\dots-Regular)ã¯ï¼\emph{\texttt{deluxe}ãªãã·ã§ã³éæå®æã«}
+ä¸ã®è¡¨ã«ããã¦ï¼*ã¤ãã®ãã©ã³ã(KozGo\dots-Regular)ã¯ï¼\emph{\texttt{deluxe}ãªãã·ã§ã³æå®æã«}
ã´ã·ãã¯ä½ç´°åã¨ãã¦ç¨ããããï¼
%
@@ -2391,6 +2408,7 @@ $\Phi\vdash F(x)\ \hbox{for all}\ x\in A$
\end{table}
%
+
\clearpage
%\part{Reference}
%\part{ãªãã¡ã¬ã³ã¹}