summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/babel-japanese
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-12-13 22:04:40 +0000
committerKarl Berry <karl@freefriends.org>2020-12-13 22:04:40 +0000
commitae96c648310b09af5b42cf70cc78309c898c65ef (patch)
tree70099580aff8e420f9bcdfe504ec412ed952e74c /Master/texmf-dist/doc/generic/babel-japanese
parentd827b0bed5d4482d0f3184ce42a8c047d23f4f9c (diff)
babel-japanese (13dec20)
git-svn-id: svn://tug.org/texlive/trunk@57129 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/babel-japanese')
-rw-r--r--Master/texmf-dist/doc/generic/babel-japanese/README.md2
-rw-r--r--Master/texmf-dist/doc/generic/babel-japanese/japanese.pdfbin326377 -> 338833 bytes
-rw-r--r--Master/texmf-dist/doc/generic/babel-japanese/japanese.tex139
3 files changed, 93 insertions, 48 deletions
diff --git a/Master/texmf-dist/doc/generic/babel-japanese/README.md b/Master/texmf-dist/doc/generic/babel-japanese/README.md
index e0f60b35779..976383cc40e 100644
--- a/Master/texmf-dist/doc/generic/babel-japanese/README.md
+++ b/Master/texmf-dist/doc/generic/babel-japanese/README.md
@@ -81,6 +81,6 @@ modified under the terms of the LaTeX Project Public License 1.3.
## Release Date
-2020-12-06
+2020-12-13
Japanese TeX Development Community
diff --git a/Master/texmf-dist/doc/generic/babel-japanese/japanese.pdf b/Master/texmf-dist/doc/generic/babel-japanese/japanese.pdf
index 7d64e49e0b5..980964c4dbf 100644
--- a/Master/texmf-dist/doc/generic/babel-japanese/japanese.pdf
+++ b/Master/texmf-dist/doc/generic/babel-japanese/japanese.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/babel-japanese/japanese.tex b/Master/texmf-dist/doc/generic/babel-japanese/japanese.tex
index 1ef7514b2f0..d6024d07e97 100644
--- a/Master/texmf-dist/doc/generic/babel-japanese/japanese.tex
+++ b/Master/texmf-dist/doc/generic/babel-japanese/japanese.tex
@@ -52,8 +52,10 @@
\def\ClsYT#1{\Pkg{\textcolor{Blue}{#1}}}
\def\file#1{\textsf{#1}}
\def\code#1{\texttt{#1}}
+\def\cs#1{\texttt{\textbackslash#1}}
\usepackage[japanese,english]{babel}% References in English
+\AtBeginDocument{\def\figurename{Figure~}}% add a space
\usepackage{listings}
\lstset{%
@@ -110,15 +112,20 @@ Typesetting requirements of Japanese are completely different from
those of Western languages, so setting parameter values and additional
hyphenation patterns are not enough.
-% babel-japanese (japanese.ldf) は訳語を登録するだけ
-% 日本語組版に必要な設定は行わない
-The package \Pkg{babel-japanese} provides ``\Opt{japanese}''
-option for Babel package.
-However, it only defines translated replacement texts for
-keywords and dates (e.g. ``\contentsname'' $\rightarrow$
-``{\selectlanguage{japanese}\contentsname}'',
-\verb+\today+ $\rightarrow$ ``{\selectlanguage{japanese}\和暦\today}'')
-and it does not care about any Japanese typesetting requirements.
+\begin{itemize}
+ % babel-japanese (japanese.ldf) は訳語を登録するだけ
+ % 日本語組版に必要な設定は行わない
+ \item The \Opt{japanese} option of Babel package only defines
+ translated replacement texts for
+ keywords and dates (e.g. ``\contentsname'' $\rightarrow$
+ ``{\selectlanguage{japanese}\contentsname}'',
+ \verb+\today+ $\rightarrow$ ``{\selectlanguage{japanese}\和暦\today}'');
+ it does not care about any Japanese typesetting requirements.
+ % CJK パッケージも不十分
+ \item It may seem sufficient to use a package such as \Pkg{CJK} or
+ \Pkg{xeCJK}, or switch to Japanese fonts with a Unicode-enabled engine;
+ however, that's not the case.
+\end{itemize}
% この文書の目的:ちゃんと日本語する簡単な方法の紹介
%-- 日本語を「ちゃんと」組むことが西欧言語とは全く異なることを伝える。
@@ -131,15 +138,18 @@ and Japanese typesetting requirements.
% とりあえず LuaLaTeX + \usepackage{luatexja} オススメ
+%-- 対象読者が「日本語組版を全く知らない海外の人」なので
+%-- 資産(=解説書,周囲の経験,歴史等)の面が日本と真逆である!
+%-- つまり LuaTeX 最強+資産も最強
\section{Short introduction: using \LuaLaTeX}
To obtain a properly formatted Japanese document, the easiest way
is to use \LuaLaTeX\ with Lua\TeX-ja package.
\begin{itemize}
- \item Using the \Pkg{jlreq} class:
+ \item Using the \Pkg{jlreq} class (it loads \Pkg{luatexja} internally):
\begin{lstlisting}
- \documentclass[book]{jlreq}
+ \documentclass[book]{jlreq}% loads luatexja.sty internally
\begin{document}
\chapter{日本語の文書}% Japanese document
こんにちは,日本。% Hello, Japan.
@@ -186,7 +196,7 @@ Save the above as \file{jp2.tex} and run the following command.
\begin{verbatim}
$ uplatex jp2
\end{verbatim}
-You will get \file{jp2.dvi}.\bigskip
+You will get \file{jp2.dvi}.
\upLaTeX\ and \pLaTeX\ (explained later) are often referred to
as (u)\pLaTeX. They always output DVI files.
@@ -196,7 +206,14 @@ If you have \file{jp2.dvi}, running the following command
\begin{verbatim}
$ dvipdfmx jp2
\end{verbatim}
-will generate \file{jp2.pdf}.\bigskip
+will generate \file{jp2.pdf}.
+
+If you want to simplify the procedure, you can use the command
+\begin{verbatim}
+ $ ptex2pdf -l -u jp2
+\end{verbatim}
+which runs \code{uplatex} and \code{dvipdfmx} in sequence.
+\bigskip
Since the default DVI driver in \TL is set to
\Opt{dvips},\footnote{Though dvips supports DVI with Japanese fonts,
@@ -218,8 +235,8 @@ to be passed to all driver-dependent packages
Some old Japanese journal classes may require \pLaTeX.
It is a legacy implementation which was born in 1980s,
-before the release of Unicode 1.0.
-\pLaTeX\ only supports a limited character set, JIS~X~0208
+before the release of Unicode 1.0,
+and it only supports a limited character set, JIS~X~0208
(6879 characters).
\begin{lstlisting}
\documentclass{jsbook}% or, \documentclass{jbook}
@@ -233,6 +250,12 @@ Save the above as \file{jp3.tex} and run the following command.
You will get \file{jp3.dvi}.
Again, the DVI file can be converted into PDF using dvipdfmx.
+If you want to simplify the procedure, you can use the command
+\begin{verbatim}
+ $ ptex2pdf -l jp3
+\end{verbatim}
+which runs \code{platex} and \code{dvipdfmx} in sequence.
+
% CJK package はサポート外
\newenvironment{NOTE}{\StartNOTE\small}{\EndNOTE}
@@ -247,27 +270,25 @@ Note for users who know the \Pkg{CJK} package:
(u)\pLaTeX\ does \emph{not} support the \Pkg{CJK} package!
The reasons are the followings:
\begin{itemize}
+ \item The input handling of (u)\pTeX\ engine is different
+ from that of Western \TeX\ engines. Since Japanese tokens
+ are no longer treated as active characters,
+ the subsequent processing becomes inconsistent.
\item Both the (u)\pLaTeX\ kernel and \file{CJK.sty} redefine
the command \verb+\selectfont+, and those definitions are
incompatible.
- \item The input handling of (u)\pTeX\ engine is different
- from that of Western \TeX\ engines, and Japanese tokens
- are no longer treated as active characters.
\end{itemize}
-Anyway, you will not need the \Pkg{CJK} package at all
-when using (u)\pLaTeX.
+Anyway, if you use (u)\pLaTeX, which provides better Japanese support,
+you will not need the \Pkg{CJK} package at all.
\end{NOTE}
-%% ちゃんと日本語を組むには?
-%-- 禁則文字を除く任意箇所での行分割が可能
-%-- 和文文字直後の改行文字は空白にならない
-%-- 約物どうしの字間調整
-%-- 和欧文間空白の挿入
+% 本書のメイン:西欧組版と日本語組版の違い;ちゃんと日本語を組むには?
\section{Differences between Western and Japanese typesetting}
The sections above described some practical ways to achieve
``acceptable'' Japanese typesetting results.
+In the Appendix, you will find more examples.
So, what are the minimum requirements for ``acceptable'' results
for native Japanese readers?
@@ -281,6 +302,13 @@ small-sized supplementary text (\Foreign{ruby}; ルビ), inline cutting note
(\Foreign{warichu}; 割注) etc.} so we focus on the main issues regarding
simple and short horizontal writing within a few lines.
+%% 行分割と空白挿入
+%-- 禁則文字を除く任意箇所での行分割が可能
+%-- 和文文字直後の改行文字は空白にならない
+%-- 約物どうしの字間調整
+%-- 和欧文間空白の挿入
+\subsection{Line breaks and spacing}
+
\newbox\JEXBOX % stores example output
\newbox\JJgridbox
\def\JJsq{%
@@ -298,9 +326,12 @@ simple and short horizontal writing within a few lines.
\vbox{\hsize=12\zw\noindent\leftskip0pt\rightskip0pt\parfillskip0pt#1\hss}\vrule}%
}}
-Consider the following input, Listing \ref{list:src1}. Using \LuaLaTeX,
+This is the most notable aspect of Japanese typesetting, and a concept
+that would not be found in Western typesetting.
+Consider the input list, Listing \ref{list:src1}. Using \LuaLaTeX,
it is allowed to include any Unicode character out-of-the-box,
-though a suitable Japanese font should be declared.
+and they are actually displayed correctly in the output when a suitable
+Japanese font is declared.
\begingroup
\begin{figure}[tbp]
@@ -364,6 +395,28 @@ are developed to support (most of) the requirements mentioned above,
and their output is most likely to be acceptable.
Therefore, we recommend to use one of those platforms.
+%% レイアウト
+%-- 前節の「ベタ組で任意箇所での行分割」「xkanjiskip」などは
+%-- 西欧組版には相当概念が存在しないと思われる。
+%-- 一方,レイアウトパラメータ(行送り・字下げ・行長)は
+%-- 西欧の TeX でも変更可能なパラメータ化されているので,次元が低い。
+\subsection{Page layout (brief description)}
+
+% 正方形が和文書体の基本的デザイン指向であり,欧文書体と顕著に異なる
+% 書体のデザインの違いが,後述の字下げや行長の慣習に寄与している
+Also, if the main language of the document is Japanese, it is common
+to choose a properly designed Japanese class.
+Unlike Latin typefaces, most of Japanese typefaces are designed in squares
+with a width of \Foreign{zenkaku}.
+This difference greatly contributes to the overall page layout in
+Japanese typesetting.
+
+For example, the typesetting procedure can be simplified by setting
+\cs{textwidth} to a multiple of \Foreign{zenkaku},
+and \cs{parindent} to 1~\Foreign{zenkaku}.
+Many recent Japanese classes determine margins accordingly, and
+adjust other layout parameters to improve readability.
+
\begingroup
\ltjsetparameter{jacharrange={-1,-2,-3,-4,-5,-6,-7,-8,-9}}
\setmainfont{HaranoAjiMincho-Regular}
@@ -399,11 +452,10 @@ Therefore, we recommend to use one of those platforms.
\label{fig:src1-mod}
\end{figure}
-
%% 日本語組版における多書体化の必要性
%-- 欧文組版で「セリフ体からのイタリック化」に相当するのは
%-- 和文組版では「明朝体(セリフ)からのゴシック(サンセリフ)化」
-\section{Using multi-weight typefaces for Japanese typesetting}
+\subsection{Using multi-weight typefaces for Japanese typesetting}
Latin font families used in Western typesetting consist of
many typefaces:
@@ -659,13 +711,13 @@ Other major classes designed for Japanese:
\clearpage
\appendix
-\section{Examples of acceptable Japanese typesetting results}
+\section{Code Gallery --- acceptable Japanese typesetting results}
\subsection{A simple Japanese document}
Using \LuaLaTeX:
\begin{lstlisting}
- \documentclass[book]{jlreq}
+ \documentclass[book]{jlreq}% loads luatexja.sty internally
\begin{document}
\chapter{日本語がメインのシンプルな文書}
こんにちは,日本語に少しEnglishを含めてみます。
@@ -726,7 +778,7 @@ Using \upLaTeX\ (or \pLaTeX) + dvipdfmx:
Using \LuaLaTeX:
\begin{lstlisting}
\documentclass[article]{jlreq}
- \usepackage{jlreq-deluxe}% multi weight
+ \usepackage[deluxe]{luatexja-preset}% multi weight
\begin{document}
\section{簡単な文章}
通常のテキストにはSerifと明朝体を使います。
@@ -736,30 +788,22 @@ Using \LuaLaTeX:
\end{document}
\end{lstlisting}
-If you are using \LuaLaTeX\ with classes other than \Pkg{jlreq},
-you can also use \Pkg{luatexja-preset}:
-\begin{lstlisting}
- \documentclass{ltjsarticle}
- \usepackage[deluxe]{luatexja-preset}% multi weight
- \begin{document}
- ...
-\end{lstlisting}
-
-Using \upLaTeX\ (or \pLaTeX) + dvipdfmx:
+Using \upLaTeX\ (or \pLaTeX) + dvipdfmx with the \Pkg{jlreq} class:
+the package \Pkg{jlreq-deluxe} is recommended.
\begin{lstlisting}
+ \RequirePackage{plautopatch}% recommended
\documentclass[article,dvipdfmx]{jlreq}% driver option
\usepackage{jlreq-deluxe}% multi weight
\begin{document}
...
\end{lstlisting}
-The package \Pkg{jlreq-deluxe} is relatively new, and it is
-designed to be used with the \Pkg{jlreq} class.
-Traditionally the \Pkg{otf} package has been widely used
-for over a decade.
+Traditionally, the \Pkg{otf} package (distributed as \Pkg{japanese-otf}
+on CTAN/\TL) has been widely used for over a decade on (u)\pLaTeX.
Using \upLaTeX\ + dvipdfmx:
\begin{lstlisting}
+ \RequirePackage{plautopatch}% recommended
\documentclass[uplatex,dvipdfmx]{jsarticle}
\usepackage[deluxe]{otf}% multi weight
\begin{document}
@@ -768,13 +812,13 @@ Using \upLaTeX\ + dvipdfmx:
Using \pLaTeX\ + dvipdfmx:
\begin{lstlisting}
+ \RequirePackage{plautopatch}% recommended
\documentclass[dvipdfmx]{jsarticle}
\usepackage[deluxe]{otf}% multi weight
\begin{document}
...
\end{lstlisting}
-
\subsection{Vertical writing}
As a Japanese version of \Pkg{lipsum}, here we use
@@ -794,6 +838,7 @@ Using \LuaLaTeX:
Using \upLaTeX\ (or \pLaTeX) + dvipdfmx:
\begin{lstlisting}
+ \RequirePackage{plautopatch}% recommended
\documentclass[article,tate,dvipdfmx]{jlreq}% driver option
\usepackage{bxjalipsum}
\begin{document}