From 7ae913a662e817e559620e1114b63e0f412ff2e3 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Sat, 26 Dec 2020 03:02:09 +0000 Subject: CTAN sync 202012260302 --- macros/luatex/generic/chinese-jfm/README.md | 59 +++------------- macros/luatex/generic/chinese-jfm/doc.pdf | Bin 0 -> 105785 bytes macros/luatex/generic/chinese-jfm/doc.tex | 85 ++++++++++++++++++++++++ macros/luatex/generic/chinese-jfm/jfm-ja_JP.lua | 2 +- macros/luatex/generic/chinese-jfm/jfm-zh_CN.lua | 2 +- macros/luatex/generic/chinese-jfm/jfm-zh_TW.lua | 2 +- 6 files changed, 99 insertions(+), 51 deletions(-) create mode 100644 macros/luatex/generic/chinese-jfm/doc.pdf create mode 100644 macros/luatex/generic/chinese-jfm/doc.tex (limited to 'macros/luatex/generic') diff --git a/macros/luatex/generic/chinese-jfm/README.md b/macros/luatex/generic/chinese-jfm/README.md index e105609705..02ded93f7c 100644 --- a/macros/luatex/generic/chinese-jfm/README.md +++ b/macros/luatex/generic/chinese-jfm/README.md @@ -1,57 +1,20 @@ -# 中文使用的 luatexja JFM 文件 +# Chinese JFM files -为中文编写的 luatexja JFM 文件,提供全角、半角、开明三种风格,适用于简繁中文及日文字体的横直排。 +## Introduction -## 使用方法 +Chinese JFM is a series of luatexja-jfm files for better Chinese typesetting, providing *quanjiao*, *banjiao*, and *kaiming* three styles and other fancy features. It can be used for both horizontal and vertical writing mode in Simplified/Traditional Chinese or Japanese fonts. -luatexja 可以使用 `/` 来调用 JFM 特性,语法为 `JFM=/{}` 。受北川宏典先生的 [fork 版本](https://github.com/h-kitagawa/ChineseJFM/tree/combine)的影响,所有风格的 JFM 被整合进一个文件内,使用 JFM 特性调用。 +For detailed useages, please read the [documentation](doc.pdf) (in Chinese). -### 特性一览 +## Update info -* `quanjiao`、`banjiao`、`kaiming` - - 最基础的三种特性,即「全角」「半角」与「开明」。此三特性**必须**选择其中一种。 - -* `vert` - - 直排特性,在直排时必须使用。 - -* `hwcl` - - 半宽冒号特性,仅 zh_CN 拥有,必须在直排下使用。适用于部分竖排时冒号只占半宽的字体。 - -* `prop` - - 比例宽度特性,仅 ja_JP 拥有。适用于日文的比例假名字体。 - -## 挤压顺序 - -JFM 文件中同时增加了 `priority` 的设置,配合 luatexja-adjust 包,可以进行有优先顺序的标点挤压。挤压顺序如下: - -* 最优先挤压引号、括号前后与间隔号两边的空格; - -* 其次挤压顿号、逗号、冒号、分号后的空格; - -* 最后挤压句号、问号、叹号后的空格。 - -* 如果进行上述挤压后,仍无法达到行长要求,最后才会进行字间字距调整。 - -\**注:以上对标点空白的描述是针对于简体中文的。对于标点置中的繁体中文,以上调整顺序仍然适用。但此时除括号外,可调整的空白变为标点两边的空白。全宽标点无空白可调整的,不作调整。* - -以上挤压规则是针对于全角风格的标点调整。对于半角与开明这种标点风格,若以「挤压」理解,顺序仍相同,但直观性就有所欠缺。事实上,JFM 文件中的标点是沿袭铅字与 InDesign 的习惯,认为标点只占半宽,全宽标点是半宽标点加上半宽空格的结果。因此上述规则在半宽标点的前提下应描述为: - -* 最先给句号、问号、叹号插空; - -* 其次添加顿号、逗号、冒号、分号后空格; - -* 最后调整引号、括号前后与间隔号两边的空格; - -* 如果进行上述调整后,仍无法达到行长要求,最后才会进行字间字距调整。 +* v1.0.0 -「加法式」的标点调整,更加直观,也更容易理解。 +First published to CTAN. -## 修改说明 +* v1.0.1 -* v1.0.0 +Update documentation. - 初次发布至 CTAN。 +--- +Copyright (C) 2020 ListLee. diff --git a/macros/luatex/generic/chinese-jfm/doc.pdf b/macros/luatex/generic/chinese-jfm/doc.pdf new file mode 100644 index 0000000000..76f797b9dd Binary files /dev/null and b/macros/luatex/generic/chinese-jfm/doc.pdf differ diff --git a/macros/luatex/generic/chinese-jfm/doc.tex b/macros/luatex/generic/chinese-jfm/doc.tex new file mode 100644 index 0000000000..033a3dc8eb --- /dev/null +++ b/macros/luatex/generic/chinese-jfm/doc.tex @@ -0,0 +1,85 @@ +\documentclass[a4paper, fontset=adobe , punct=zh_CN/kaiming]{ctexart} +\usepackage{luatexja-adjust} + +\def\+{\insertxkanjiskip} + +\usepackage[textwidth=36em , centering]{geometry} + +\usepackage{hyperref} +\hypersetup{colorlinks=true} + +\title{\textbf{\textsf{ChineseJFM}文件}\hbox{}\thanks{\url{https://github.com/tanukihee/ChineseJFM}}} +\author{ListLee} +\date{\zhtoday \qquad v1.0.1} + +\begin{document} +\maketitle + +\section{概述} +\textsf{ChineseJFM}文件是为中文排版编写的luatexja-jfm文件,提供全角、半角、开明三种风格,适用于简繁中文及日文字体的横直排。 + +虽然\textsf{luatexja}自带了一套全角、半角、开明的JFM文件,但在调整上缺少灵活性,同时也没有使用\+\verb|priority|特性。\textsf{ChineseJFM}文件中同时增加了\+\verb|priority|的设置,配合\textsf{luatexja-adjust}包,可以进行有优先顺序的标点挤压。\label{sec:pr} + +\section{使用方法} +\textsf{luatexja}在20200919版本后更新了JFM features特性,基本语法为 +\begin{verbatim} + jfm = [/{}] +\end{verbatim} + +\textsf{ChineseJFM}提供了\textsf{zh\_CN}、\textsf{zh\_TW}与\textsf{ja\_JP}三个文件,分别适用于简中字体(标点偏靠)、繁中字体(标点中置)与日文字体(冒号、分号中置,其他偏靠);在3个JFM文件下,提供了\+\verb|quanjiao|、\verb|banjiao|与\+\verb|kaiming|三个基本特性。 + +在使用\CTeX{}宏集或文档类时,只需要使用 +\begin{verbatim} + \documentclass[punct = zh_CN/quanjiao]{ctexart} +\end{verbatim} +或 +\begin{verbatim} + \usepackage[punct = zh_CN/kaiming]{ctex} +\end{verbatim} +即可。 + +在使用\textsf{luatexja}或\textsf{ltj}文档类时,需要在调用\textsf{luatexja-fontspec}宏包后,以\begin{verbatim} + YokoFeatures = {JFM = {}} +\end{verbatim} +或 +\begin{verbatim} + TateFeatures = {JFM = {}} +\end{verbatim} +的形式调用。 + +横排时,使用 +\begin{verbatim} + YokoFeatures = {JFM = {zh_CN/quanjiao}} +\end{verbatim} +直排时,使用 +\begin{verbatim} + TateFeatures = {JFM = {zh_CN/{quanjiao , vert}}} +\end{verbatim} +{\color{red}注意:在直排时,\emph{必须}同时使用\+\verb|vert|特性。} + +\section{特性一览} +除上文介绍的\+\verb|quanjiao|、\verb|banjiao|、\verb|kaiming|与\+\verb|vert|特性外,\textsf{ChineseJFM}还提供了以下特性。 + +\begin{description} + \item[\texttt{hwcl}] “half-width colon”,“半宽冒号”特性,适用于简中直排时,冒号分号只占半宽的字体(如华文宋体等),仅\textsf{zh\_CN}拥有。 + \item[\texttt{prop}] “proportional”,“比例宽度”特性,使用于比例宽度的日文字体,比之于\textsf{luatexja}自带的\textsf{jfm-prop.lua}与\textsf{jfm-propv.lua},\verb|prop|特性将此两者整合的同时,也提供了对标点间距的调整功能,仅\textsf{ja\_JP}拥有。 +\end{description} + +\section{挤压顺序} +如第\ref{sec:pr}节所述,\textsf{ChineseJFM}文件中配有\+\verb|priority|的设置,配合\textsf{luatexja-adjust}包,可以进行有优先顺序的标点挤压。\textsf{ChineseJFM}沿袭传统铅字排版与现代DTP软件(如InDesign等)的习惯,认为标点只占半宽,全宽标点是半宽标点加上半宽铅空的结果。所谓的“标点挤压”更应说成是“标点间距调整”,调整顺序如下。 +\begin{itemize} + \item 最先给句号、问号、叹号插空; + \item 其次给顿号、逗号、冒号、分号插空; + \item 最后调整引号、括号前后与间隔号两边的空格; + \item 如果进行上述调整后,仍无法达到行长要求,最后才会进行字间字距调整。 +\end{itemize} + +根据标点位置,可以将标点分为偏靠标点、中置标点与全宽标点。对于偏靠标点,插空指在半宽标点后插入一个半宽铅空,对于中置标点,插空指在半宽标点前后各插入一个1/4宽铅空。全宽标点无空白可调整的,不作调整。 + +\nocite{*} +\begin{thebibliography}{9} +\bibitem{孔雀计划} 刘庆(Eric Q L).\textit{孔雀计划:中文字体排印的思路} [EB/OL].\\ +\raggedleft{\url{https://thetype.com/kongque/}} +\end{thebibliography} + +\end{document} \ No newline at end of file diff --git a/macros/luatex/generic/chinese-jfm/jfm-ja_JP.lua b/macros/luatex/generic/chinese-jfm/jfm-ja_JP.lua index 5be752863c..863c89a79b 100644 --- a/macros/luatex/generic/chinese-jfm/jfm-ja_JP.lua +++ b/macros/luatex/generic/chinese-jfm/jfm-ja_JP.lua @@ -1,5 +1,5 @@ -- Chinese JFM for Japanese fonts (ja_JP) --- v1.0.0 +-- v1.0.1 local is_vt, is_qj, is_bj, is_km, is_prop diff --git a/macros/luatex/generic/chinese-jfm/jfm-zh_CN.lua b/macros/luatex/generic/chinese-jfm/jfm-zh_CN.lua index fc707eaab6..ed161a10a1 100644 --- a/macros/luatex/generic/chinese-jfm/jfm-zh_CN.lua +++ b/macros/luatex/generic/chinese-jfm/jfm-zh_CN.lua @@ -1,5 +1,5 @@ -- Chinese JFM for Simplified Chinese fonts (zh_CN) --- v1.0.0 +-- v1.0.1 local is_vt, is_qj, is_bj, is_km, is_hwcl diff --git a/macros/luatex/generic/chinese-jfm/jfm-zh_TW.lua b/macros/luatex/generic/chinese-jfm/jfm-zh_TW.lua index 90db78939e..9000cf0d74 100644 --- a/macros/luatex/generic/chinese-jfm/jfm-zh_TW.lua +++ b/macros/luatex/generic/chinese-jfm/jfm-zh_TW.lua @@ -1,5 +1,5 @@ -- Chinese JFM for Traditional Chinese fonts (zh_TW) --- v1.0.0 +-- v1.0.1 local is_vt, is_qj, is_bj, is_km -- cgit v1.2.3