summaryrefslogtreecommitdiff
path: root/language/japanese/platex-tools/pxatbegshi.tex
diff options
context:
space:
mode:
Diffstat (limited to 'language/japanese/platex-tools/pxatbegshi.tex')
-rw-r--r--language/japanese/platex-tools/pxatbegshi.tex82
1 files changed, 82 insertions, 0 deletions
diff --git a/language/japanese/platex-tools/pxatbegshi.tex b/language/japanese/platex-tools/pxatbegshi.tex
new file mode 100644
index 0000000000..c69b1b6ab9
--- /dev/null
+++ b/language/japanese/platex-tools/pxatbegshi.tex
@@ -0,0 +1,82 @@
+%# -*- 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}
+\usepackage{pxatbegshi}
+\GetFileInfo{pxatbegshi.sty}
+\title{Package \textsf{pxatbegshi} \fileversion}
+\author{Hironobu Yamashita}
+\date{\filedate}
+\begin{document}
+
+\maketitle
+
+Package \textsf{atbegshi} (written by Heiko Oberdiek) provides
+a command \verb+\AtBeginShipout{...}+, however it cannot be used
+with Japanese classes for vertical writing (tarticle.cls, etc).
+\begin{verbatim}
+ ! Incompatible direction list can't be unboxed.
+ \AtBeginShipoutAddToBox ...box \AtBeginShipoutBox
+ \kern 0pt}\AtBegShi@restor...
+\end{verbatim}
+The package \textsf{pxatbegshi} provides a patch for \textsf{atbegshi}
+to work with both horizontal and vertical writing.
+
+This package is part of \textsf{platex-tools} bundle:
+\begin{verbatim}
+ https://github.com/aminophen/platex-tools
+\end{verbatim}
+
+\bigskip
+
+Heiko Oberdiek氏による\textsf{atbegshi}パッケージは
+\verb+\AtBeginShipout{...}+というコマンドを提供しますが、これを
+p\LaTeX の縦組クラス(tarticle.clsなど)で使うとエラーが出てしまいます
+\footnote{単に縦組クラスで\textsf{atbegshi}パッケージを読み込んだだけ
+では、エラーは出ないようです。}。
+この\textsf{pxatbegshi}パッケージは、縦組クラスでも
+\textsf{atbegshi}パッケージの機能を使えるようにするためのものです。
+もちろん、横組クラスで\textsf{pxatbegshi}パッケージを使用しても
+問題は起きません。
+
+使いかたは、\textsf{atbegshi}パッケージの代わりに、あるいは
+\textsf{atbegshi}パッケージに追加して、\textsf{pxatbegshi}パッケージを
+読みこむだけです。使用例:
+\begin{verbatim}
+ \documentclass[a4paper]{tarticle}
+ \usepackage[dvipdfmx]{graphicx}
+ \usepackage{pxatbegshi}
+ \AtBeginShipout{%
+ \AtBeginShipoutUpperLeft{%
+ \parbox[t][\paperheight][b]{\paperwidth}{%
+ \includegraphics[width=210truemm]{background.eps}}}}
+ \begin{document}
+ 背景に透かしを入れます。
+ \end{document}
+\end{verbatim}
+
+\section*{謝辞}
+
+本パッケージの実装には、Takayuki Yato (ZR) 氏による
+\textsf{bxpapersize}パッケージを参考にしました
+\footnote{2018/09/21 v0.3までは北川さん (Hironori Kitagawa) による
+「\verb+\AtBegShi@Output+の処理を強引に横組でやらせるコード」
+をベースにしていましたが、v0.4で\verb+\AtBeginShipoutDiscard+へ
+対応させる改修を機に、書き直しました。}。
+
+\section*{References}
+
+\begin{itemize}
+\item utbookでatbegshiパッケージを使いたい\\
+ \texttt{https://oku.edu.mie-u.ac.jp/tex/mod/forum/discuss.php?d=2134}
+\item \relax[tex-jp-build] [ptex] ページ・数式の組方向
+ (※北川さんのコードの初出)\\
+ \texttt{https://github.com/texjporg/tex-jp-build/issues/21}
+\item CTAN: Package \textsf{bxpapersize}\\
+ \texttt{https://ctan.org/pkg/bxpapersize}
+\end{itemize}
+
+\end{document}