summaryrefslogtreecommitdiff
path: root/macros/luatex/generic
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2020-12-26 03:02:09 +0000
committerNorbert Preining <norbert@preining.info>2020-12-26 03:02:09 +0000
commit7ae913a662e817e559620e1114b63e0f412ff2e3 (patch)
tree96a6fab8955d0a1a5632599d839a1006290a2930 /macros/luatex/generic
parent41eb4dfa0badd165fc762b85c3ba592b4e57d38a (diff)
CTAN sync 202012260302
Diffstat (limited to 'macros/luatex/generic')
-rw-r--r--macros/luatex/generic/chinese-jfm/README.md59
-rw-r--r--macros/luatex/generic/chinese-jfm/doc.pdfbin0 -> 105785 bytes
-rw-r--r--macros/luatex/generic/chinese-jfm/doc.tex85
-rw-r--r--macros/luatex/generic/chinese-jfm/jfm-ja_JP.lua2
-rw-r--r--macros/luatex/generic/chinese-jfm/jfm-zh_CN.lua2
-rw-r--r--macros/luatex/generic/chinese-jfm/jfm-zh_TW.lua2
6 files changed, 99 insertions, 51 deletions
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=<JFM name>/{<JFM features>}` 。受北川宏典先生的 [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
--- /dev/null
+++ b/macros/luatex/generic/chinese-jfm/doc.pdf
Binary files 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 = <JFM name>[/{<JFM features>}]
+\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 = {<JFM name>}}
+\end{verbatim}
+或
+\begin{verbatim}
+ TateFeatures = {JFM = {<JFM name>}}
+\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