texlive[57227] Master/texmf-dist: chinese-jfm (25dec20)
commits+karl at tug.org
commits+karl at tug.org
Fri Dec 25 23:04:28 CET 2020
Revision: 57227
http://tug.org/svn/texlive?view=revision&revision=57227
Author: karl
Date: 2020-12-25 23:04:27 +0100 (Fri, 25 Dec 2020)
Log Message:
-----------
chinese-jfm (25dec20)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/luatex/chinese-jfm/README.md
trunk/Master/texmf-dist/tex/luatex/chinese-jfm/jfm-ja_JP.lua
trunk/Master/texmf-dist/tex/luatex/chinese-jfm/jfm-zh_CN.lua
trunk/Master/texmf-dist/tex/luatex/chinese-jfm/jfm-zh_TW.lua
Added Paths:
-----------
trunk/Master/texmf-dist/doc/luatex/chinese-jfm/doc.pdf
trunk/Master/texmf-dist/doc/luatex/chinese-jfm/doc.tex
Modified: trunk/Master/texmf-dist/doc/luatex/chinese-jfm/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/chinese-jfm/README.md 2020-12-25 22:04:08 UTC (rev 57226)
+++ trunk/Master/texmf-dist/doc/luatex/chinese-jfm/README.md 2020-12-25 22:04:27 UTC (rev 57227)
@@ -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`
+* v1.0.0
- 最基础的三种特性，即「全角」「半角」与「开明」。此三特性**必须**选择其中一种。
+First published to CTAN.
-* `vert`
+* v1.0.1
- 直排特性，在直排时必须使用。
+Update documentation.
-* `hwcl`
-
- 半宽冒号特性，仅 zh_CN 拥有，必须在直排下使用。适用于部分竖排时冒号只占半宽的字体。
-
-* `prop`
-
- 比例宽度特性，仅 ja_JP 拥有。适用于日文的比例假名字体。
-
-## 挤压顺序
-
-JFM 文件中同时增加了 `priority` 的设置，配合 luatexja-adjust 包，可以进行有优先顺序的标点挤压。挤压顺序如下：
-
-* 最优先挤压引号、括号前后与间隔号两边的空格；
-
-* 其次挤压顿号、逗号、冒号、分号后的空格；
-
-* 最后挤压句号、问号、叹号后的空格。
-
-* 如果进行上述挤压后，仍无法达到行长要求，最后才会进行字间字距调整。
-
-\**注：以上对标点空白的描述是针对于简体中文的。对于标点置中的繁体中文，以上调整顺序仍然适用。但此时除括号外，可调整的空白变为标点两边的空白。全宽标点无空白可调整的，不作调整。*
-
-以上挤压规则是针对于全角风格的标点调整。对于半角与开明这种标点风格，若以「挤压」理解，顺序仍相同，但直观性就有所欠缺。事实上，JFM 文件中的标点是沿袭铅字与 InDesign 的习惯，认为标点只占半宽，全宽标点是半宽标点加上半宽空格的结果。因此上述规则在半宽标点的前提下应描述为：
-
-* 最先给句号、问号、叹号插空；
-
-* 其次添加顿号、逗号、冒号、分号后空格；
-
-* 最后调整引号、括号前后与间隔号两边的空格；
-
-* 如果进行上述调整后，仍无法达到行长要求，最后才会进行字间字距调整。
-
-「加法式」的标点调整，更加直观，也更容易理解。
-
-## 修改说明
-
-* v1.0.0
-
- 初次发布至 CTAN。
+---
+Copyright (C) 2020 ListLee.
Added: trunk/Master/texmf-dist/doc/luatex/chinese-jfm/doc.pdf
===================================================================
(Binary files differ)
Index: trunk/Master/texmf-dist/doc/luatex/chinese-jfm/doc.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/chinese-jfm/doc.pdf 2020-12-25 22:04:08 UTC (rev 57226)
+++ trunk/Master/texmf-dist/doc/luatex/chinese-jfm/doc.pdf 2020-12-25 22:04:27 UTC (rev 57227)
Property changes on: trunk/Master/texmf-dist/doc/luatex/chinese-jfm/doc.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/luatex/chinese-jfm/doc.tex
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/chinese-jfm/doc.tex (rev 0)
+++ trunk/Master/texmf-dist/doc/luatex/chinese-jfm/doc.tex 2020-12-25 22:04:27 UTC (rev 57227)
@@ -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
Property changes on: trunk/Master/texmf-dist/doc/luatex/chinese-jfm/doc.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/Master/texmf-dist/tex/luatex/chinese-jfm/jfm-ja_JP.lua
===================================================================
--- trunk/Master/texmf-dist/tex/luatex/chinese-jfm/jfm-ja_JP.lua 2020-12-25 22:04:08 UTC (rev 57226)
+++ trunk/Master/texmf-dist/tex/luatex/chinese-jfm/jfm-ja_JP.lua 2020-12-25 22:04:27 UTC (rev 57227)
@@ -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
Modified: trunk/Master/texmf-dist/tex/luatex/chinese-jfm/jfm-zh_CN.lua
===================================================================
--- trunk/Master/texmf-dist/tex/luatex/chinese-jfm/jfm-zh_CN.lua 2020-12-25 22:04:08 UTC (rev 57226)
+++ trunk/Master/texmf-dist/tex/luatex/chinese-jfm/jfm-zh_CN.lua 2020-12-25 22:04:27 UTC (rev 57227)
@@ -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
Modified: trunk/Master/texmf-dist/tex/luatex/chinese-jfm/jfm-zh_TW.lua
===================================================================
--- trunk/Master/texmf-dist/tex/luatex/chinese-jfm/jfm-zh_TW.lua 2020-12-25 22:04:08 UTC (rev 57226)
+++ trunk/Master/texmf-dist/tex/luatex/chinese-jfm/jfm-zh_TW.lua 2020-12-25 22:04:27 UTC (rev 57227)
@@ -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
More information about the tex-live-commits
mailing list.