doc/manual-zh.tex

   1 \documentclass{ltjarticle}
   2 \usepackage[twoside,left=23mm,width=170mm,right=17mm,top=25mm,height=231mm,bottom=32mm]{geometry}
   3 \DeclareYokoKanjiEncoding{ZH}{}{}
   4 \DeclareKanjiEncodingDefaults{}{}
   5 \DeclareErrorKanjiFont{ZH}{song}{m}{n}{10}
   6 \DeclareKanjiSubstitution{ZH}{song}{m}{n}
   7 \newcommand\songdefault{song}
   8 \newcommand\heidefault{hei}
   9 \renewcommand\kanjiencodingdefault{ZH}
  10 \renewcommand\kanjifamilydefault{\songdefault}
  11 \renewcommand\kanjiseriesdefault{\mddefault}
  12 \renewcommand\kanjishapedefault{\updefault}
  13 \DeclareKanjiFamily{ZH}{song}{}
  14 \DeclareFontShape{ZH}{song}{m}{n}{<->name:AdobeSongStd-Light:jfm=jis}{}
  15 \DeclareFontShape{ZH}{song}{bx}{n}{<->ssub*hei/m/n}{}
  16 \DeclareKanjiFamily{ZH}{hei}{}
  17 \DeclareFontShape{ZH}{hei}{m}{n}{<->name:AdobeHeitiStd-Regular:jfm=jis}{}
  18 \fontencoding{ZH}\selectfont
  19 \DeclareTextFontCommand{\textsong}{\songfamily}
  20 \DeclareTextFontCommand{\texthei}{\heifamily}
  21 \DeclareOldFontCommand{\song}{\normalfont\songfamily}{}
  22 \DeclareOldFontCommand{\hei}{\normalfont\heifamily}{}
  23 \DeclareSymbolFont{songti}{ZH}{song}{m}{n}
  24 \jfam\symsongti
  25 \SetSymbolFont{songti}{bold}{ZH}{hei}{m}{n}
  26 \DeclareSymbolFontAlphabet{\mathsong}{songti}
  27 \DeclareMathAlphabet{\mathhei}{ZH}{hei}{m}{n}
  28 \makeatletter
  29 \DeclareRobustCommand\songfamily{\not@math@alphabet\songfamily\mathsong\kanjifamily\songdefault\selectfont}
  30 \DeclareRobustCommand\heifamily{\not@math@alphabet\heifamily\mathhei\kanjifamily\heidefault\selectfont}
  31 \DeclareRobustCommand\rmfamily{\not@math@alphabet\rmfamily\mathrm\romanfamily\rmdefault\kanjifamily\songdefault\selectfont}
  32 \DeclareRobustCommand\sffamily{\not@math@alphabet\sffamily\mathsf\romanfamily\sfdefault\kanjifamily\heidefault\selectfont}
  33 \makeatother
  34 \def\LuaTeX{Lua\TeX}
  35 \def\pTeX{p\TeX}
  36 \def\pLaTeX{p\LaTeX}
  37 \begin{document}
  38 \section{\LuaTeX-ja的开发背景}
  39 \LuaTeX-ja是日本开发者北川宏典首倡的一个\LuaTeX的日文支持项目，该项目将\pTeX移植到了\LuaTeX，并做了一定的扩展，删除了一些不正常的特性。
  40
  41 \LuaTeX-ja的项目开发者如下：北川宏典，前田一贵，八登崇之，黑木裕介，阿部纪行，山本宗宏，本田知亮，斋藤修三郎和马起园等。
  42
  43 \LuaTeX-ja现在只能用于plain \TeX格式和\LaTeXe格式，尚不支持\TeX info和Con\TeX t格式。
  44
  45 \LuaTeX-ja现在的代码实现依赖于\verb!luatexbase!以及\verb!luaotfload!等宏包，并且现在仅仅实现了横排，直排组版尚未实现。
  46 \section{一些约定}
  47 在本文档中，有下面一些约定：
  48 \begin{itemize}
  49 \item 所有的CJK字符为\textbf{JAchar}，所有的其他字符为\textbf{ALchar}
  50 \item primitive，该词在本文档中不仅表示\LuaTeX的基本控制命令，也包括\LuaTeX-ja的相关的基本控制命令
  51 \item 所有的自然数从0开始
  52 \end{itemize}
  53 \section{安装使用}
  54 \subsection{\LuaTeX版本需求}
  55 \LuaTeX-ja需要使用版本号为大于0.65的\LuaTeX。如果用户使用的是\TeX Live2011或者Mac\TeX 2011以及最新版本的W32\TeX，都可以正常使用\LuaTeX-ja。
  56 \subsection{\LuaTeX-ja宏包安装}
  57 \begin{enumerate}
  58 \item \LuaTeX-ja宏包的获取：
  59         \begin{itemize}
  60         \item 如果用户使用git，那么可以使用如下命令获取：\\
  61                 \verb!$ git clone git://git.sourceforge.jp/gitroot/luatex-ja/luatexja.git!
  62         \item 另外用户还可以直接下载master版本：\\
  63                 \verb!$ wget http://git.sourceforge.jp/view?p=luatex-ja/luatexja.git;a=snapshot;h=HEAD;sf=tgz!
  64         \end{itemize}
  65 \item 用户需要将获取的\LuaTeX-ja宏包的\verb!src/!放置到你所用的发行版中的\verb!TEXMFLOACL!树下\verb!tex/!文件夹（如果不存在，请建立）下即可，查询该环境变量需要使用：\\
  66         \verb!$ kpeswhich -expand-var "$TEXMFLOCAL"!
  67 \item 刷新字体数据库：\\
  68         \verb!$ mkluatexfontdb!
  69 \end{enumerate}
  70 \section{\LuaTeX-ja在plain \TeX格式下的使用}
  71 对于日本用户，日文的排版可以直接使用：
  72 \begin{verbatim}
  73 \input luatexja.sty
  74 \end{verbatim}
  75
  76 这一行会默认调用\verb!luatexja.sty!文件，该文件作用相当于\pTeX中的\verb!ptex.tex!。该文件中设定了两款非嵌入字体：Ryumin-Light（明朝体）和GothicBBB-Medium（哥特体）。
  77 这些字体分别有三种大小：\verb!\tenmin!和\verb!\tengt!（10pt）；\verb!\sevenmin!和\verb!\sevengt!（7pt）；\verb!\fivemin!和\verb!\fivegt!（5pt）。
  78
  79 有几点请用户注意：
  80 \begin{itemize}
  81 \item 上述的两款字体需要你的pdf阅读器带有良好的非嵌入字体的支持，这里建议使用Adobe Reader，该阅读器使用了Kozuka Mincho字体。
  82 \item 在定义字体的时候，可以使用“级”（Q）单位，$1 Q = 0.25mm$，在\LuaTeX-ja中可以使用\verb!\jQ!命令调用该长度单位
  83 \item 一般情况下，相同大小日文字体比西文字体要大一下（中文字体也是如此），所以定义日文字体的时候需要一个缩放率：0.962216
  84 \item 在\textbf{JAchar}和\textbf{ALchar}之间插入的胶大小为：$(0.25\times0.962216\times\mathrm{10pt})^{\mathrm{+1pt}}_{\mathrm{-1pt}} = 2.40554\mathrm{pt}^{\mathrm{+1pt}}_{\mathrm{-1pt}}$
  85 \end{itemize}
  86 \section{\LuaTeX-ja在\LaTeXe格式的使用}
  87 \subsection{日文排版设置}
  88 在\LaTeXe下使用\LuaTeX-ja比较便利：
  89 \begin{verbatim}
  90 \usepackage{luatexja}
  91 \end{verbatim}
  92
  93 该宏包的作用相当于\pLaTeX中的\verb!plfonts.dtx!和\verb!pldefs.ltx!。
  94 \begin{itemize}
  95 \item 在该宏包中设定了\verb!JY3!编码，这个编码用来调用日文字体
  96 \item 该宏包定义了两个字体族：\verb!mc!和\verb!gt!。\\
  97 \begin{center}
  98         \begin{tabular}{ccccc}
  99         \hline
 100         字体&字体族&\verb!\mdseries!&\verb!\bfseries!&缩放率\\
 101         \hline
 102         \textit{mincho}&\verb!mc!&Ryumin-Light&GothicBBB-Medium&0.962216\\
 103         \textit{gothic}&\verb!gt!&GothicBBB-Medium&GothicBBB-Medium&0.962216\\
 104         \hline
 105         \end{tabular}
 106 \end{center}
 107 \item 在数学模式下，所有的字符使用\verb!mc!字体族来排印
 108 %中文的C\TeX和xeCJK都没有进行此项设定，导致不能在数学模式下输入中文
 109 \end{itemize}
 110
 111 上述使用的宏包，只满足了最小的日文环境设定需求，并为满足所有的日文排版需求。
 112 \LuaTeX-ja宏包提供了两个文档类：\verb!jclasses!（\pLaTeX标准文档类）和\verb!jsclasses!（奥村晴彦）。用户可自行选择两种文档类。
 113
 114 \subsection{中文排版设定}
 115 请先下载\verb!zh-classes!：
 116 \begin{verbatim}
 117 $ wget http://fandol-doc.googlecode.com/files/zh-classes.tar.xz
 118 \end{verbatim}
 119
 120 该文档类是基于\verb!jclasses!文档的中文设定版。
 121 这个文档类需要用户在本地安装两款字体：AdobeSongStd-Light.otf和AdobeHeitiStd-Regular.otf。
 122 这两款字体在你安装的中文版Adobe Reader的文件夹下。这两款字体设定如下：
 123 \begin{center}
 124         \begin{tabular}{cccc}
 125         \hline
 126         字体&字体族&\verb!\mdseries!&\verb!\bfseries!\\
 127         \hline
 128         \textit{song}&\verb!song!&AdobeSongStd-Light&AdobeHeitiStd-Regular\\
 129         \textit{hei}&\verb!hei!&AdobeHeitiStd-Regular&AdobeHeitiStd-Regular\\
 130         \hline
 131         \end{tabular}
 132 \end{center}
 133
 134 例如：
 135 \begin{verbatim}
 136 \documentclass{zh-article}
 137 \title{Lua\TeX测试}
 138 \author{某人甲}
 139 \begin{document}
 140 \maketitle
 141 Lua\TeX-ja中文测试。{\hei 测试}
 142 \end{document}
 143 \end{verbatim}
 144 \section{\LuaTeX-ja参数设定}
 145 \LuaTeX-ja包含大量的参数，以控制排版细节。
 146 设定这些参数需要使用命令：\verb!\ltjsetparameter!和\verb!\ltjgetparameter!命令。
 147 \subsection{JAchar范围的设定}
 148 在设定\textbf{JAchar}之前，需要分配一个小于217的自然数。如：
 149 \begin{verbatim}
 150 \ltjdefcharrange{100}{"10000-"1FFFF,`漢}
 151 \end{verbatim}
 152
 153 请注意这个设定是全局性的，不建议在文档正文中进行设定。
 154
 155 在范围设定好了之后，需要进行\verb!jacharrange!的设定：
 156 \begin{verbatim}
 157 \ltjsetparameter{jacharrange={-1, +2, +3, -4, -5, +6, +7, +8}}
 158 \end{verbatim}
 159
 160 这里定义了8个范围，在每个范围之前使用“+”或“-”进行设定，其中如果为$-$，则代表该范围为\textbf{ALchar}，如果为$+$，则该范围视作\textbf{JAchar}。
 161
 162 \LuaTeX-ja默认设定了8个范围，这些范围来源于下列数据：
 163 \begin{itemize}
 164 \item Unicode 6.0
 165 \item Adobe-Japan1-6与Unicode之间的映射\verb!Adobe-Japan1-UCS2!
 166 \item 八登崇之的up\TeX宏包：\verb!PXbase!
 167 \end{itemize}
 168
 169 \begin{description}
 170 \item[范围 $\mathbf{8^J}$]
 171 \begin{itemize}
 172 \def\ch#1#2{\item \char"#1\ (\texttt{U+00#1}, #2)}
 173 \ch{A7}{Section Sign}
 174 \ch{A8}{Diaeresis}
 175 \ch{B0}{Degree sign}
 176 \ch{B1}{Plus-minus sign}
 177 \ch{B4}{Spacing acute}
 178 \ch{B6}{Paragraph sign}
 179 \ch{D7}{Multiplication sign}
 180 \ch{F7}{Division Sign}
 181 \end{itemize}
 182 \item[范围 $\mathbf{1^A}$]
 183         \begin{itemize}
 184         \item \texttt{U+0080}--\texttt{U+00FF}: Latin-1 Supplement
 185         \item \texttt{U+0100}--\texttt{U+017F}: Latin Extended-A
 186         \item \texttt{U+0180}--\texttt{U+024F}: Latin Extended-B
 187         \item \texttt{U+0250}--\texttt{U+02AF}: IPA Extensions
 188         \item \texttt{U+02B0}--\texttt{U+02FF}: Spacing Modifier Letters
 189         \item \texttt{U+0300}--\texttt{U+036F}: Combining Diacritical Marks
 190         \item \texttt{U+1E00}--\texttt{U+1EFF}: Latin Extended Additional
 191 \end{itemize}
 192 \item[范围 $\mathbf{2^J}$]
 193         \begin{itemize}
 194         \item \texttt{U+0370}--\texttt{U+03FF}: Greek and Coptic
 195         \item \texttt{U+0400}--\texttt{U+04FF}: Cyrillic
 196         \item \texttt{U+1F00}--\texttt{U+1FFF}: Greek Extended
 197         \end{itemize}
 198 \end{description}
 199 \section{Lua\TeX-ja与Lua\TeX相关阅读材料}
 200 \begin{itemize}
 201 \item Lua\TeX官方主页：\verb!http://www.luatex.org!
 202 \item Lua\TeX\ SVN：\verb!http://foundry.supelec.fr/gf/project/luatex/!
 203 \item Lua\TeX：\verb!http://ja.wikipedia.org/wiki/LuaTeX!
 204 \item Lua\TeX-ja官方主页：\verb!http://en.sourceforge.jp/projects/luatex-ja/!
 205 \item p\TeX官方主页：\verb!http://ascii.asciimw.jp/pb/ptex/!
 206 \item Publishing \TeX：\verb!http://ja.wikipedia.org/wiki/PTeX!
 207 \item Vertical typesetting in \TeX：\verb!http://tug.org//TUGboat/Articles/tb11-3/tb29hamano.pdf!
 208 \item up\TeX官方主页：\verb!http://homepage3.nifty.com/ttk/comp/tex/uptex.html!
 209 \end{itemize}
 210 \end{document}