OSDN Git Service

more unicode library -> utf
[luatex-ja/luatexja.git] / doc / lltjp-geometry.tex
index 20e11c4..b8d4963 100644 (file)
@@ -1,18 +1,19 @@
-%#! luajitlatex
-\documentclass[a4paper,10pt]{ltjsarticle}
-\usepackage[textwidth=45\zw, lines=45, footskip=2\zh, verbose]{geometry}
-\usepackage{listings,amsmath,booktabs,lltjext}
-\usepackage[match]{luatexja-fontspec}
+%#! lualatex
+\documentclass[a4paper,10ptj]{ltjsarticle}
+\usepackage[textwidth=42\zw, lines=42, footskip=2\zh, verbose]{geometry}
+\usepackage{listings,amsmath,booktabs,lltjext,bxghost}
 \usepackage{unicode-math}
-\setmathfont{XITS Math}
-\setmainfont{TeX Gyre Termes}
-\setsansfont[Scale=0.95]{TeX Gyre Heros}
-\usepackage[kozuka-pr6n]{luatexja-preset}\normalsize
+\setmathfont{Latin Modern Math}
+\usepackage[match]{luatexja-fontspec}
+\usepackage[haranoaji]{luatexja-preset}
+\setmonojfont{HaranoAjiGothic-Regular}
+\normalsize
 \def\emph#1{\textbf{\textgt{\mathversion{bold}#1}}}
 \def\headfont{\normalfont\bfseries\gtfamily}
 \def\pTeX{p\kern-.05em\TeX}
-\def\cs#1{\text{\texttt{\char`\\#1}}}
-
+\def\cs#1{\text{\eghostguarded{\texttt{\char`\\#1}}}}
+\protected\def\Pkg#1{\textsf{#1}}
+\protected\def\>{\hskip\ltjgetparameter{xkanjiskip}}
 \lstset{
   basicstyle=\ttfamily, basewidth=0.5em,
 }
 \def\LuaTeX{Lua\TeX}
 \definecolor{blue}{rgb}{0, 0.25, 1}
 
