summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-04-26 19:29:29 +0000
committerKarl Berry <karl@freefriends.org>2023-04-26 19:29:29 +0000
commit5b93ed43d5e09c815010991673125162506b6de6 (patch)
tree2bc5df8d915138e4507258e93f8ecd15516de8df /Master/texmf-dist/doc
parent9d439868641e399253428dc392b5b5e87e3eb4a2 (diff)
evangelion-jfm (26apr23)
git-svn-id: svn://tug.org/texlive/trunk@66945 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-en.pdfbin234048 -> 239244 bytes
-rw-r--r--Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-en.tex11
-rw-r--r--Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-jp.pdfbin0 -> 330720 bytes
-rw-r--r--Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-jp.tex228
-rw-r--r--Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-sc.pdfbin307743 -> 324356 bytes
-rw-r--r--Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-sc.tex9
-rw-r--r--Master/texmf-dist/doc/luatex/evangelion-jfm/README.md49
-rw-r--r--Master/texmf-dist/doc/luatex/evangelion-jfm/make.sh5
8 files changed, 273 insertions, 29 deletions
diff --git a/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-en.pdf b/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-en.pdf
index ff786568507..2d5f69eee70 100644
--- a/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-en.pdf
+++ b/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-en.tex b/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-en.tex
index 6f82d3dec00..ab2f9842bdd 100644
--- a/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-en.tex
+++ b/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-en.tex
@@ -67,7 +67,7 @@ The sourcefiles are hosted on Github while it's also uploaded to CTAN. Users can
mkdir Evangelion-JFM [&&] cd Evangelion-JFM
git clone https://github.com/RadioNoiseE/Evangelion-JFM
\end{lstlisting}
-to extract the latest version, the move it to the \texttt{TEXMF} directory, for instance
+to extract the latest version, then move it to the \texttt{TEXMF} directory, for instance
\begin{lstlisting}
~/Library/texlive/2023/texmf-dist/tex/luatex/eva-jfm
\end{lstlisting}
@@ -93,6 +93,7 @@ while under {\LaTeX} the most common case while using \texttt{\string\setmainjfo
\begin{lstlisting}
\setmainjfont{§\meta{font name}§}[Language = §\meta{language name}§, §\meta{dir}§ = {JFM = §\meta{JFM name}§/{§\meta{JFM features}§}}]
\end{lstlisting}
+オプションの\meta{font name}は、文書のメインフォントとして指定したいフォントの名前です。日本語のフォントを使用する場合、\meta{language name}は自動的に\LuaTeX-jaによって補完されるため、無視してください。この場合、伝統的な中国語フォントには\texttt{Chinese Traditional}、簡体字中国語フォントには\texttt{Chinese Simplified}を指定する必要があります(これを指定しないと、出力が間違った細部、例えば句読点の形状と方向が変わってしまう可能性があります)。\meta{dir}は、縦書きの場合は\meta{TateFeatures}、横書きの場合は\texttt{YokoFeatures}に設定します。JFMの名前は\meta{JFM features}オプションで指定します\footnote{\LuaTeX-jaは\texttt{jfm-\meta{JFM name}.lua}という方法でJFMファイルを検索します。}。最後に、\meta{JFM features}キーにJFMの特徴を入力してください。これらは、セクション\ref{sec:feat}で説明されています。
Option \meta{font name} is the font (that you'd like to specify as the main font for your document)'s name. When using Japanese fonts, simply ignore the \meta{language name} since \LuaTeX-ja will automatically fill it for you. In this case, filling \texttt{Chinese} \texttt{Traditional} for Traditional Chinese fonts and \texttt{Chinese} \texttt{Simplified} for Simplified Chinese fonts is necessary\footnote{Without this, your output may result in wrong details, for instance wrong punctuation shape \& direction.}. \meta{dir} should be \texttt{TateFeatures} when typeset vertically and \texttt{YokoFeatures} for typesetting horizontally accordingly. The JFM's name is specified by the \meta{JFM name} option\footnote{\LuaTeX-ja searchs for a JFM file following the method \texttt{jfm-\meta{JFM name}.lua}.}. Finally, for the \meta{JFM features} key, fill in the JFM features. They are described in section \ref{sec:feat}.\par
For advanced users, it's also recommanded to use the following
\begin{lstlisting}
@@ -114,7 +115,7 @@ You should specify one and only one feature from this section, or your {\TeX} is
Traditional Chinese feature. You should specify this when you are typesetting using Traditional Chinese fonts. The differences from the other two is because of its middle-placed punctuations. Hence the glues inserted next to it, the line-end adjust, as well as some kernings between punctuations are special.
}
\feature{smpl}{SiMPLified chinese}{%
- Simplified Chinese feature, for Simplified Chinese fonts. All the punctuations are laid down and placed aside. Therefore its position is treated with care. \textsf{Eva-JFM} also takes some rare conditions into consideration. Note that the \textit{aki\/} after Question Mark and Exclamation Mark is different from that of the Japanese font feature.
+ Simplified Chinese feature, for Simplified Chinese fonts. Almost all the punctuations are laid down and placed aside. Therefore its position is treated with care. \textsf{Eva-JFM} also takes some rare conditions into consideration. Note that the \textit{aki\/} after Question Mark and Exclamation Mark is different from that of the Japanese font feature.
}
\subsection{Direction Features}
@@ -138,7 +139,7 @@ Except the feature \texttt{hgp} doesn't rely on feature \texttt{vert}, all the o
\subsection{English Features}
You need to set the JAchar range using \texttt{\string\ltjsetparameter} before using features in this section, or they won't work properly. It's also recommended to use with the corresponding OpenType features.\par
\feature{hwid}{Half WIDth}{%
- Half width English characters feature. This will place each alphabets into a box which width is exactly $0.5$ times the CJ character's width. It's worth noting that it will not stretch or shrink the glyph, it only adjusts the spacing. Hence if the OpenType feature \texttt{hwid} is not set, English characters will simply overlap. All the kernings and italic corrections will also be lost (this may be fixed in the future versions), and will ignore the parameter \texttt{xkanjiskip}. Please use with care.
+ Half width English characters feature. This will place each alphabets into a box which width is exactly 0.5 times the CJ character's width. It's worth noting that it will not stretch or shrink the glyph, it only adjusts the spacing. Hence if the OpenType feature \texttt{hwid} is not set, English characters will simply overlap. All the kernings and italic corrections will also be lost (this may be fixed in the future versions), and will ignore the parameter \texttt{xkanjiskip}. Please use with care.
}
\feature{fwid}{Full WIDth}{%
Full width English characters feature. It's similar from feature \texttt{hwid} above except that the spacing will be stretched out on the contrary.
@@ -199,7 +200,7 @@ After installing that font, you can use the \texttt{AltFont} key provided by \Lu
}
]{§\meta{main font}§}
\end{lstlisting}
-One of \texttt{Japanese}, \texttt{Chinese Traditional} or \texttt{Chinese Simplified} should be filled in the first \meta{language} option, the other one is for the corresponding JFM features. \meta{utf-8 code} selects the punctuations you'd like to replace with the ``punctuation font''\footnote{You can search \url{https://www.unicode.org/charts/unihanrsindex.html} for their unicodes representations.}.
+One of \texttt{Japanese}, \texttt{Chinese} \texttt{Traditional} or \texttt{Chinese} \texttt{Simplified} should be filled in the first \meta{language} option, the other one is for the corresponding JFM features. \meta{utf-8 code} selects the punctuations you'd like to replace with the ``punctuation font''\footnote{You can search \url{https://www.unicode.org/charts/unihanrsindex.html} for their unicodes representations.}.
Finally, it's obvious that the \meta{symbol font} and the \meta{main font} options are for the ``punctuation font'' and the main font.\par
It's also recommended for the developers to use the NFSS with
\begin{lstlisting}
@@ -219,7 +220,7 @@ This JFM's name comes from the animation \textit{Neon Genesis Evangelion\/} by H
\bibitem{unicode} The Unicode Consortium. \newblock The Unicode Standard Version 15.0 - Core Specification, 2022.
\bibitem{tex-by-topic} Victor Eijkhout. \newblock \TeX{} by Topic, A \TeX nician's Reference, Addison-Wesley, 1992.
\bibitem{min10} 乙部厳己. \newblock min10フォントについて. \newblock \url{http://argent.shinshu-u.ac.jp/~otobe/tex/files/min10.pdf}.
- \bibitem{ltxjlreq} Noriyuki Abe. \newblock Jlreq Document Class, 2022. \newblock \url{https://github.com/abenori/jlreq}.
+ \bibitem{ltxjlreq} 阿部紀行. \newblock Jlreq Document Class, 2022. \newblock \url{https://github.com/abenori/jlreq}.
\bibitem{evang} 庵野秀明. \newblock 新世紀エヴァンゲリオン.
\end{thebibliography}
diff --git a/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-jp.pdf b/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-jp.pdf
new file mode 100644
index 00000000000..6904c4cb63f
--- /dev/null
+++ b/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-jp.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-jp.tex b/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-jp.tex
new file mode 100644
index 00000000000..79481b2f3d6
--- /dev/null
+++ b/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-jp.tex
@@ -0,0 +1,228 @@
+%! TeX Program = LuaLaTeX
+\makeatletter
+\def\ltj@stdyokojfm{eva/{jp,nstd}}
+\makeatother
+\documentclass[twoside]{ltjsarticle}
+\usepackage{graphicx}
+\usepackage[hiragino-pron, match,deluxe]{luatexja-preset}
+\setmainfont{Linux Libertine O}
+\setsansfont{Linux Biolinum O}
+\setmonofont[Scale = MatchLowercase, FakeStretch = 1.137121]{Iosevka Slab}
+\usepackage{luatexja-adjust}
+\ltjenableadjust[priority = true]
+\usepackage{listings}
+\lstset{
+ basicstyle = \ttfamily\small,
+ breaklines = true,
+ columns = fullflexible,
+ keepspaces = true,
+ numbers = left,
+ numberstyle = \tiny,
+ stepnumber = 1,
+ gobble = 4,
+ numbersep = 6pt,
+ escapechar = §
+}
+\usepackage{hyperref}
+\hypersetup{
+ hidelinks,
+ pdftitle = {Evangelion-JFM},
+ pdfauthor = {黄京},
+ pdfsubject = {TeX},
+ pdfkeywords = {Japanese Font Metric},
+ pdfstartview = FitV
+}
+\long\def\feature#1#2#3{{\vskip8pt\vbox{\normalsize\parindent=\zw\hangindent=2\zw\texttt{#1 --> ({\itshape #2\/})}\\\indent#3\par}}}
+\def\meta#1{{\normalfont\rmfamily\itshape$\langle$#1\/$\rangle$}}
+\def\空{\quad}
+\def\段{\par}
+\def\LuaTeX{Lua\kern-.2ex\TeX}
+\def\pTeX{p\kern-.2ex\TeX}
+\def\pdfTeX{pdf\TeX}
+\title{\sffamily\bfseries Evangelion Japanese Font Metric for \LuaTeX}
+\author{\large \url{https://github.com/RadioNoiseE/Evangelion-JFM}\\\url{https://www.ctan.org/pkg/evangelion-jfm}}
+\date{\西暦\today\quad{}黄京}
+\begin{document}
+\lstset{doubleletterspace = true}
+\maketitle
+
+\begin{abstract}
+ 本ドキュメントは、高品質な中国語および日本語のドキュメントを組版するための日本語フォントメトリック「Evangelion Japanese Font Metric(以下「Eva-JFM」とする)」を紹介するものです。このメトリックは、縦書きと横書きの両方のテキストに対して、従来の中国語、簡体字中国語、および日本語のフォントとともに使用できます。これは、\LuaTeX-ja で提供される優先機能を最大限に活用するフォントメトリックを提供し、標準\cite{jlreq}に基づき、一部の高度な(すなわち、めったに使用されない)機能をサポートすることを目的としています。\段
+ 本ドキュメントは、完全なものではありません。文法的な(および文脈的な)エラーが多数含まれている可能性があります。
+\end{abstract}
+
+\section{背景情報と簡単な紹介}
+{\TeX}は「美しい本の制作」を目的とした強力な組版システムであり、英語ベースのテキストの組版には完全に対応しています。しかし、CJテキストのサポートは限られています\footnote{おそらく普遍的に認められたCJ文字セット標準やエンコーディングシステムが存在しなかったためかもしれません}。{\TeX}でCJテキストを扱うために、マクロ拡張(\textsf{CJK}など)やエンジン拡張が開発されました。最も影響力のあるものの1つが{\pTeX}(シリーズ)です。\段
+{\pTeX}は仮想フォント方式を使用し、TrueTypeやOpenTypeフォントを\texttt{TFM/VF}ファイルを使ってマッピングします。マクロを介したフォント設定には対応せず、PDF形式の出力にも対応していません。その利点は、伝統的な日本語のタイポグラフィレイアウト要件を扱うための証明済みの能力にあります。
+{\pdfTeX}は、PDFファイルを直接出力できる{\TeX}エンジンの拡張です(その名の通り)。ただし、Unicodeや現代のフォント形式(TrueTypeやOpenTypeベクターフォント形式)に対するサポートは限定的です。\段
+{\LuaTeX}は{\pdfTeX}をベースにしています。Luaの組み込みにより、読み込みモジュールを使用してUnicodeをサポートし、\textsf{fontloader}を使用して現代のフォントをサポートすることができます。マクロベースのフォント設定機能は\textsf{luaotfload}によって提供されます。\段
+\LuaTeX-jaは{\pTeX}と{\LuaTeX}の移植版と見なすことができます。{\LuaTeX}を使用する場合、マクロによるフォント設定がサポートされるため、{\pTeX}の\texttt{VF}ファイルを保持する必要はありません。しかし、一部の高度な機能(「優先度」機能や仮想的な文字など)は、いわゆるJFMファイルで残され、拡張されました。\段
+このドキュメントでは、高度なJFMファイルである\textsf{Eva-JFM}を説明します。{\LuaTeX}のコールバックを使用して、\texttt{Eva-JFM.lua}にCJテキスト組版に必要な機能を埋め込みます(おそらく)。現在サポートされている機能は、「繁体字中国語」、「簡体字中国語」、「日本語」、「縦組」、「ぶら下げ」、「行間句読点」、「全角歐文」、「半角歐文」、「非標準」。\段
+
+\section{インストールとローカル設定}
+ソースファイルはGithubにホストされ、CTANにもアップロードされています。ユーザーは単純に
+\begin{lstlisting}
+ tlmgr install evangelion-jfm
+\end{lstlisting}
+(または他のパッケージマネージャーを使用することもできます)を使用してインストールできます。ただし、CTANブランチが常に更新されているわけではないことに注意してください。 開発者はまた
+\begin{lstlisting}
+ mkdir Evangelion-JFM [&&] cd Evangelion-JFM
+ git clone https://github.com/RadioNoiseE/Evangelion-JFM
+\end{lstlisting}
+を使用して最新バージョンを抽出し、それを\texttt{TEXMF}ディレクトリに移動することもできます。たとえば
+\begin{lstlisting}
+ ~/Library/texlive/2023/texmf-dist/tex/luatex/eva-jfm
+\end{lstlisting}
+あなたの{\TeX}配布が\texttt{Ls-R}データベースを更新するためにを
+\begin{lstlisting}
+ mktexlsr
+\end{lstlisting}
+を必要とする場合は、それを実行してください。\段
+\textsf{Eva-JFM}はほとんどの場合、ローカル設定を必要としませんが、特別な要件がある場合は、セクション\ref{sec:config}を参照してください。
+
+\section{使用}
+\begin{lstlisting}
+ \usepackage{luatexja-fontspec, luatexja-adjust}
+ \setmainjfont{Source Han Serif TC}[Language = Chinese Traditional, TateFeatures = {JFM = eva/{vert, trad, nstd}}]
+ \ltjenableadjust[priority = true]
+\end{lstlisting}
+\indent 上記は、縦書きの伝統的な中国語フォントを使用して縦書きのテキストを組版する例です。注意が必要ですが、縦書きのテキストをサポートするドキュメントクラスを読み込むか、\texttt{\string\tate}コマンドを使用する必要があります。\LuaTeX-jaのJFM構文は、次のようになります。
+\begin{lstlisting}
+ jfm = §\meta{JFM name}§/{§\meta{JFM features}§}
+\end{lstlisting}
+{\LaTeX}の場合、\texttt{\string\setmainjfont}を使用する場合、最も一般的なケースは、以下のようになります
+\begin{lstlisting}
+ \setmainjfont{§\meta{font name}§}[Language = §\meta{language name}§, §\meta{dir}§ = {JFM = §\meta{JFM name}§/{§\meta{JFM features}§}}]
+\end{lstlisting}
+オプションの\meta{font name}は、文書のメインフォントとして指定したいフォントの名前です。日本語のフォントを使用する場合、\meta{language name}は自動的に\LuaTeX-jaによって補完されるため、無視してください。この場合、伝統的な中国語フォントには\texttt{Chinese Traditional}、簡体字中国語フォントには\texttt{Chinese Simplified}を指定する必要があります(これを指定しないと、出力が間違った細部、例えば句読点の形状と方向が変わってしまう可能性があります)。\meta{dir}は、縦書きの場合は\meta{TateFeatures}、横書きの場合は\texttt{YokoFeatures}に設定します。JFMの名前は\meta{JFM features}オプションで指定します\footnote{\LuaTeX-jaは\texttt{jfm-\meta{JFM name}.lua}という方法でJFMファイルを検索します。}。最後に、\meta{JFM features}キーにJFMの特徴を入力してください。これらは、セクション\ref{sec:feat}で説明されています。
+上級ユーザーの場合、以下を使用することをお勧めします
+\begin{lstlisting}
+ \def\ltj@stdyokojfm{eva/{§\meta{JFM features}§}}
+\end{lstlisting}
+またはNFSSを使用することもできます。\段
+他の場合でJFMを設定するには、\LuaTeX-jaのドキュメント\cite{luatexja-doc}を参照してください。
+
+\section{サポートされる機能}
+\label{sec:feat}
+このセクションでは、\texttt{Eva-JFM}に組み込まれたすべての機能を概観します。それらは5つのグループに分けられ、それぞれ次の5つのサブセクションで説明されています。
+
+\subsection{言語機能}
+このセクションから1つの機能を指定する必要があります。そうしない場合、{\TeX}はエラーを出します。\段
+\feature{jp}{JaPanese}{%
+ 日本語フォント機能。日本語フォントを使用する場合、この機能を指定する必要があります。伝統的な中国語と簡体字中国語の機能とは異なり、縦書き時に疑問符や感嘆符の後に挿入されるグルー、および句読点の位置が異なります。これは、\texttt{lgp}機能および内部グルーピングに影響します。
+}
+\feature{trad}{TRADitional chinese}{%
+ 伝統的な中国語機能。伝統的な中国語フォントを使用して組版する場合は、この機能を指定する必要があります。他の2つとの違いは、中央に配置された句読点です。そのため、それに隣接するグルー、行末の調整、および句読点間のカーニングは特別なものです。
+}
+\feature{smpl}{SiMPLified chinese}{%
+ 簡体字中国語機能。簡体字中国語フォント用です。すべての句読点は横に配置されています。したがって、その位置は注意して扱われます。\textsf{Eva-JFM}はいくつかの珍しい状況も考慮しています。なお、疑問符と感嘆符の後の空きは日本語フォント機能とは異なります。
+}
+
+\subsection{方向機能}
+このセクションの機能は、すべての他の機能と互換性があります。\段
+\feature{vert}{VERTical writing}{%
+ 縦組機能。カーニング、内部グルーピングなどに影響します。縦書き時には、これを指定する必要があります。
+}
+
+\subsection{拡張機能}
+ぶら下げ\texttt{hgp}機能を除くすべての機能は、\texttt{vert}機能に依存して動作します(縦書きテキストで必要なため)。\段
+\feature{extd}{EXTenDed font}{%
+ 拡張フォント機能。デフォルトの比率は、\textit{x\/}:\textit{y\/}=100:80で、\textit{x}は幅、\textit{y}は高さを表します。\texttt{extd=\meta{ratio}}(デフォルトの\meta{ratio}は1.25)を使用してカスタマイズできます。\texttt{extend}(\textsf{luaotfload})または\texttt{FakeStretch}(\textsf{fontspec})と。
+}
+\feature{lgp}{LineGap Punctuations}{%
+ ラインギャップの句読点機能。これは、いくつかの句読点をラインギャップに掛けます。\texttt{jp}機能で使用すると、いくつかの違いが発生します。詳細については、セクション\ref{sec:lgp}を参照してください。
+}
+\feature{hgp}{HanGing Punctuations}{%
+ 行末に句読点を「ハング」する句読点機能をぶら下げます(少し目立つようにする)。繁体字中国語フォント結果がやや(むしろ)奇妙であるため、この機能はサポートしていません。
+}
+
+\subsection{歐文機能}
+このセクションの機能を使用する前に、JAchar範囲を\texttt{\string\ltjsetparameter}で設定する必要があります。また、対応するOpenType機能と併用することが推奨されています。\段
+\feature{hwid}{Half WIDth}{%
+ 半角英語文字機能。各アルファベットをCJ文字の幅のちょうど0.5倍の箱に配置します。これはグリフを伸ばしたり縮めたりするわけではなく、スペーシングを調整するだけであることに注意してください。したがって、OpenType機能\texttt{hwid}が設定されていない場合、英語の文字は単に重なり合います。すべてのカーニングとイタリックの補正も失われます(これは将来のバージョンで修正されるかもしれません)、\texttt{xkanjiskip}パラメータは無視されます。注意して使用してください。
+}
+\feature{fwid}{Full WIDth}{%
+ 全角英語文字機能。スペーシングが逆に広がりますが、機能\texttt{hwid}と同様です。
+}
+
+\subsection{ダーク機能}
+以下の機能を使用する前に、説明を注意深く読んでください。\段
+\feature{nstd}{Non STandarD}{%
+ この機能は、句読点のカーニングに対する標準的な優先ルールを無視します。日本語のテキストレイアウト要件\cite{jlreq}では、ピリオドの優先度がカンマよりも高いとされているため(つまり、ピリオドは伸ばしやすい)、この機能によってカンマの優先度がピリオドよりも高くなります。\textsf{luatexja-adjust}の\texttt{priority}機能が有効になっている場合にのみ機能します(\texttt{true}に設定)。
+}
+
+\section{行間句読点機能}
+\label{sec:lgp}
+ここでは、行間句読点に関する詳細な情報、発生する可能性のある問題、および解決策が提供されます。
+\subsection{「垂直懸垂」とは}
+垂直懸垂は、中国の古典的な書籍に見られる、句読点と伝統的な縦書き組版方法を組み合わせたものである。\段
+\textsf{Eva-JFM}では、ピリオドとカンマだけが懸垂されますが、\texttt{Eva-JFM}ではコロンとセミコロンの向きのため、これらの文字は懸垂できません。日本語フォントにはこの点に関して異なる特徴があります。\段
+これらの文字は、グリフの下右に懸垂されます。詳細については次のサブセクションを参照してください。
+
+\subsection{懸垂位置}
+\begin{figure}[htb]
+ \centering
+ \includegraphics[height = 12\zh]{figure/fig-tc.pdf}\空\includegraphics[height = 12\zh]{figure/fig-jp.pdf}
+ \caption{垂直懸垂の機能}
+ \label{fig:lgp}
+\end{figure}
+図\ref{fig:lgp}~に示すように、これらの懸垂句読点の位置は、以下のルールに従って決定されます。カスタマイズについては、サブセクション\ref{sec:config}を参照してください。ルールの優先順位は早い順に高くなります。
+\begin{itemize}
+ \item 3つのフォントのスタイルは統一されています;
+ \item 異なる句読点における同じ要素の位置は同じであるべきです;
+ \item 句読点のグリフは漢字の境界に接触するべきです;
+ \item 異なる句読点の位置は、それぞれのグリフの形状、サイズ、デザインに応じて異なる場合があります。
+\end{itemize}
+
+\subsection{ユーザー設定}
+\label{sec:config}
+この機能はSource Hanフォントシリーズ(思源系列)に設計されています。異なるフォントによって異なる句読点があるため、出力が誤った結果になる可能性があります(オーバーラップ、揃っていないなど)。そのため、懸垂句読点の位置をカスタマイズするための2つの方法が提供されています。
+
+\subsubsection{パラメータの変更}
+\texttt{Eva-JFM}では、これらの懸垂句読点の位置に関するパラメータを含むテーブルは以下のようになります
+\begin{lstlisting}
+ [101,2] ==> [1]; [201,2] ==> [2]; [301,2] ==> [3].
+\end{lstlisting}
+上下のパラメータを調整して、出力を修正してください。
+また、最後のセクション『実装』も参照してください。
+
+\subsubsection{追加フォントの使用}
+句読点のグリフを抽出して、新しいフォントにパッケージ化し、後で行頭の句読点に使用することが、2番目の解決策です(\textit{Fontforge\/}などのプログラムを使用できます)。また、句読点だけのために別のフォントをロードすることもできますが、CJフォントを{\TeX}のメモリにロードするコストは高くなります。\段
+このフォントをインストールした後、\LuaTeX-jaで提供される\texttt{AltFont}キーを使用して、句読点を置き換えることができます。実際のコードは上記に示されています:
+\begin{lstlisting}
+ \setmainjfont[
+ Language = §\meta{language}§,
+ TateFeatures = {
+ JFM = eva/{vert, lgp, §\meta{language}§},
+ AltFont = {
+ {Range = "§\meta{utf-8 code}§, Font = §\meta{symbol font}§}
+ }
+ }
+ ]{§\meta{main font}§}
+\end{lstlisting}
+最初の\meta{language}オプションには、日本語、繁体字中国語、簡体字中国語のいずれかを入力し、もう一方は対応するJFMの機能のためのものです。 \meta{utf-8 code}は、置き換えたい句読点を「句読点フォント」で選択します\footnote{Unicodeのコードポイントは\url{https://www.unicode.org/charts/unihanrsindex.html}で確認できます。}。最後に、\meta{symbol font}と\meta{main font}オプションは、「句読点フォント」とメインフォントのためのものであることが明らかです。\段
+開発者は、以下のように NFSS を使用することを推奨します
+\begin{lstlisting}
+ \DeclareAlternateKanjiFont{§\meta{base encoding}§}{§\meta{base family}§}{§\meta{base series}§}{§\meta{base shape}§}{§\meta{alt encoding}§}{§\meta{alt family}§}{§\meta{alt series}§}{§\meta{alt shape}§}{§\meta{range}§}
+\end{lstlisting}
+オプション\meta{base}と\meta{alt}は、メインフォントと「句読点フォント」のためのものです。\段
+詳しい構文や使用方法、例については、\LuaTeX-jaのドキュメント\cite{luatexja-doc}を参照してください。
+
+\section{インスピレーション}
+\textsf{Eva-JFM}の内部グループ化は、\texttt{min10.tfm}~\cite{min10}に触発されています。また、優先度の特徴のデータは、阿部紀行氏の\texttt{jlreq.lua}~\cite{ltxjlreq}から一部引用しています。\段
+このJFMの名前は、庵野秀明氏のアニメーション『新世紀エヴァンゲリオン』。
+
+\begin{thebibliography}{9}
+ \addcontentsline{toc}{section}{\refname}
+ \bibitem{jlreq} W3C Japanese Layout Task Force~(ed). \newblock Requirements for Japanese Text Layout (W3C Working Group Note), 2022, 2023. \newblock \url{https://www.w3.org/TR/jlreq/}.
+ \bibitem{luatexja-doc} \LuaTeX-jaプロジェクトチーム. \newblock \LuaTeX-jaパッケージ, 2022, 2023.
+ \bibitem{unicode} The Unicode Consortium. \newblock The Unicode Standard Version 15.0 - Core Specification, 2022.
+ \bibitem{tex-by-topic} Victor Eijkhout. \newblock \TeX{} by Topic, A \TeX nician's Reference, Addison-Wesley, 1992.
+ \bibitem{min10} 乙部厳己. \newblock min10フォントについて. \newblock \url{http://argent.shinshu-u.ac.jp/~otobe/tex/files/min10.pdf}.
+ \bibitem{ltxjlreq} 阿部紀行. \newblock Jlreq Document Class, 2022. \newblock \url{https://github.com/abenori/jlreq}.
+ \bibitem{evang} 庵野秀明. \newblock 新世紀エヴァンゲリオン.
+\end{thebibliography}
+
+\lstinputlisting{jfm-eva.lua}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-sc.pdf b/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-sc.pdf
index 7a442b0740f..69db69322e4 100644
--- a/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-sc.pdf
+++ b/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-sc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-sc.tex b/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-sc.tex
index 8ad235d27b1..f77e0c6e866 100644
--- a/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-sc.tex
+++ b/Master/texmf-dist/doc/luatex/evangelion-jfm/Eva-JFM_doc-sc.tex
@@ -49,7 +49,7 @@
\maketitle
\begin{abstract}
- 本文档将介绍名为Evangelion Japanese Font Metric(下简称为``\textsf{Eva-JFM}'')的JFM文件。其适用于简体中文(以下简称为「简中」)、繁体中文(以下简称为「繁中」)及日文字体的横直排。旨在提供一个充分利用\LuaTeX{}-ja的\texttt{priority}特性,基于标准\cite{jlreq}的同时,支持一些罕用特性的JFM文件。文档暂使用中文及西文撰写。
+ 本文档将介绍名为Evangelion Japanese Font Metric(下简称为``\textsf{Eva-JFM}'')的JFM文件。其适用于简体中文(以下简称为「简中」)、繁体中文(以下简称为「繁中」)及日文字体的横直排。旨在提供一个充分利用\LuaTeX-ja的\texttt{priority}特性,基于标准\cite{jlreq}的同时,支持一些罕用特性的JFM文件。文档暂使用中文及西文撰写。
\end{abstract}
\section{背景及略介}
@@ -97,6 +97,7 @@
\setmainjfont{§\meta{font name}§}[Language = §\meta{language name}§, §\meta{dir}§ = {JFM = §\meta{JFM name}§/{§\meta{JFM features}§}}]
\end{lstlisting}
其中,\meta{font name}自然为需要的字体名称。\meta{language name}在使用日文字体时可忽略,而使用简中、繁中字体时为必填\footnote{简中填\texttt{Chinese Simplified},繁中填\texttt{Chinese Traditional}即可。},因\LuaTeX-ja会默认将其覆盖为\texttt{Japanese}选项,而这会带来灾难性的后果\footnote{比如错误的标点位置:日文为冒号及分号中置、其余偏靠,简中是全部偏靠,而繁中则是统统中置。}。\meta{dir}选填\texttt{TateFeatures}(直书)或\texttt{YokoFeatures}(横书)。其后的\meta{JFM name}为调用JFM的文件名\footnote{\LuaTeX-ja会依\texttt{jfm-\meta{JFM name}.lua}的格式来查找该文件。}。最后的\meta{JFM features}选项为选择使用的JFM特性,详细请看第\ref{sec:feat}章。\段
+オプションの\meta{font name}は、文書のメインフォントとして指定したいフォントの名前です。日本語のフォントを使用する場合、\meta{language name}は自動的に\LuaTeX-jaによって補完されるため、無視してください。この場合、伝統的な中国語フォントには\texttt{Chinese Traditional}、簡体字中国語フォントには\texttt{Chinese Simplified}を指定する必要があります(これを指定しないと、出力が間違った細部、例えば句読点の形状と方向が変わってしまう可能性があります)。\meta{dir}は、縦書きの場合は\meta{TateFeatures}、横書きの場合は\texttt{YokoFeatures}に設定します。JFMの名前は\meta{JFM features}オプションで指定します\footnote{\LuaTeX-jaは\texttt{jfm-\meta{JFM name}.lua}という方法でJFMファイルを検索します。}。最後に、\meta{JFM features}キーにJFMの特徴を入力してください。これらは、セクション\ref{sec:feat}で説明されています。
对于进阶用户,也推荐用
\begin{lstlisting}
\def\ltj@stdyokojfm{eva/{§\meta{JFM features}§}}
@@ -197,7 +198,7 @@
具体可参照终章。
\subsubsection{使用外掛符號字體}
-该方法的原理就是使用特殊的仅包含(标点)符号的字体来替换原有字体中的标点符号,从而稳定其表现。可使用字体熔炉等工具将标点符号从整套字体中提取出来并封装为新字体,也可使用开源符号字体。\段
+该方法的原理就是使用特殊的仅包含(标点)符号的字体来替换原有字体中的标点符号,从而稳定其表现。可使用字体煉炉等工具将标点符号从整套字体中提取出来并封装为新字体,也可使用开源符号字体。\段
将其放入\texttt{TEXMF}并更新\texttt{Ls-R}文件后即可使用\LuaTeX-ja提供的\texttt{AltFont}键进行替换,例元:
\begin{lstlisting}
\setmainjfont[
@@ -220,7 +221,7 @@
具体语法及示例可看\LuaTeX-ja文档\cite{luatexja-doc}。
\section{启發}
-\textsf{Eva-JFM}的内部分组受\texttt{min10.tfm} \cite{min10}的启发,支持的\texttt{priority}特性则取自阿部紀行氏的\texttt{jlreq.lua} \cite{ltxjlreq}文件。其余可见参考文献。\段
+\textsf{Eva-JFM}的内部分组受\texttt{min10.tfm}~\cite{min10}的启发,支持的\texttt{priority}特性则取自阿部紀行氏的\texttt{jlreq.lua}~\cite{ltxjlreq}文件。其余可见参考文献。\段
本JFM的名字来源于庵野秀明的『新世紀エヴァンゲリオン』。
\begin{thebibliography}{9}
@@ -230,7 +231,7 @@
\bibitem{unicode} The Unicode Consortium. \newblock The Unicode Standard Version 15.0 - Core Specification, 2022.
\bibitem{tex-by-topic} Victor Eijkhout. \newblock \TeX{} by Topic, A \TeX nician's Reference, Addison-Wesley, 1992.
\bibitem{min10} 乙部厳己. \newblock min10フォントについて. \newblock \url{http://argent.shinshu-u.ac.jp/~otobe/tex/files/min10.pdf}.
- \bibitem{ltxjlreq} Noriyuki Abe. \newblock Jlreq Document Class, 2022. \newblock \url{https://github.com/abenori/jlreq}.
+ \bibitem{ltxjlreq} 阿部紀行. \newblock Jlreq Document Class, 2022. \newblock \url{https://github.com/abenori/jlreq}.
\bibitem{evang} 庵野秀明. \newblock 新世紀エヴァンゲリオン.
\end{thebibliography}
diff --git a/Master/texmf-dist/doc/luatex/evangelion-jfm/README.md b/Master/texmf-dist/doc/luatex/evangelion-jfm/README.md
index a97615430d9..4f60a8fb360 100644
--- a/Master/texmf-dist/doc/luatex/evangelion-jfm/README.md
+++ b/Master/texmf-dist/doc/luatex/evangelion-jfm/README.md
@@ -1,6 +1,6 @@
# Evangelion Japanese Font Metric
-## 简介 Some Information
+## 简介・簡単な紹介・Some Information
`Eva-JFM`是一个为在LuaTeX-ja下使用行间标点、压缩字体等特性设计的JFM文件。其可用于简中、繁中、日文字体,充分利用priority特性(数据来源jlreq),支持直书,同时为繁体字体进行优化(如行末、与直角引号之间等)。
@@ -8,39 +8,49 @@
本项目已上传至[CTAN](https://www.ctan.org/pkg/evangelion-jfm)。
-`Eva-JFM` is a JFM file which aims to support 'linegap puncutations', 'scaled font' and more features under LuaTeX-ja. It can be used with Traditional Chinese, Simplified Chinese and Japanese fonts, supporting vertical typesetting, making full-use of the `priority` feature, and added special support for Traditional Chinese font. It's based on jlreq, and insipered by `min10.tfm`. All its nine features are embeded into single file `jfm-eva.lua` to simplify the using.
+このメトリッ クは、縦書きと横書きの両方のテキストに対して、従来の中国語、簡体字中国語、および日本語のフォント とともに使用できます。これは、LuaTeX-jaで提供される優先機能を最大限に活用するフォントメトリックを提供し、標準に基づき、一部の高度な(すなわち、めったに使用されない)機能をサポートすること を目的としています。
-For more datails please see the [English documentation](Eva-JFM_doc-en.pdf).
+より多くの情報は[ドキュメント](Eva-JFM_doc-jp.pdf)を見てください。
+
+それは[CTAN](https://www.ctan.oeg/pkg/evangelion-jfm)にアップロードされました。
-The Japanese documentation is still in progress.
+`Eva-JFM` is a JFM file which aims to support 'linegap puncutations', 'scaled font' and more features under LuaTeX-ja. It can be used with Traditional Chinese, Simplified Chinese and Japanese fonts, supporting vertical typesetting, making full-use of the `priority` feature, and added special support for Traditional Chinese font. It's based on jlreq, and insipered by `min10.tfm`. All its nine features are embeded into one single file `jfm-eva.lua` to simplify the using.
+
+For more datails please see the [English documentation](Eva-JFM_doc-en.pdf).
This package is also available on [CTAN](https://www.ctan.org/pkg/evangelion-jfm).
-## 支持特性 Supported Features
+## 支持特性・サポート機能・Supported Features
-- 行间标点 Linegap Punctuations
+- 行间标点 行間句読点 Linegap Punctuations
-- 标点悬挂 Hanging Punctuations
+- 标点悬挂 ぶら下げ Hanging Punctuations
-- 简体中文 Simplified Chinese
+- 简体中文 簡体字中國語 Simplified Chinese
-- 繁体中文 Traditional Chinese
+- 繁体中文 繁体字中国語 Traditional Chinese
-- 日本语 Japanese
+- 日本语 日本語 Japanese
-- 直书 Vertical Typesetting
+- 直书 縱組 Vertical Typesetting
-- 半宽西文 Half-width Alphabets
+- 半宽西文 半角歐文 Half-width Alphabets
-- 全宽西文 Full-width Alphabets
+- 全宽西文 全角歐文 Full-width Alphabets
-- 忽略标准 Non-standard
+- 忽略标准 非標準 Non-standard
-## 状态 Current Version
+## 状态・現在のバージョン・Current Version
-`Ver 1.0.2 (h)`
+`Ver 1.0.3 (c)`
-## 历史 Changelog
+## 历史・変更ログ・Changelog
+
+- 2023.4.26 Ver 1.0.3 (c): jp doc (fin).
+
+- 2023.4.25 Ver 1.0.3 (b): jp doc (mid).
+
+- 2023.4.24 Ver 1.0.3 (a): the Japanese documentation (ini).
- 2023.4.15 Ver 1.0.2 (h): revised English doc and add reference.
@@ -79,8 +89,9 @@ This package is also available on [CTAN](https://www.ctan.org/pkg/evangelion-jfm
- 2023.2.7 Ver 1.0.0 (a): initial version.
## Copyright
-This project is under MIT License.
+
+This project is under MIT License. (Ref [`license`](LICENSE))
Author: RadioNoiseE, 黄京.
-Email Addr: j18516785606@icloud.com.
+Email Addr: `j18516785606@icloud.com`.
diff --git a/Master/texmf-dist/doc/luatex/evangelion-jfm/make.sh b/Master/texmf-dist/doc/luatex/evangelion-jfm/make.sh
index d5a96fd26dc..375a9758c88 100644
--- a/Master/texmf-dist/doc/luatex/evangelion-jfm/make.sh
+++ b/Master/texmf-dist/doc/luatex/evangelion-jfm/make.sh
@@ -10,13 +10,16 @@ luatex Evangelion-JFM.dtx
# Complie respectively
lualatex Eva-JFM_doc-sc.tex
lualatex Eva-JFM_doc-sc.tex
+lualatex Eva-JFM_doc-jp.tex
+lualatex Eva-JFM_doc-jp.tex
lualatex Eva-JFM_doc-en.tex
lualatex Eva-JFM_doc-en.tex
# Clean-up (requires LaTeXmk)
latexmk -c Eva-JFM_doc-sc.tex
+latexmk -c Eva-JFM_doc-jp.tex
latexmk -c Eva-JFM_doc-en.tex
-rm Eva-JFM_doc-sc.tex Eva-JFM_doc-en.tex
+rm Eva-JFM_doc-sc.tex Eva-JFM_doc-en.tex Eva-JFM_doc-jp.tex
# Terminate
echo "--Make: Documentations and run-time files generated--"