diff options
author | Karl Berry <karl@freefriends.org> | 2018-03-16 21:29:25 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2018-03-16 21:29:25 +0000 |
commit | 48ef5846bc362a046f7541eb753c7082839efe97 (patch) | |
tree | 4130af85c62174fde8467903749e6b1840bd8da4 /Master/texmf-dist/doc/latex/platex-tools | |
parent | 00ba2fdaf854df22163fbf818ffbf52013fd2fcf (diff) |
platex-tools (16mar18)
git-svn-id: svn://tug.org/texlive/trunk@46985 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/platex-tools')
-rw-r--r-- | Master/texmf-dist/doc/latex/platex-tools/LICENSE | 8 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/platex-tools/Makefile | 13 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/platex-tools/README.md | 17 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.pdf | bin | 43162 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.tex | 133 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/platex-tools/bounddvi.pdf | bin | 117117 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/platex-tools/bounddvi.tex | 146 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/platex-tools/gentombow.pdf | bin | 141204 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/platex-tools/gentombow.tex | 209 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/platex-tools/plarray.pdf | bin | 61431 -> 61484 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/platex-tools/pxgentombow.pdf | bin | 168874 -> 0 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/platex-tools/pxgentombow.tex | 329 |
12 files changed, 9 insertions, 846 deletions
diff --git a/Master/texmf-dist/doc/latex/platex-tools/LICENSE b/Master/texmf-dist/doc/latex/platex-tools/LICENSE index 888d02f49c5..99a0c323d19 100644 --- a/Master/texmf-dist/doc/latex/platex-tools/LICENSE +++ b/Master/texmf-dist/doc/latex/platex-tools/LICENSE @@ -1,4 +1,4 @@ -Copyright (c) 2016-2017 Hironobu Yamashita +Copyright (c) 2016-2018 Hironobu Yamashita All rights reserved. Redistribution and use in source and binary forms, with or without @@ -11,9 +11,9 @@ modification, are permitted provided that the following conditions are met: this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. -* Neither the name of platex nor the names of its - contributors may be used to endorse or promote products derived from - this software without specific prior written permission. +* Neither the name of the copyright holder nor the names of its contributors + may be used to endorse or promote products derived from this software + without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE diff --git a/Master/texmf-dist/doc/latex/platex-tools/Makefile b/Master/texmf-dist/doc/latex/platex-tools/Makefile index b625b603813..7d251a3d134 100644 --- a/Master/texmf-dist/doc/latex/platex-tools/Makefile +++ b/Master/texmf-dist/doc/latex/platex-tools/Makefile @@ -4,9 +4,7 @@ TEXMF = $(shell kpsewhich -var-value=TEXMFHOME) all: plarray.pdf plextarray.pdf plextdelarray.pdf \ pxatbegshi.pdf pxftnright.pdf \ - pxeverysel.pdf pxeveryshi.pdf \ - bounddvi.pdf bounddvi-en.pdf \ - gentombow.pdf pxgentombow.pdf + pxeverysel.pdf pxeveryshi.pdf .SUFFIXES: .tex .dvi .pdf .tex.dvi: @@ -16,15 +14,6 @@ all: plarray.pdf plextarray.pdf plextdelarray.pdf \ .dvi.pdf: dvipdfmx $(FONTMAP) $< -bounddvi-en.dvi: bounddvi-en.tex - latex $< - latex $< - rm *.aux *.log -gentombow.pdf: gentombow.tex - pdflatex $< - pdflatex $< - rm *.aux *.log - .PHONY: install clean install: mkdir -p ${TEXMF}/doc/platex/platex-tools diff --git a/Master/texmf-dist/doc/latex/platex-tools/README.md b/Master/texmf-dist/doc/latex/platex-tools/README.md index c28e3f34f71..447f90f1caa 100644 --- a/Master/texmf-dist/doc/latex/platex-tools/README.md +++ b/Master/texmf-dist/doc/latex/platex-tools/README.md @@ -45,18 +45,9 @@ and some additional packages are included. Can be used on pLaTeX/upLaTeX. The essential part of this package was proposed by Hironori Kitagawa in 2017. -- bounddvi.sty: - Set papersize special to DVI file. - Can be used on LaTeX/pLaTeX/upLaTeX - with dvips or dvipdfmx drivers. - Previous version of this package (v6.0) was written by - Koichi INOUE in 2004 - (https://www.ma.ns.tcu.ac.jp/Pages/TeX/bounddvi.sty.html), - and incorporated into this bundle by his courtesy. -- pxgentombow.sty: - Generate crop mark (called 'tombow' in Japanese) for - practical use in self-publishing. - Can be used on pLaTeX/upLaTeX and LuaTeX-ja. + +The packages "pxgentombow", "gentombow" and "bounddvi" are now distributed +as part of [gentombow](https://github.com/aminophen/gentombow) bundle. ## Character encoding @@ -83,6 +74,6 @@ the 3-clause BSD license (see [LICENSE](./LICENSE)). ## Release Date -2017-12-17 +2018-03-16 Hironobu Yamashita diff --git a/Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.pdf b/Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.pdf Binary files differdeleted file mode 100644 index 395a6f30551..00000000000 --- a/Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.tex b/Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.tex deleted file mode 100644 index 2e40b3ad0c4..00000000000 --- a/Master/texmf-dist/doc/latex/platex-tools/bounddvi-en.tex +++ /dev/null @@ -1,133 +0,0 @@ -%# -*- ascii characters only -*- - -% Package v1.0--v6.0: Koichi INOUE -% Package v7.0-- : Hironobu Yamashita -% The package documentation (this file) was -% written by Hironobu Yamashita. - -\documentclass[a4paper]{article} -\usepackage{doc} -\usepackage{bounddvi} -\GetFileInfo{bounddvi.sty} -\title{Package \textsf{bounddvi} \fileversion} -\author{Koichi Inoue \& Hironobu Yamashita} -\date{\filedate} -\begin{document} - -\maketitle - -Package \textsf{bounddvi} sets papersize special into DVI file. -This package can be used in both tate (vertical) and yoko (horizontal) -writing directions of Japanese p\LaTeX/up\LaTeX, and both -\texttt{dvipdfmx} and \texttt{dvips} drivers are supported. -The \texttt{tombow} option defined in Japanese p\LaTeX\ kernel is -also supported. Of course, this package can be used also with the -original \LaTeX\ in DVI output mode. - -This package (after v7.0) is part of \textsf{platex-tools} bundle: -\begin{verbatim} - https://github.com/aminophen/platex-tools -\end{verbatim} - -\section*{Usage} - -Load this package in preamble. -\begin{verbatim} - \documentclass[a5paper]{article} - \usepackage{bounddvi} - ... -\end{verbatim} -Process the \texttt{.tex} file using \texttt{latex} + -\texttt{dvips} chain or \texttt{latex} + \texttt{dvipdfmx} chain. - -\section*{Known limitations} - -\begin{enumerate} -\item The compatibility with \textsf{geometry} package may not be -perfect, as both \textsf{geometry} and \textsf{bounddvi} embeds -papersize special into a DVI file. The loading order of these -two packages may affect the actual size of output. -\item This package supports ``\textsf{jsclasses}-like employment'' -of \verb+\mag+, because it's more widely used in Japan. This may -be incompatible with some classes or packages which employ -\verb+\mag+ in other ways. -\end{enumerate} -The details are described in the sections below. - -\subsection*{The behavior of multiple papersize specials} - -Sometimes multiple papersize specials may be embedded into a DVI -file. Among these specials, the specification which appears -\emph{at last} in DVI takes effect when \texttt{dvipdfmx} or -\texttt{dvips} (\TeX\ Live 2017 or later) is used\footnote{% -When \texttt{dvips} in \TeX\ Live 2016 or earlier is used, -the specification which appears \emph{first} in DVI took effect, -but the default behavior was changed in \TeX\ Live r42420 to -be compatible with \texttt{dvipdfmx}. The new option \texttt{-L0} -can be used to recover the old behavior.}. For example, when the -following source is processed with \texttt{dvipdfmx}, -\begin{verbatim} - % latex + dvipdfmx - \documentclass{...} - \usepackage{bounddvi} - \usepackage[dvipdfm]{geometry} -\end{verbatim} -the specification by \textsf{geometry} wins. - -\section*{Note about \texttt{\char92mag} handling} - -Among the packages in CTAN, there are two types of implementation -in terms of \verb+\mag+ employment. It seems that there is no -(official or practical) ``standard'' in \verb+\mag+ treatment. - -When the output is going to the physical size of A4 -($210\,\mathrm{mm} \times 297\,\mathrm{mm}$) with the setting of -\verb+\mag=2000+, there are two ways: some classes/packages can set -\begin{quote} - \texttt{\char92mag=2000}\\ - \texttt{\char92paperwidth=210mm} ($= 420\,\mathrm{truemm}$)\\ - \texttt{\char92paperheight=297mm} ($= 594\,\mathrm{truemm}$) -\end{quote} -and others can set -\begin{quote} - \texttt{\char92mag=2000}\\ - \texttt{\char92paperwidth=105mm} ($= 210\,\mathrm{truemm}$)\\ - \texttt{\char92paperheight=148.5mm} ($= 297\,\mathrm{truemm}$) -\end{quote} -The first way is adopted by \textsf{geometry} package etc, and it's -(probably) based on the behavior of the \verb+papersize+ special of -\texttt{dvips}. It does not handle true units properly, and accepts -only non-true units and evaluates them as if they were true units. -The second way is adopted by \textsf{jsclasses} document class etc, -and is also suppoted by \verb+pdf:pagesize+ special of -\texttt{dvipdfm(x)}. This can be more consistent with \LaTeX, since -all other layout parameters (e.g. \verb+\textwidth+) are set -according to the unit truemm. - -The \textsf{bounddvi} supports the latter, so some classes/packages -which are based on the former may or may not work properly when -using \textsf{bounddvi} package. - -\section*{References} - -\begin{itemize} -\item Setting paper size using \texttt{dvips} \& \texttt{dvipdfm} - (description in Japanese)\\ - \texttt{https://www.ma.ns.tcu.ac.jp/Pages/TeX/bounddvi.sty.html} -\end{itemize} - -\section*{ChangeLog} - -\begin{itemize} - \item 2002/03/10 v1.0 (KI) First version - \item 2002/10/30 v2.0 (KI) Add \texttt{dvipdfm} \texttt{pdf:pagesize} special - \item 2003/03/22 v3.2 (KI) Compatibility with \textsf{hyperref} - \item 2004/05/08 v4.0 (KI) Support for $\mathtt{\char92mag} \ne 1000$ - \item 2004/12/08 v5.2 (KI) Compatibility with \textsf{geometry} - \item 2004/12/15 v6.0 (KI) Not to use \texttt{dvipdfm(x)} \texttt{pdf:pagesize special} - \item 2016/10/25 v7.1 (HY) Support for p\LaTeXe\ tombow option, - compatibility with \textsf{graphics}/\textsf{color} packages - \item 2016/12/28 v7.2 (HY) Documentation for the new \texttt{dvips} behavior -\end{itemize} - -\end{document} diff --git a/Master/texmf-dist/doc/latex/platex-tools/bounddvi.pdf b/Master/texmf-dist/doc/latex/platex-tools/bounddvi.pdf Binary files differdeleted file mode 100644 index 9170bfdc12b..00000000000 --- a/Master/texmf-dist/doc/latex/platex-tools/bounddvi.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/platex-tools/bounddvi.tex b/Master/texmf-dist/doc/latex/platex-tools/bounddvi.tex deleted file mode 100644 index 5b811e2b197..00000000000 --- a/Master/texmf-dist/doc/latex/platex-tools/bounddvi.tex +++ /dev/null @@ -1,146 +0,0 @@ -%# -*- coding: utf-8 -*- -\ifx\epTeXinputencoding\undefined\else % defined in e-pTeX (> TL2016) - \epTeXinputencoding utf8 % ensure utf-8 encoding for platex -\fi - -% パッケージ作者 (v1.0--v6.0):東京都市大学(旧称・武蔵工業大学)井上浩一 -% 修正版 (v7.0--) および本ドキュメント:山下弘展 (Hironobu Yamashita) - -\documentclass[a4paper]{jsarticle} -\usepackage{doc} -\usepackage{bounddvi} -\GetFileInfo{bounddvi.sty} -\title{Package \textsf{bounddvi} \fileversion} -\author{Koichi Inoue \& Hironobu Yamashita} -\date{\filedate} -\begin{document} - -\maketitle - -DVIファイルは用紙サイズ情報を含みませんが、PostScriptやPDFといった -用紙サイズを規定するフォーマットへ変換するプログラム(\texttt{dvips}や -\texttt{dvipdfmx})は、\verb+\special+命令によってDVIファイルに埋め込ま -れた用紙サイズ情報を解釈します。 -たとえば、幅100mm、高さ200mmの用紙に出力したい場合は -\begin{verbatim} - \special{papersize=100mm,200mm} -\end{verbatim} -のように指定してやることができます。 - -\textsf{bounddvi}パッケージは、クラスファイルなどが想定している用紙 -サイズ情報(\verb+\paperwidth+, \verb+\paperheight+)をDVIファイルに -\verb+\special+命令として埋め込むことで、\texttt{dvips}や -\texttt{dvipdfmx}の出力用紙サイズを指定する機能を提供します。 -\begin{verbatim} - \documentclass[a4j]{jarticle} - \usepackage{bounddvi} - \begin{document} - …本文… - \end{document} -\end{verbatim} -のように使います。p\LaTeX における横組と縦組の両方で使え、また -版面拡大(\verb+\mag+)が使われた場合にも対応しています(詳細は付録 -を参照してください)。また、v7.0以降、p\LaTeX カーネルのトンボ -オプションを使用した場合にも対応しており、p\LaTeX が仮定している -「トンボのノビ(2in)を含めたサイズ」に設定します。 - -本パッケージはv7.0以降、\textsf{platex-tools}バンドルの一部として -配布されています: -\begin{verbatim} - https://github.com/aminophen/platex-tools -\end{verbatim} - -\section*{他のパッケージとの互換性} - -用紙サイズ設定機能だけを提供する\textsf{bounddvi}パッケージのほかにも、 -パッケージの機能の一部として用紙サイズ設定を行うものがいくつかあります。 -\begin{itemize} -\item 日本語環境でよく用いられる、p\LaTeX/up\LaTeX 用のクラスファイル - \textsf{jsclasses}(奥村さん作)の\texttt{papersize}オプション - との併用は問題ありません(ただし、このオプションを使用すれば用紙 - サイズ設定には十分ですから、本\textsf{bounddvi}パッケージを併用 - することにも特にメリットはありません)。 -\item 2016年以降の\textsf{graphics/graphicx}パッケージや - \textsf{color}パッケージには用紙サイズ設定機能 - (\texttt{setpagesize}オプション:デフォルトで有効)が - ありますが、併用しても問題は起きないでしょう。 -\item \textsf{hyperref}パッケージも上と同様で、併用しても - 問題は起きないでしょう。 -\item \textsf{geometry}パッケージと併用する場合は、 - 本\textsf{bounddvi}パッケージを\emph{後から}読み込むほうが - 安全でしょう。特に、\texttt{dvipdfmx}を使用して変換する場合に - トンボを付けたいなら、\textsf{bounddvi}を後から読み込むことで - うまくいく可能性があります(付録を参照)。 -\end{itemize} - -\section*{付録:複数の用紙サイズ指定が発行された場合の挙動} - -一つのDVIファイルに複数の用紙サイズ指定\verb+\special+命令が -埋め込まれる場合があります。このうち、\texttt{dvipdfmx}および -\TeX\ Live 2017以降の\texttt{dvips}では、DVIファイルの\emph{最後}に -指定されたものが有効になります\footnote{\TeX\ Live 2016以前の -\texttt{dvips}では、DVIファイルの\emph{最初}に指定されたものが有効 -でしたが、\TeX\ Live r42420で挙動が変更されました。\texttt{-L0}オプ -ションを指定すると従来の挙動に戻ります。}。たとえば\textsf{bounddvi}と -\textsf{geometry}を併用したソース -\begin{verbatim} - \documentclass{...} - \usepackage{bounddvi} - \usepackage[dvipdfm]{geometry} -\end{verbatim} -を\textsf{dvipdfmx}でPDFに変換すると、\textsf{geometry}パッケージの -指定が優先されます。このとき、用紙サイズの設定が正しいかどうかは -\textsf{geometry}パッケージに依存します。 - -\section*{付録:\texttt{\char92mag}の扱いについて} - -本\textsf{bounddvi}パッケージは、日本で広く使われている奥村さんの -\textsf{jsclasses}クラス流の\verb+\mag+の用法をサポートしています。 -しかし、\verb+\mag+の使い方はCTANにある多様なパッケージの中で統一 -されておらず、大きく分けて二通りの使い方があるようです。 - -たとえば、版面を2倍に拡大 (\verb+\mag=2000+) して物理的なA4サイズ -($210\,\mathrm{mm}\times297\,\mathrm{mm}$)の出力を得たい場合 -\begin{quote} - \texttt{\char92mag=2000}\\ - \texttt{\char92paperwidth=210mm} ($= 420\,\mathrm{truemm}$)\\ - \texttt{\char92paperheight=297mm} ($= 594\,\mathrm{truemm}$) -\end{quote} -と設定するものと -\begin{quote} - \texttt{\char92mag=2000}\\ - \texttt{\char92paperwidth=105mm} ($= 210\,\mathrm{truemm}$)\\ - \texttt{\char92paperheight=148.5mm} ($= 297\,\mathrm{truemm}$) -\end{quote} -と設定するものとが存在します。 -前者は\textsf{geometry}パッケージなどの方式で、おそらく\texttt{dvips}の -\verb+papersize+ specialの挙動(truedimenを正しく解釈せず、trueの付か -ない単位だけを受け付けてあたかもtrue付であるかのように評価)に則った -ものでしょう。後者は\textsf{jsclasses}クラスの方式で、これは -\texttt{dvipdfm(x)}の\verb+pdf:pagesize+ specialとも同じです。 -この方式のほうが、truedimenで設定された\LaTeX のほかのレイアウト変数 -(\verb+\textwidth+など)に対して一貫性があると思われます。 -本\textsf{bounddvi}パッケージがサポートしているのは後者の方式です。 - -\section*{参考} - -\begin{itemize} -\item dvipsやdvipdfmなどで用紙サイズを出力\\ - \texttt{https://www.ma.ns.tcu.ac.jp/Pages/TeX/bounddvi.sty.html} -\end{itemize} - -\section*{変更履歴} - -\begin{itemize} - \item 2002/03/10 v1.0 (KI) 最初の公開版 - \item 2002/10/30 v2.0 (KI) \texttt{dvipdfm}の\texttt{pdf:pagesize special}を使用 - \item 2003/03/22 v3.2 (KI) \textsf{hyperref}との互換性を改良 - \item 2004/05/08 v4.0 (KI) $\mathtt{\char92mag} \ne 1000$に対応 - \item 2004/12/08 v5.2 (KI) \texttt{dvips}で\textsf{geometry}との互換性を改良 - \item 2004/12/15 v6.0 (KI) \texttt{dvipdfm(x)}の\texttt{pdf:pagesize special}を不使用に - \item 2016/10/25 v7.1 (HY) p\LaTeXe{}のトンボサポート、 - 2016年の新しい\textsf{graphics}/\textsf{color}に対応 - \item 2016/12/28 v7.2 (HY) 新仕様の\texttt{dvips}をドキュメント化 -\end{itemize} - -\end{document} diff --git a/Master/texmf-dist/doc/latex/platex-tools/gentombow.pdf b/Master/texmf-dist/doc/latex/platex-tools/gentombow.pdf Binary files differdeleted file mode 100644 index 3c3050bfbe0..00000000000 --- a/Master/texmf-dist/doc/latex/platex-tools/gentombow.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/platex-tools/gentombow.tex b/Master/texmf-dist/doc/latex/platex-tools/gentombow.tex deleted file mode 100644 index fc1d8f40f09..00000000000 --- a/Master/texmf-dist/doc/latex/platex-tools/gentombow.tex +++ /dev/null @@ -1,209 +0,0 @@ -%# -*- ascii characters only -*- - -\documentclass[a4paper]{article} -\usepackage{doc} -\makeatletter -%%% dangerous bend -\font\man=manfnt at 10pt -\def\dbend{\leavevmode\raise0pt\hbox{\man\char'177}} -\newenvironment{dangerous}{% - \ifnum\@listdepth>\z@ - \GenericError{}{Do not use `dangerous' environment inside any list}{}{} - \fi - \par\addvspace\medskipamount - \@tempdima=\dimexpr\textwidth-2zw\relax\small - \divide\@tempdima by\dimexpr1zw\relax\@tempcnta=\@tempdima - \leftskip=\dimexpr\textwidth-\@tempcnta zw\relax - \@totalleftmargin\dimexpr\leftskip+0zw - \linewidth=\dimexpr\@tempcnta zw-0zw - \parindent1zw\noindent\kern-\leftskip\hbox to\leftskip{\dbend\hss}% - \everypar{\everypar{}}\ignorespaces -}{\par\addvspace\medskipamount} -%%% misc -\newcommand{\Meta}[1]{$\langle$\mbox{}\textit{#1}\mbox{}$\rangle$} -%%% -\makeatother -\usepackage{longtable} -\usepackage{gentombow} -\usepackage{bxpapersize} -\GetFileInfo{gentombow.sty} -\title{Package \textsf{gentombow} \fileversion} -\author{Hironobu Yamashita} -\date{\filedate} -\begin{document} - -\maketitle - -It is convenient to print documents for final smaller paper sizes -on paper of the printer's standard physical paper size; -it allows printing close to the logical paper edge -and even outside the logical page. - -This package \textsf{gentombow} provides a Japanese-style -crop marks (called `tombow' in Japanese) for trimming paper stacks, -and place the document page at the center of a larger physical -paper sheet. It automatically detects the page size -(\verb+\paperwidth+, \verb+\paperheight+) which is -going to set by document class. -This document itself is a demonstration of this package, -with final A4 paper printed on B4 (JIS B4; not ISO B4!) paper. - -Note that this package does nothing about output paper size -specification; use one of the followings to do it. -\begin{itemize} -\item \textsf{graphicx} package - with \texttt{setpagesize} feature added in 2016 - (supports all engines) -\item \textsf{bxpapersize} package - (supports all engines; by Takayuki YATO) -\item \textsf{bounddvi} package - (supports only DVI output mode; part of \textsf{platex-tools} bundle) -\end{itemize} - -A basic usage: -\begin{verbatim} - \documentclass[a4paper]{article} - \usepackage{gentombow} - \usepackage{graphicx} - \begin{document} - The content - \end{document} -\end{verbatim} -For Japanese people, \textsf{pxgentombow} (also part of -\textsf{platex-tools} bundle) is also available; -it requires Japanese p\LaTeX/up\LaTeX\ or Lua\TeX-ja. - -This package is part of \textsf{platex-tools} bundle: -\begin{verbatim} - https://github.com/aminophen/platex-tools -\end{verbatim} - -\section*{Automatic Determination of Output Size} - -In this package, -the following printer's standard physical paper sizes are predefined; -A series (\texttt{a0}--\texttt{a10}), -B series (\texttt{b0}--\texttt{b10}), -C series (\texttt{c0}--\texttt{c10}), -\texttt{letter}, \texttt{legal} and \texttt{executive}. -In the current release, `B series' is JIS standard, -not ISO standard (this might be changed in the near future). -Also, some variations \texttt{a4var} and \texttt{b5var} are predefined. - -When one of the above sizes (except \texttt{a0}, \texttt{b0} -and \texttt{c0}) is detected, the output size is -automatically determined along with the following rule: -\begin{itemize} -\item When A series detected: - the output is going to be larger B series -\item When B/C series or - \texttt{letter}, \texttt{legal}, \texttt{executive} detected: - the output is going to be larger A series -\end{itemize} -The crop marks are automatically added. -The orientation (landscape/portrait) of the input paper is -also preserved. - -The following list shows common examples: -\begin{longtable}[c]{cc} - \hline - Detected page size & Output size \\ - \hline - a6 & b6 \\ - b6 & a5 \\ - a5 & b5 \\ - b5 & a4 \\ - a4 & b4 \\ - b4 & a3 \\ - a3 & b3 \\ - b3 & a2 \\ - \hline - c6 & a5 \\ - c5 & a4 \\ - c4 & a3 \\ - c3 & a2 \\ - \hline - letter & a3 \\ - legal & a3 \\ - executive & a4 \\ - \hline -\end{longtable} - -\section*{When Automatic Determination Failed} - -When the page size is different from any of the predefined sizes, -the page is placed with the surrounding 1~inch margins. -For example, when the page has $100\,\mathrm{mm}$ width and -$200\,\mathrm{mm}$ height, the output size is going to be -$100\,\mathrm{mm}+2\,\mathrm{in}$ width and -$200\,\mathrm{mm}+2\,\mathrm{in}$ height. - -\section*{Explicit Specification of Output Size} - -You can also force the output size using package option. -For example, -\begin{verbatim} - \documentclass[a4paper]{article} - \usepackage[tombow-a4]{gentombow} - \begin{document} - The content - \end{document} -\end{verbatim} -forces the output size to be a3 (the automatic determination -`b4' is discarded). Available sizes are the same as -the predefined sizes, that is, -A series (\texttt{a0}--\texttt{a10}), -B series (\texttt{b0}--\texttt{b10}), -C series (\texttt{c0}--\texttt{c10}) and -\texttt{a4var}, \texttt{b5var}, -\texttt{letter}, \texttt{legal}, \texttt{executive}. -The orientation (landscape/portrait) of the input paper is -also preserved again. - -The option format is: -\Meta{crop mark format}\texttt{-}\Meta{output size}. -The crop mark format is one of the following: -\verb+tombow+ (default), \verb+tombo+ (without a job info), -\verb+mentuke+ (do not print actual crop marks). - -\section*{Disabling Job Info Printing} - -When the output size is automatically determined, -the crop marks are printed with a job info like -\makeatletter\texttt{\the\@bannertoken}\makeatother. -To disable it, use \texttt{notombowdate} option: -\begin{verbatim} - \documentclass[a4j]{jarticle} - \usepackage[notombowdate]{gentombow} - \begin{document} - The content - \end{document} -\end{verbatim} - -\section*{Note for \textsf{BXjscls} users} - -When using \textsf{BXjscls} (by Takayuki YATO) with size option -other than 10pt, please add \verb+nomag+ or \verb+nomag*+ to the -class option. For example, -\begin{verbatim} - \documentclass[a4paper,14pt]{bxjsarticle} - \usepackage{gentombow} -\end{verbatim} -will not work as expected (\textsf{gentombow} throws an error -for safety). - -\section*{Note about Layout Settings} - -You should not change \verb+\hoffset+ or \verb+\voffset+ to non-zero -value, for the purpose of layout settings. Such settings will -conflict with the feature of \textsf{gentombow} package. -To set page layout correctly, you should adjust \verb+\oddsidemargin+ -or \verb+\topmargin+, or leave it to \textsf{geometry} package. - -\section*{Change History} - -\begin{itemize} - \item 2017/12/17 v0.9 First CTAN release -\end{itemize} - -\end{document} diff --git a/Master/texmf-dist/doc/latex/platex-tools/plarray.pdf b/Master/texmf-dist/doc/latex/platex-tools/plarray.pdf Binary files differindex afc326e30ed..32b18beaa03 100644 --- a/Master/texmf-dist/doc/latex/platex-tools/plarray.pdf +++ b/Master/texmf-dist/doc/latex/platex-tools/plarray.pdf diff --git a/Master/texmf-dist/doc/latex/platex-tools/pxgentombow.pdf b/Master/texmf-dist/doc/latex/platex-tools/pxgentombow.pdf Binary files differdeleted file mode 100644 index d4acb81f837..00000000000 --- a/Master/texmf-dist/doc/latex/platex-tools/pxgentombow.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/platex-tools/pxgentombow.tex b/Master/texmf-dist/doc/latex/platex-tools/pxgentombow.tex deleted file mode 100644 index e460a97a3b5..00000000000 --- a/Master/texmf-dist/doc/latex/platex-tools/pxgentombow.tex +++ /dev/null @@ -1,329 +0,0 @@ -%# -*- coding: utf-8 -*- -\ifx\epTeXinputencoding\undefined\else % defined in e-pTeX (> TL2016) - \epTeXinputencoding utf8 % ensure utf-8 encoding for platex -\fi - -\documentclass[a4paper]{jsarticle} -\usepackage{doc} -\makeatletter -%%% import from jltxdoc.cls -\def\verb{\relax\ifmmode\hbox\else\leavevmode\vadjust{}\fi - \bgroup \let\do\do@noligs \verbatim@nolig@list - \ttfamily \verb@eol@error \let\do\@makeother \dospecials - \@ifstar{\@sverb}{\@vobeyspaces \frenchspacing \@sverb}} -\xspcode"5C=3 %% \ -\xspcode"22=3 %% " -%%% dangerous bend -\font\man=manfnt at 10pt -\def\dbend{\leavevmode\raise0pt\hbox{\man\char'177}} -\newenvironment{dangerous}{% - \ifnum\@listdepth>\z@ - \GenericError{}{Do not use `dangerous' environment inside any list}{}{} - \fi - \par\addvspace\medskipamount - \@tempdima=\dimexpr\textwidth-2zw\relax\small - \divide\@tempdima by\dimexpr1zw\relax\@tempcnta=\@tempdima - \leftskip=\dimexpr\textwidth-\@tempcnta zw\relax - \@totalleftmargin\dimexpr\leftskip+0zw - \linewidth=\dimexpr\@tempcnta zw-0zw - \parindent1zw\noindent\kern-\leftskip\hbox to\leftskip{\dbend\hss}% - \everypar{\everypar{}}\ignorespaces -}{\par\addvspace\medskipamount} -%%% misc -\newcommand{\Meta}[1]{$\langle$\mbox{}\textit{#1}\mbox{}$\rangle$} -\newcommand{\jMeta}[1]{$\langle$\mbox{}\textsf{#1}\mbox{}$\rangle$} -%%% -\makeatother -\usepackage{longtable} -\usepackage{pxgentombow} -\usepackage{bounddvi} -\GetFileInfo{pxgentombow.sty} -\title{Package \textsf{pxgentombow} \fileversion} -\author{Hironobu Yamashita} -\date{\filedate} -\begin{document} - -\maketitle - -\begin{center} -English version is available: see \textsf{gentombow} package! -\end{center} - -日本の出版では、たとえば仕上がり寸法がA4サイズの場合、一回り大きな -B4サイズの用紙の中央にトンボ付きで印刷することがあるようです。 -このドキュメントは、実際にA4用紙をB4用紙の中央にトンボ付きで -配置している事例です。 - -\textsf{pxgentombow}パッケージは、クラスファイルなどが想定している用紙 -サイズ情報(\verb+\paperwidth+, \verb+\paperheight+)を検知し、 -それより一回り大きなサイズの用紙の中央にトンボ付きで出力するために -必要な機能を提供します。 -ただし、このパッケージは実際の出力サイズ指定を発行しませんので、 -以下のいずれかのパッケージと併用するとよいでしょう: -\begin{itemize} -\item \textsf{bounddvi}パッケージ(\textsf{platex-tools}バンドル) -\item \textsf{bxpapersize}パッケージ(ZRさん作) -\item \textsf{graphicx}パッケージの2016年以降の版 - (\texttt{setpagesize}機能つきのもの) -\end{itemize} -\textsf{bounddvi}パッケージは、\textsf{pxgentombow}と同じく -\textsf{platex-tools}バンドルに収録されていますが、 -名前のとおりDVIを経由する場合にしか利用できません。 -一方、\textsf{bxpapersize}パッケージは汎用で、Lua\TeX のような -PDF直接出力の場合にも利用できます。また、\textsf{graphicx}パッケージ -は画像挿入用のパッケージですが、2016年以降は自動的に出力サイズ指定も -行うようです($\verb+\mag+ \ne 1000$の場合には機能しません)。 - -使い方の例は -\begin{verbatim} - \documentclass[a4j]{jarticle} - \usepackage{pxgentombow} - \usepackage{bounddvi} - \begin{document} - …本文… - \end{document} -\end{verbatim} -です。p\LaTeX における横組と縦組の両方で使え、また\textsf{jsclasses}の -ような版面拡大(\verb+\mag+)が使われた場合にも対応しています。 -なお、\textsf{pxgentombow}パッケージはp\LaTeX とup\LaTeX および -Lua\TeX-jaのみで動作します。その他(pdf\LaTeX など)で使いたい -場合は、代わりに\textsf{gentombow}パッケージを使用してください。 - -本パッケージは、\textsf{platex-tools}バンドルの一部として -配布されています: -\begin{verbatim} - https://github.com/aminophen/platex-tools -\end{verbatim} - -\section*{用紙サイズの自動検知による出力サイズ決定} - -パッケージにはあらかじめA系列(\texttt{a0}--\texttt{a10})、 -B系列(\texttt{b0}--\texttt{b10})、C系列(\texttt{c0}--\texttt{c10})と -\texttt{letter}, \texttt{legal}, \texttt{executive}の用紙サイズが -定義されています。ここで、B系列はISOではなくJISです。 -また、変型版として\texttt{a4var}(\texttt{a4}の変型)と -\texttt{b5var}(\texttt{b5}の変型)も定義されています。 - -これらのうちいずれか(ただし\texttt{a0}, \texttt{b0}, \texttt{c0}を -除く)の用紙サイズを検知すると、 -出力サイズが次の規則で自動的に決定されます\footnote{なお、 -C系列と\texttt{letter}, \texttt{legal}, \texttt{executive}については -日本での慣習が不明の -ため、現時点ではA系列のサイズで出力することにしています。}。 -\begin{itemize} -\item 用紙サイズがA系列のとき: - 出力サイズは一回り大きなB系列 -\item 用紙サイズがB, C系列または - \texttt{letter}, \texttt{legal}, \texttt{executive}のとき: - 出力サイズは一回り大きなA系列 -\end{itemize} -この場合、パッケージを読みこんだだけでトンボが付きます。 -なお、用紙サイズが横長の場合は自動的に出力も横長になり、 -縦長の場合は自動的に縦長になります。 - -よく使われる用紙サイズの例を挙げます。 -\begin{longtable}[c]{cc} - \hline - 用紙サイズ & 出力サイズ \\ - \hline - a6 & b6 \\ - b6 & a5 \\ - a5 & b5 \\ - b5 & a4 \\ - a4 & b4 \\ - b4 & a3 \\ - a3 & b3 \\ - b3 & a2 \\ - \hline - c6 & a5 \\ - c5 & a4 \\ - c4 & a3 \\ - c3 & a2 \\ - \hline - letter & a3 \\ - legal & a3 \\ - executive & a4 \\ - \hline -\end{longtable} - -\section*{用紙サイズの自動検知に失敗した場合の出力サイズ決定} - -仮に用紙サイズが定義済みのいずれとも異なる場合は、デフォルトでは -用紙の天地左右に1インチずつのノビを付けたサイズで出力します。 -たとえば、幅$100\,\mathrm{mm}$、高さ$200\,\mathrm{mm}$の用紙の場合、 -出力サイズは幅$100\,\mathrm{mm}+2\,\mathrm{in}$、 -高さ$200\,\mathrm{mm}+2\,\mathrm{in}$になります。 - -\section*{オプションによる出力サイズの明示指定} - -自動決定されるサイズと異なるサイズに出力したい場合、 -パッケージオプションで明示的に指定することができます。たとえば -\begin{verbatim} - \documentclass[a4j]{jarticle} - \usepackage[tombow-a3]{pxgentombow} - \begin{document} - …本文… - \end{document} -\end{verbatim} -とすると、出力サイズは(自動決定のb4は無視されて)a3に変わります。 -指定可能なサイズは、定義済みの用紙サイズと同じものです。すなわち、 -A系列(\texttt{a0}--\texttt{a10})、 -B系列(\texttt{b0}--\texttt{b10})、 -C系列(\texttt{c0}--\texttt{c10})と -\texttt{a4var}, \texttt{b5var}, -\texttt{letter}, \texttt{legal}, \texttt{executive}です。 -なお、ここでも用紙サイズが横長の場合は自動的に出力も横長になり、 -縦長の場合は自動的に縦長になります。 - -オプションは\jMeta{トンボ形式}\texttt{-}\jMeta{出力サイズ}の書式で与えます。 -トンボ形式は、p\LaTeX の標準クラスと同じで -\verb+tombow+, \verb+tombo+, \verb+mentuke+のいずれかを選びます -(\verb+tombow+はジョブ情報を表示し、\verb+tombo+は表示しません。 -また、\verb+mentuke+はトンボの線を表示しません)。 - -\section*{トンボに表示するジョブ情報の有無} - -用紙サイズの自動検知によって出力サイズが決まる場合、デフォルトでは -\makeatletter\texttt{\the\@bannertoken}\makeatother -のようにトンボにジョブ情報が出力されます。これを無効化するには -\begin{verbatim} - \documentclass[a4j]{jarticle} - \usepackage[notombowdate]{pxgentombow} - \begin{document} - …本文… - \end{document} -\end{verbatim} -とします。 - -\section*{\textsf{jsclasses}で使用する場合の注意} - -奥村晴彦氏による\textsf{jsclasses}のクラス(2016年以降は日本語\TeX 開発 -コミュニティが管理)を使用していて、10pt以外のサイズオプションを -指定する場合は、以下のいずれかの方法をとってください。 -\begin{itemize} -\item クラスオプションに「トンボオプション」 - (\verb+tombow+または\verb+tombo+)を追加する。 -\item クラスオプションに「\verb+\mag+を使わないオプション」 - (\verb+nomag+または\verb+nomag*+)を追加する。 -\end{itemize} -これは、\textsf{jsclasses}クラス内で行われる\verb+\oddsidemargin+と -\verb+\topmargin+の計算の都合からくる制約です。たとえば -\begin{verbatim} - \documentclass[a4j,14pt]{jarticle} - \usepackage{pxgentombow} -\end{verbatim} -という使い方は\emph{誤り}です(このままでは誤った余白設定が -適用されますので、安全のため\textsf{pxgentombow}パッケージ -がエラーを出すようにしてあります)。代わりに -\begin{verbatim} - \documentclass[a4j,14pt,tombow]{jarticle} - \usepackage{pxgentombow} -\end{verbatim} -と書くようにしてください。 - -同様に、ZR氏による\textsf{BXjscls}のクラスを使用していて、10pt以外の -サイズオプションを指定する場合は -\begin{itemize} -\item クラスオプションに「\verb+\mag+を使わないオプション」 - (\verb+nomag+または\verb+nomag*+)を追加する。 -\end{itemize} -という対処が必要です(\textsf{BXjscls}クラスでは「トンボオプション」が -機能しないダミーになっていることに注意)。 - -\section*{レイアウト設定の注意} - -余白などのレイアウト設定でありがちですが、 -\verb+\hoffset+や\verb+\voffset+の値を$0$以外に設定するのは -避けてください。このような設定は\textsf{pxgentombow}パッケージの -トンボ出力機能と衝突するため、正しい出力が得られません。 -レイアウト設定のために変更すべきなのはこれらの寸法ではなく、 -\verb+\oddsidemargin+や\verb+\topmargin+であることがほとんどです。 -したがって、それらを適切な値に設定するか、レイアウトの設定すべてを -\textsf{geometry}パッケージに任せてしまうのも一つの方法です。 - -\begin{dangerous} -たとえば左右の余白を$25\,\mathrm{mm}$に、上下の余白を -$30\,\mathrm{mm}$にしたいとき\footnote{ここでは「本文の領域以外」を -余白と定義します。すなわち、ヘッダとフッタは余白の一部です。}、 -まず「\TeX の1インチ」を -削除してから\verb+\oddsidemargin+や\verb+\topmargin+を変更すると、 -「見かけ上は」期待どおりの結果になることがあります。 -\begin{verbatim} - \setlength{\hoffset}{-1in}% <== NG - \setlength{\voffset}{-1in}% <== NG - \setlength{\oddsidemargin}{25mm} - \setlength{\topmargin}{30mm} - \setlength{\textwidth}{\paperwidth} - \addtolength{\textwidth}{-2\oddsidemargin} - \setlength{\textheight}{\paperheight} - \addtolength{\textheight}{-2\topmargin} - \addtolength{\topmargin}{-\headheight} - \addtolength{\topmargin}{-\headsep} -\end{verbatim} -しかし、この設定では\textsf{pxgentombow}パッケージがトンボを -追加するとき、正しい余白を維持することができません。 - -一方、\verb+\hoffset+や\verb+\voffset+は$0$のままで、以下のように -\verb+\oddsidemargin+や\verb+\topmargin+を設定していれば問題ありません。 -\begin{verbatim} - \setlength{\oddsidemargin}{-0.4mm}% 25mm = 1inch - 0.4mm - \setlength{\topmargin}{4.6mm}% 30mm = 1inch + 4.6mm - \setlength{\textwidth}{\paperwidth} - \addtolength{\textwidth}{-50mm} - \addtolength{\topmargin}{-\headheight} - \addtolength{\topmargin}{-\headsep} - \setlength{\textheight}{\paperheight} - \addtolength{\textheight}{-60mm} -\end{verbatim} -これと同等のレイアウト設定は、以下のように\textsf{geometry}パッケージで -行うのが簡単です。 -\begin{verbatim} - \usepackage[lmargin=25mm,rmargin=25mm, - tmargin=30mm,bmargin=30mm]{geometry} -\end{verbatim} -\end{dangerous} - -\section*{雑記} - -発端はこの話です。 -\begin{itemize} -\item 齋藤修三郎 (@psi\_tau) on Twitter, 2017年2月9日\\ - \texttt{https://twitter.com/psi\_tau/status/829873082911248386} -\end{itemize} - -また、現在検討中の事項を挙げておきます。 -\begin{itemize} -\item 現状では、用紙の横長・縦長がそのまま出力に反映されるので、 - これを逆転させるオプションの実装。また、任意の出力サイズを - 指定できるインタインタフェースの実現。 -\item 自動で決定できる出力サイズの拡張。現状では用紙サイズが - 定義値に完全一致する場合のみ自動決定されるが、中間のサイズでも - その一回り大きなサイズに出力することは可能と思われる。 -\item 出版用途ではカラー印刷の場合に、CMYKの版ごとにトンボを作る - 必要がある。\textsf{color}パッケージが読み込まれている場合に、 - オプション次第でCKなど必要に応じた色を選べるようにするとよい - のではないか\footnote{ただし作者の本業は出版ではないので、 - 商用を含む実用には程遠いかもしれない。}。 -\item $\verb+\mag+ \ne 1000$の場合について、\textsf{jsclasses}以外での - 動作は未確認。特に、\textsf{geometry}とは共存しない可能性が高い。 -\item \verb+\stockwidth+/\verb+\stockheight+が - \verb+\paperwidth+/\verb+\paperheight+より小さい場合の動作。 - 現在は警告を出すだけとしているが、さらに天地左右1inに - フォールバックしたほうが無難だろうか。 -\item p\LaTeX/up\LaTeX/Lua\TeX-ja以外のサポート。 -\end{itemize} - -\section*{変更履歴} - -\begin{itemize} - \item 2017/02/10 v0.1 最初の公開版 - \item 2017/03/01 v0.4 トンボ形式の修正など - \item 2017/05/05 v0.5 \textsf{jsclasses}の$\verb+\mag+ \ne 1000$に対応、 - 最初のCTANリリース版 - \item 2017/05/06 v0.6 \textsf{jsclasses}との共存時のチェック強化、 - Lua\TeX-jaでの動作確認 - \item 2017/07/23 v0.7 ドキュメント更新、CTANリリース版 - \item 2017/12/17 v0.9 \textsf{gentombow}パッケージの新設、CTANリリース版 -\end{itemize} - -\end{document} |