Debian Codegraph @

texmf-dist/doc/luatex/chinese-jfm/chinese-jfm.tex

raw
1 % The documentation of chinese-jfm
2 % v1.1.0
3 % Copyright (c) 2020 -- 2021 ListLee.
4
5 \documentclass[a4paper , zihao=-4 , fontset=adobe , punct=zh_CN/kaiming]{ctexart}
6 \usepackage{luatexja-adjust}
7 % \usepackage{lua-visual-debug}
8 \protect\def\+{\insertxkanjiskip}
9
10 \usepackage[textwidth=34em , centering]{geometry}
11
12 \usepackage{hyperref}
13 \hypersetup{colorlinks=true}
14
15 \title{\textbf{\textsf{Chinese JFM}}\thanks{\url{https://github.com/tanukihee/ChineseJFM}}}
16 \author{ListLee}
17 \date{\zhtoday \qquad v1.1.1}
18
19 \begin{document}
20 \maketitle
21
22 \section{概述}
23 \textsf{Chinese JFM}是为中文排版编写的luatexja-jfm文件,提供全角、半角、开明三种风格,适用于简繁中文及日文字体的横直排。
24
25 虽然\textsf{luatexja}自带了一套全角、半角、开明的JFM文件,但在调整上缺少灵活性,同时也没有使用\+\verb|priority|特性。\textsf{Chinese JFM}文件中同时增加了\+\verb|priority|的设置,配合\textsf{luatexja-adjust}包,可以进行有优先顺序的标点挤压。\label{sec:pr}
26
27 \section{使用方法}
28 \textsf{luatexja}在20200919版本后更新了JFM features特性,基本语法为
29 \begin{verbatim}
30 jfm = <JFM name>[/{<JFM features>}]
31 \end{verbatim}
32
33 \textsf{Chinese JFM}提供了\textsf{zh\_CN}、\textsf{zh\_TW}与\textsf{ja\_JP}三个文件,分别适用于简中字体(标点偏靠)、繁中字体(标点中置)与日文字体(冒号、分号中置,其他偏靠);在3个JFM文件中,均提供了\+\verb|quanjiao|、\verb|banjiao|与\+\verb|kaiming|三个基本特性。
34
35 在使用\CTeX{}宏集或文档类时,只需要使用
36 \begin{verbatim}
37 \documentclass[punct = zh_CN/quanjiao]{ctexart}
38 \end{verbatim}
39 或
40 \begin{verbatim}
41 \usepackage[punct = zh_CN/kaiming]{ctex}
42 \end{verbatim}
43 即可。
44
45 在使用\textsf{luatexja}或\textsf{ltj}文档类时,需要在调用\textsf{luatexja-fontspec}宏包后,以\begin{verbatim}
46 YokoFeatures = {JFM = {<JFM name>}}
47 \end{verbatim}
48 或
49 \begin{verbatim}
50 TateFeatures = {JFM = {<JFM name>}}
51 \end{verbatim}
52 的形式调用。
53
54 横排时,使用
55 \begin{verbatim}
56 YokoFeatures = {JFM = {zh_CN/quanjiao}}
57 \end{verbatim}
58 直排时,使用
59 \begin{verbatim}
60 TateFeatures = {JFM = {zh_CN/{quanjiao , vert}}}
61 \end{verbatim}
62 {\color{red}注意:在直排时,\emph{必须}同时使用\+\verb|vert|特性。}
63
64 \section{特性一览}
65 除上文介绍的\+\verb|quanjiao|、\verb|banjiao|、\verb|kaiming|与\+\verb|vert|特性外,\textsf{Chinese JFM}还提供了以下特性。
66
67 \begin{description}
68 \item[\texttt{fzpr}] “\textit{Fangzheng} parenthesis”,“方正括号”特性。部分方正字体会将除引号外的括号做在中间位置。开启本特性,可以将括号调整至“正常”位置。仅\textsf{zh\_CN}拥有。
69 \item[\texttt{hwcl}] “half-width colon”,“半宽冒号”特性。适用于简中直排时,冒号分号只占半宽的字体(如华文宋体等)。仅\textsf{zh\_CN}拥有。
70 \item[\texttt{prop}] “proportional”,“比例宽度”特性。适用于比例宽度的日文字体,比之于\textsf{lua\-texja}自带的\textsf{jfm-prop.lua}与\textsf{jfm-propv.lua},\verb|prop|特性将此两者整合的同时,也提供了对标点间距的调整功能。仅\textsf{ja\_JP}拥有。
71 \end{description}
72
73 \section{挤压顺序}
74 如第\ref{sec:pr}节所述,\textsf{Chinese JFM}中配有\+\verb|priority|的设置,配合\textsf{luatexja-adjust}包,可以进行有优先顺序的标点挤压。\textsf{Chinese JFM}沿袭传统铅字排版与现代DTP软件(如InDesign等)的习惯,认为标点只占半宽,全宽标点是半宽标点加上半宽铅空的结果。所谓的“标点挤压”更应说成是“标点间距调整”,调整顺序如下。
75 \begin{itemize}
76 \item 最先给句号、问号、叹号插空;
77 \item 其次给顿号、逗号、冒号、分号插空;
78 \item 最后调整引号、括号前后与间隔号两边的空格;
79 \item 如果进行上述调整后,仍无法达到行长要求,最后才会进行字间字距调整。
80 \end{itemize}
81
82 根据标点位置,可以将标点分为偏靠标点、中置标点与全宽标点。对于偏靠标点,插空指在半宽标点后插入一个半宽铅空,对于中置标点,插空指在半宽标点前后各插入一个1/4宽铅空。全宽标点无空白可调整的,不作调整。
83
84 \nocite{*}
85 \begin{thebibliography}{9}
86 \bibitem{LuaTeX-ja} Lua\TeX-jaプロジェクトチーム.\textit{Lua\TeX-jaパッケージ}[EB/OL].version 20210214.0,(2021-02-14)\\\mbox{}
87 \hfill\url{https://ctan.org/pkg/luatexja}
88
89 \bibitem{CTeX} CTEX.ORG.\textit{\CTeX{}宏集手册}[EB/OL].version 2.5.5,(2020-10-19)\\\mbox{}
90 \hfill\url{https://ctan.org/pkg/ctex}
91
92 \bibitem{孔雀计划} 刘庆(Eric Q L).\textit{孔雀计划:中文字体排印的思路}[EB/OL].\\\mbox{}
93 \hfill\url{https://thetype.com/kongque/}
94 \end{thebibliography}
95
96 \end{document}