From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- language/japanese/jlreq/jlreq-trimmarks.md | 159 +++++++++++++++++++++++++++++ 1 file changed, 159 insertions(+) create mode 100644 language/japanese/jlreq/jlreq-trimmarks.md (limited to 'language/japanese/jlreq/jlreq-trimmarks.md') diff --git a/language/japanese/jlreq/jlreq-trimmarks.md b/language/japanese/jlreq/jlreq-trimmarks.md new file mode 100644 index 0000000000..3d66dd56ef --- /dev/null +++ b/language/japanese/jlreq/jlreq-trimmarks.md @@ -0,0 +1,159 @@ +# jlreq-trimmarks + +## What is this? +This package outputs trim (register) marks. It works with [LuaTeX-ja](https://osdn.jp/projects/luatex-ja/wiki/FrontPage) / pLaTeX / upLaTeX / dvipdfmx / Dvips / dviout and any document class (not only with jlreq class). It provides the following. + +* Output trim marks +* Set TrimBox and BleedBox if possible. +* Set the size of paper. + +Note that this package is independent from [Requirements for Japanese Text Layout](https://www.w3.org/TR/jlreq/) (JLReq). JLReq says nothing about trim marks. + +## Installation +Move jlreq-trimmarks.sty and jlre-helpers.sty to $TEXMF/tex/latex/jlreq. + +## How to use +Load it by `\usepackage` with specifying the TeX engine and the DVI driver. + +```` +\usepackage[dvipdfmx,platex]{jlreq-trimmarks} +```` + +Do not use `tombow` option in the document class. + +## Note +jlreq-trimmarks sets the size of the paper. However, it may not work due to a conflict with other packages. In this case, please use more powerful package, e.g., [bxpapersize](https://github.com/zr-tex8r/BXpapersize). + +## Options +The following package options (keyval style) are available. + +### `platex`, `uplatex`, `lulatex` +Set the engine. If it is not specified, then the engine is + +* the one used in the jlreq class if the jlreq class is loaded. +* guessed one if the jlreq class is not loaded. + +### `dvipdfmx`, `dvips`, `dviout` +Set the dvi driver. You do not have to specify it when using the engine `lualatex`. If it is not specified (with `platex` or `uplatex`), then `dvipdfmx` is used. + +### `trimmarks_paper` +Set the size of the paper including trim marks. + +* `trimmarks_paper=`: specify via the paper type. for the paper type, you can use `a0--a10`, `b0--b10` and `c2--c8`. Note that `b0--b10` is `JIS B' (Japanese B-series variant). +* `trimmarks_paper={,height>}`: specify via the width and height. +* `trimmarks_paper=+{,}` (e.g. `trimmarks_paper=a4+{1cm,2cm}`): `` (resp. ``) is added to the width (resp. height) of the paper size specified by `` For ``, one can use `` or `{,}` as in the above. +* `trimmarks_paper=a4+2cm` is equivalent to `trimmarks_paper=a4+{2cm,2cm}`. +* If `` is empty (e.g. `trimmarks_paper=+2cm`), the current paper size (which is specified usually by the option for the document class) is used. + +### `landscape` +Swap the width and the height. This swaps only the width and height which is specified with the option `trimmarks_paper`. For example, `landscape,trimmarks_paper=+{2cm,1cm}`, adds 1cm to the height and 2cm to the width. But the current paper size is not swapped. + +### `show` +Specify the types of trim marks which the package outputs. It is specified with the comma separated list like `show={trimmarks,banner,digital}`. If no argument is given, everything will be showed. + +* `trimmarks`: outputs the trim marks. +* `banner`: date etc. +* `digital`:TrimBox and BleedBox. +* `no`: nothing will be showed + +### `bleed_margin` +Set the bleed margin. +You can also specify as follows. +```latex +\usepackage[bleed_margin={top=3mm,bottom=5mm,gutter=0mm,fore-edge=2mm}]{jlreq-trimmarks} +``` + +## `\jlreqtrimmarkssetup` +Set the additional settings with the keyval style. + +### `banner` +The things which the package outputs when `show=banner` is specified in the package option. +Normally it is showed in the left of the top. You can also put them in many places with +```latex +\jlreqtrimmarkssetup{ + banner={ + ={ + ={ + ={ + + } + } + } + } +} +``` +Here is an example. +```latex +\jlreqtrimmarkssetup{ + banner={ + top-right={ + vertical={ + odd={In the right of the top, only in odd pages, vertical mode.}, + even={In the right of the top, only in even pages, vertical mode.}, + }, + horizontal={In the right of the top, horizontal mode.}, % does not depend on the parity of the page number + corner={In the corner of the right of the top, horizontal mode.}, + in-horizontal={In the right of the top, horizontal mode, in the trim area.}, + in-vertical={In the right of the top, vertical mode, in the trim area.}, + }, + bottom-center={ + left={In the left in the center of the bottom}, % odd=, even= is also available + right={In the right in the center of the bottom}, + in={In the trim area in the center of the bottom.}, + } + } +} +``` +A possible combination of `top/bottom/center` and `left/right/center/gutter/fore-edge` can be used for the position. +You can use `\thepage` to output the number of the page. + +The keys can be ommited. For example: +```latex +\jlreqtrimmarkssetup{ + banner={ + vertical={Vertical mode, in the top of the left}, + odd={In the top of the left, only in odd pages.}, % regarded as `horizontal` + top-right={ + odd={In the top of the right, only in odd pages, horizontal mode.} + } + } +} +``` + +### `trimmarks_width` +Set the width of trim marks. + +### ` color` +Set the color of the trim marks. You have to load a package which defines `\color` (`color' package or its variant) before loading this package to use this function. Here are some examples of specifying the color. + +* `color=c` -> `\color[cmyk]{1,0,0,0}` +* `color=cyk` -> `\color[cmyk]{1,0,1,1}` +* `black` -> `\color{black}` +* `[cmyk]0.5,0.5,0.5,0` -> `\color[cmyk]{0.5,0.5,0.5,0}` + +## LICENSE +This package is distributed under the BSD 2-Clause License. See [LICENSE](LICENSE). + +## CHANGELOG +* 2018-05-19 + - First release. +* 2018-06-17 + - Fixed a bug. +* 2018-08-08 + - Extended `trimmarks_paper`. + - Added a package option `landscape`. +* 2018-09-01 + - Moved `bleed_margin` from `\jlreqtrimmarkssetup` to a package option. + - jlreq-trimmarks works with unusugal`\mag`. + - Fixed bugs. +* 2018-12-10 + - Extended `banner` in `\jlreqtrimmarkssetup`. +* 2019-04-01 + - Extended `banner` in `\jlreqtrimmarkssetup`. + - Extended `bleed_margin`. + + +-------------- +Noriyuki Abe +https://github.com/abenori/jlreq + -- cgit v1.2.3