-\title{\textsf{lltjp-geometry}パッケージ}
-\author{\LuaTeX-jaプロジェクト%
-  \thanks{\url{http://sourceforge.jp/projects/luatex-ja/wiki/FrontPage}}}
+\title{\Pkg{lltjp-geometry}パッケージ}
+\author{\LuaTeX-jaプロジェクト\null%
+  \thanks{\url{http://osdn.jp/projects/luatex-ja/wiki/FrontPage}}}
 \begin{document}
 \maketitle
 
 ページレイアウトの設定として,\href{http://www.ctan.org/pkg/geometry}%
-{\textsf{geometry}パッケージ}が有名であるが,
+{\Pkg{geometry}パッケージ}が有名であるが,
 これはp\LaTeX・\LuaTeX-jaの縦組クラスでは利用が不可能という問題があった.
-本文書で解説する\textsf{lltjp-geometry}パッケージは,\textsf{geometry}パッケージを
+本文書で解説する\Pkg{lltjp-geometry}パッケージは,\Pkg{geometry}パッケージを
 縦組クラスに対応させるパッチである.
 
 
 \section{利用方法}
-\textsf{lltjp-geometry}パッケージは,\LuaTeX-jaに標準で含まれている.
-本パッケージの動作には\href{http://www.ctan.org/pkg/ifluatex}{\textsf{ifluatex}}, 
-\href{http://www.ctan.org/pkg/filehook}{\textsf{filehook}}パッケージが必要である.
-
-\subsection{\LuaTeX-ja}
-\LuaTeX-jaでは,\textsf{geometry}パッケージ読み込み時に
-自動的に\textsf{lltjp-geometry}パッケージが読み込まれ,ユーザは何もしなくても良い.
-\LuaTeX-jaで横組クラスを利用する時でも,
-\textsf{lltjp-geometry}パッケージは自動的に動作を停止するので,横組時の挙動が
-変わってしまうことはない.
-
-\subsection{\pTeX 系列}
-\pTeX 系列では,\textsf{tarticle}, \textsf{tbook}, \textsf{treport}といった
-\emph{縦組クラスを使う場合}にのみ,
+\Pkg{lltjp-geometry}パッケージは,\LuaTeX-jaに標準で含まれている.
+本パッケージの動作には\href{http://www.ctan.org/pkg/ifluatex}{\Pkg{ifluatex}},
+\href{https://www.ctan.org/pkg/etoolbox}{\Pkg{etoolbox}}パッケージが必要である.
+また,\LaTeXe~2020\nobreakdash-02\nobreakdash-02以前では\href{http://www.ctan.org/pkg/filehook}{\Pkg{filehook}}パッケージも必要である.
+
+\LuaTeX-jaでは,自動的に\Pkg{lltjp-geometry}パッケージが読み込まれる.
+縦組クラスか否かの自動判定(\ref{ssec:auto}節)を上書きしたい場合は,
 \begin{lstlisting}
-\usepackage{lltjp-geometry}
+% \PassOptionsToPackage{force}{lltjp-geometry} % 強制的に有効
+\PassOptionsToPackage{disable}{lltjp-geometry} % 強制的に無効
+\documentclass{...}
+\usepackage[...]{geometry}
+\end{lstlisting}
+のように\emph{\Pkg{luatexja}の読み込み前}に\cs{PassOptionsToPackage}で
+本パッケージに渡すオプションを指定する(\cs{usepackage\{lltjp-geometry\}}\>を行っても意味がない).
+
+\pTeX 系列では,\Pkg{tarticle}, \Pkg{tbook}, \Pkg{treport}といった
+\emph{縦組クラスを使う場合}に,
+\begin{lstlisting}
+\usepackage[...]{lltjp-geometry}
 \usepackage[...]{geometry}
 \end{lstlisting}
-のように\emph{\textsf{geometry}パッケージの前}に読み込む.
-\pTeX 系列では使用クラスが横組か縦組かの自動判定を行えない\footnote{%
-  標準縦組クラスでは,\cs{begin\{document\}} の内部で組方向を縦組に変更するので,
-  プリアンブル中で判定できない.
-}ので,\emph{横組クラスで読み込んではならない}.
+と,\Pkg{geometry}パッケージの\emph{前}に読み込む.
 
-パッケージオプションは存在しない.
+\subsection{縦組クラスか否かの判定}
+\label{ssec:auto}
+本パッケージは,以下のいずれかが該当する場合に「現在のクラスは縦組クラス」と自動判定し,
+\Pkg{geometry}パッケージ読み込み直後にパッチを当てる:
+\begin{enumerate}
+  \item \Pkg{geometry}パッケージを読み込む際に,現在の組方向が縦組になっている.
+  \item \cs{AtBeginDocument}により
+  \footnote{\LaTeXe~2020-10-01以降ではそれと同義な\>\cs{AddToHook\{begindocument\}}\>も含む.}指定される,
+  \cs{begin\{document\}}\>時に実行される内容に\cs{tate}(というトークン)が含まれている.
+  \item 本パッケージを読み込む際に\texttt{force}オプションが指定されている.
+\end{enumerate}
+
+\LuaTeX-jaで縦組クラスを利用する場合は主に1.の,
+\pTeX 系列で縦組クラスを利用する場合は主に2.の状況となる
+\footnote{%
+  標準縦組クラスでは,\cs{begin\{document\}}\>の内部で組方向を縦組に変更する.
+}.
+
+上記の自動判定がうまく行かなかったときに備え,
+本パッケージには\texttt{force}オプションと\texttt{disable}オプションを用意した.
+\begin{itemize}
+  \item \texttt{force}オプションが指定されている場合は,自動判定の結果に関わらず
+  \Pkg{geometry}パッケージ読み込み直後にパッチを当てる.
+  \item \texttt{disable}オプションが指定されている場合は,自動判定の結果に関わらず
+  何もしない.
+\end{itemize}
+
+\section{\Pkg{lltjp-geometry}使用時の注意事項}
 
-\section{注意事項}
 \subsection{\texttt{twoside}指定時}
 縦組の本は通常右綴じである.これを反映し,
-\textsf{lltjp-geometry}では,\texttt{twoside} オプション指定時には
+\texttt{twoside}オプション指定時には
 \begin{itemize}
-\item \texttt{left}, \texttt{lmargin} は小口側の余白,
-\texttt{right}, \texttt{rmargin} はノド側の余白を指す.
-\item 左右余白比 \texttt{hmarginratio} の標準値は$3:2$に変更.
-\item \texttt{bindingoffset} は\emph{右側}に余白を確保する.
+\item \texttt{left}, \texttt{lmargin}は小口側の余白,
+\texttt{right}, \texttt{rmargin}はノド側の余白を指す.
+\item 左右余白比 \texttt{hmarginratio}の標準値は$3:2$に変更.
+\item \texttt{bindingoffset}は\emph{右側}に余白を確保する.
 \end{itemize}
 と変更している.
 
+\subsection{widthとheight}
+\cs{textwidth}が字送り方向の長さ(縦)を表すのと同様に,
+\texttt{width}, \texttt{totalwidth}, \texttt{textwidth}キーの値も字送り方向を,また
+\texttt{height}, \texttt{totalheight}, \texttt{textheight}キーの値も行送り方向(横)を表すようになっている.
+
+しかし,\emph{用紙サイズについては例外}であり,物理的な意味での幅・高さを表す.
+\texttt{paperwidth}, \texttt{layoutwidth}はそれぞれ紙の横幅,レイアウトの横幅を,
+\texttt{paperheight}, \texttt{layoutheight}はそれぞれ紙の高さ,レイアウトの高さを表している.
+
+
+
 \subsection{傍注}
 縦組の場合,傍注は本文の上下に配置される\footnote{%
   二段組の場合は上下共に,一段組の場合は標準では下側だが,
-  \texttt{reversemp} が指定されたときには上側に配置される.
+  \texttt{reversemp}が指定されたときには上側に配置される.
 }.これにより,\emph{\texttt{includemp}(や \texttt{includeall})が
 未指定の場合,傍注はヘッダやフッタに重なる}.
-\texttt{includemp} 指定時は,\cs{footskip}, \cs{headsep} のいずれか
+\texttt{includemp}指定時は,\cs{footskip}, \cs{headsep}のいずれか
 (二段組の場合は両方)を$\cs{marginparwidth} + \cs{marginparsep}$だけ
 増加させる.
 
-\subsection{\texttt{lines}オプション指定時の \cs{maxdepth} 調整}
+\section{\texttt{lines}オプションに関する注意事項}
+本節の内容は,\Pkg{lltjp-geometry}パッケージを読み込まない場合,
+つまり,横組クラスで\Pkg{geometry}パッケージを普通に使用した場合にも
+当てはまる注意事項である.
+
+% \subsection{\Pkg{fontspec}パッケージとの干渉}
+% \Pkg{fontspec}パッケージの,読み込み直後に
+% \Pkg{geometry}パッケージを用いてレイアウトを設定すると,
+% \texttt{lines}による指定が正しく働かないという症状が生じる:
+% \begin{lstlisting}
+% \documentclass{article}
+% \usepackage{geometry}
+% \usepackage{fontspec}
+% \geometry{lines=20}
+% \begin{document}
+% hoge\typeout{\the\topskip, \the\baselineskip, \the\textheight}
+% \end{document}
+% \end{lstlisting}
+% \cs{typeout}で\cs{topskip}, \cs{baselineskip}, \cs{textheight}の値を調べると
+% \[
+%  \frac{\cs{textheight} - \cs{topskip}}{\cs{baselineskip}} = 15.8\dot 3
+% \]
+% となることがわかるから,1ページには16行分入らないことがわかる.
+
+% これは,\Pkg{fontspec}の読み込みによって\cs{baselineskip}がなぜか
+% 10\,ptに変えられてしまい,\cs{geometry}命令はその値に従って本文領域の高さを計算するためで
+% ある.とりあえずの対策は,
+% \cs{normalsize}によって\cs{baselineskip}を正しい値に再設定し,その後
+% レイアウトを設定すれば良い:
+% \begin{lstlisting}
+% \usepackage{geometry}
+% \usepackage{fontspec}
+% \normalsize\geometry{lines=20}
+% \end{lstlisting}
+
+
+\subsection{\cs{maxdepth}の調整}
 \LaTeX では,
 最後の行の深さ\rensuji{$d$}と
 本文領域の上端から最後の行のベースラインまでの距離\rensuji{$f$}に対し,
 \[
- \cs{textheight} = f+\max(0, d-\cs{maxdepth})
+ \cs{textheight}= f+\max(0, d-\cs{maxdepth})
 \]
 が成り立つ.
 
-\pTeX 系列の標準縦組クラス\textsf{[u]tarticle}等,
-及びそれを\LuaTeX-ja用に移植した\textsf{ltjtarticle}等では,
- \cs{topskip} は\emph{横組時における}全角空白の高さ7.77588\,pt\footnote{%
+\pTeX 系列の標準縦組クラス\Pkg{[u]tarticle}等,
+及びそれを\LuaTeX-ja用に移植した\Pkg{ltjtarticle}等では,
+ \cs{topskip}は\emph{横組時における}全角空白の高さ7.77588\,pt\footnote{%
   標準の\texttt{10pt}オプション指定時.以下同じ.
   ところで,この量は公称フォントサイズの10\,ptか,もしくは
   全角空白の高さと深さを合わせた値の9.16446\,ptの間違いではないか,と筆者は考えている.
   なお,奥村晴彦氏の\href{https://oku.edu.mie-u.ac.jp/~okumura/jsclasses/}%
   {p\LaTeXe 新ドキュメントクラス}では公称ポイントサイズ10\,ptに設定されている.
-}であり,\cs{maxdepth} はその半分の値(従って3.88794\,pt)である.
+}であり,\cs{maxdepth}はその半分の値(従って3.88794\,pt)である.
 
 いくつかのフォントについて,その中の文字の深さの最大値を見てみると
 表\ref{tab:baseline}のようになっている.
     \label{tab:baseline}}
 \end{table}
 欧文フォントのベースラインは,そのままでは和文との組み合わせが悪いので,
-さらに$\textsf{tbaselineshift}=3.41666\,\textrm{pt}$だけ下がることを考えると,
-最後の行に和文文字が来た場合はほぼ確実に深さが \cs{maxdepth} を超えてしまうことになる.
+さらに$\Pkg{tbaselineshift}=3.41666\,\textrm{pt}$だけ下がることを考えると,
+最後の行に和文文字が来た場合はほぼ確実に深さが\cs{maxdepth}を超えてしまうことになる.
 従って,本文領域を「\rensuji{$n$}行分」として指定するときによく使われる
 \begin{equation}
    \cs{textheight} = \cs{topskip} + (n-1)\cs{baselineskip}
  \label{eq:nline}
 \end{equation}
-は\textsf{tarticle}クラスのデフォルトでは通用しない.
+は\Pkg{tarticle}クラスのデフォルトでは通用しない.
 
 通常の地の文のみの文章においてほぼ確実に\eqref{eq:nline}が成り立つようにするため,
-\textsf{lltjp-geometry}では\emph{\texttt{lines}オプション指定時のみ} \cs{maxdepth} の値が
+\Pkg{lltjp-geometry}では\emph{\texttt{lines}オプション指定時のみ}\cs{maxdepth}の値が
 最低でも
 \begin{quote}
 公称ポイントサイズの半分に,欧文ベースラインのシフト量を加えた値%
-\footnote{\textsf{tarticle}の場合だと,
+\footnote{\Pkg{tarticle}の場合だと,
 $5\,\textrm{pt} + 3.41666\,\textrm{pt}=8.41666\,\textrm{pt}$である.}
 \end{quote}
-になるようにしている.\texttt{lines} オプション非指定時にはこのような調整は
+になるようにしている.\texttt{lines}オプション非指定時にはこのような調整は
 行われない.
 
 
-\subsection{\texttt{lines} オプション指定時の見かけ上の基本版面の位置}
+\subsection{見かけ上の基本版面の位置}
 \LaTeX では,
 本文の一行目のベースラインは,本文領域の「上端」から
- \ \cs{topskip}\ だけ「下がった」ところに来ることになっている.
-あまり \cs{topskip} が小さいと,ユーザが大きい文字サイズを指定した時に1行目のベースライン
+ \cs{topskip}\ だけ「下がった」ところに来ることになっている.
+あまり\cs{topskip}が小さいと,ユーザが大きい文字サイズを指定した時に1行目のベースライン
 位置が狂う危険があるため,
-\textsf{geometry}パッケージでは
+\Pkg{geometry}パッケージでは
 \begin{quote}
- \texttt{lines} オプション指定時,\cs{topskip} の値を最低でも
- \cs{strutbox} の高さ($0.7\cs{baselineskip}$)まで引き上げる
+ \texttt{lines}オプション指定時,\cs{topskip}の値を最低でも
+ \cs{strutbox}の高さ($0.7\cs{baselineskip}$)まで引き上げる
 \end{quote}
 という仕様になっている.
 
-縦組の場合は,\cs{strutbox} に対応するボックスは \cs{tstrutbox} であるため,
-\textsf{lltjp-geometry}では
+縦組の場合は,\cs{strutbox}に対応するボックスは\cs{tstrutbox}であるため,
+\Pkg{lltjp-geometry}では
 \begin{quote}
- \texttt{lines} オプション指定時,\cs{topskip} の値を最低でも
- \emph{\cs{tstrutbox} の高さ($\cs{baselineskip}/2$)}まで引き上げる
+ \texttt{lines}オプション指定時,\cs{topskip}の値を最低でも
+ \emph{\cs{tstrutbox}の高さ}($\cs{baselineskip}/2$)まで引き上げる
 \end{quote}
-という挙動にした.見かけ上は \cs{topskip} の値制限が緩くなったが,前節で述べたように
+という挙動にした.見かけ上は\cs{topskip}の値制限が緩くなったが,前節で述べたように
 欧文フォントのベースラインは和文に合うように下にずらされるので,
 実用上は問題は起きないだろう.
 
-前節の \cs{maxdepth} の調整も考え合わせると,\emph{\LaTeX が認識する本文領域と,
+前節の\cs{maxdepth}の調整も考え合わせると,\emph{\LaTeX が認識する本文領域と,
 実際の見た目の基本版面の位置とは異なる}ことに注意してほしい.
 
 \medskip
@@ -192,10 +266,10 @@ $5\,\textrm{pt} + 3.41666\,\textrm{pt}=8.41666\,\textrm{pt}$である.}
 \end{lstlisting}
 と指定すると,実際には以下のように設定される.
 \begin{itemize}
- \item \cs{topskip} は \cs{tstrutbox} の高さ8.5\,ptに設定される.
- \item 本文領域の「高さ」 \cs{textheight} は 
+ \item\cs{topskip}は\cs{tstrutbox}の高さ8.5\,ptに設定される.
+ \item 本文領域の「高さ」\cs{textheight}は
 \[
- \cs{topskip} + (30-1)\cs{baselineskip} = 530.5\,\textrm{pt}.
+ \cs{topskip}+ (30-1)\cs{baselineskip}= 530.5\,\textrm{pt}.
 \]
  \item 従って,左余白と右余白は
 \[
@@ -203,12 +277,12 @@ $5\,\textrm{pt} + 3.41666\,\textrm{pt}=8.41666\,\textrm{pt}$である.}
 \]
 \end{itemize}
 しかし,実際にはページの最初の行のベースラインは,本文領域の右端から
-\ \cs{topskip} だけ左にずれたところにあり,
+\cs{topskip}だけ左にずれたところにあり,
 一方ページの最終行のベースラインは本文領域の左端にある.
 縦組和文フォントのベースラインは文字の左右中央を通ることから,
-従って,\emph{見た目で言えば,右余白の方が$\cs{topskip} =8.5\,\textrm{pt}$だけ
-大きい}ということになってしまう\footnote{%
-  同様に,横組で \texttt{vcentering} を指定すると,見かけでは
+従って,\emph{見た目で言えば,右余白の方が\cs{topskip}}~($=8.5\,\textrm{pt}$)%
+\emph{だけ大きい}ということになってしまう\footnote{%
+  同様に,横組で \texttt{vcentering}を指定すると,見かけでは
   $\cs{topskip}-\cs{Cht}+\cs{Cdp}$だけ上余白が大きいように見える.
 }.