diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/jlreq/jlreq-trimmarks.html')
-rw-r--r-- | Master/texmf-dist/doc/latex/jlreq/jlreq-trimmarks.html | 147 |
1 files changed, 116 insertions, 31 deletions
diff --git a/Master/texmf-dist/doc/latex/jlreq/jlreq-trimmarks.html b/Master/texmf-dist/doc/latex/jlreq/jlreq-trimmarks.html index 14be58383be..488b720428c 100644 --- a/Master/texmf-dist/doc/latex/jlreq/jlreq-trimmarks.html +++ b/Master/texmf-dist/doc/latex/jlreq/jlreq-trimmarks.html @@ -88,44 +88,79 @@ <article class="markdown-body"> <h1 id="jlreq-trimmarks">jlreq-trimmarks</h1> <h2 id="what-is-this">What is this?</h2> -<p>This package outputs trim (register) marks. It works with <a href="https://osdn.jp/projects/luatex-ja/wiki/FrontPage">LuaTeX-ja</a> / pLaTeX / upLaTeX / dvipdfmx / Dvips / dviout and any document class (not only with jlreq class). It provides the following.</p> +<p>This package outputs trim (register) marks. It works with <a +href="https://osdn.jp/projects/luatex-ja/wiki/FrontPage">LuaTeX-ja</a> / +pLaTeX / upLaTeX / dvipdfmx / Dvips / dviout and any document class (not +only with jlreq class). It provides the following.</p> <ul> <li>Output trim marks</li> <li>Set TrimBox and BleedBox if possible.</li> <li>Set the size of paper.</li> </ul> -<p>Note that this package is independent from <a href="https://www.w3.org/TR/jlreq/">Requirements for Japanese Text Layout</a> (JLReq). JLReq says nothing about trim marks.</p> +<p>Note that this package is independent from <a +href="https://www.w3.org/TR/jlreq/">Requirements for Japanese Text +Layout</a> (JLReq). JLReq says nothing about trim marks.</p> <h2 id="installation">Installation</h2> -<p>Move jlreq-trimmarks.sty and jlre-helpers.sty to $TEXMF/tex/latex/jlreq.</p> +<p>Move jlreq-trimmarks.sty and jlre-helpers.sty to +$TEXMF/tex/latex/jlreq.</p> <h2 id="how-to-use">How to use</h2> -<p>Load it by <code>\usepackage</code> with specifying the TeX engine and the DVI driver.</p> +<p>Load it by <code>\usepackage</code> with specifying the TeX engine +and the DVI driver.</p> <pre><code>\usepackage[dvipdfmx,platex]{jlreq-trimmarks}</code></pre> <p>Do not use <code>tombow</code> option in the document class.</p> <h2 id="note">Note</h2> -<p>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., <a href="https://github.com/zr-tex8r/BXpapersize">bxpapersize</a>.</p> +<p>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., <a +href="https://github.com/zr-tex8r/BXpapersize">bxpapersize</a>.</p> <h2 id="options">Options</h2> <p>The following package options (keyval style) are available.</p> -<h3 id="platex-uplatex-lulatex"><code>platex</code>, <code>uplatex</code>, <code>lulatex</code></h3> +<h3 id="platex-uplatex-lulatex"><code>platex</code>, +<code>uplatex</code>, <code>lulatex</code></h3> <p>Set the engine. If it is not specified, then the engine is</p> <ul> <li>the one used in the jlreq class if the jlreq class is loaded.</li> <li>guessed one if the jlreq class is not loaded.</li> </ul> -<h3 id="dvipdfmx-dvips-dviout"><code>dvipdfmx</code>, <code>dvips</code>, <code>dviout</code></h3> -<p>Set the dvi driver. You do not have to specify it when using the engine <code>lualatex</code>. If it is not specified (with <code>platex</code> or <code>uplatex</code>), then <code>dvipdfmx</code> is used.</p> +<h3 id="dvipdfmx-dvips-dviout"><code>dvipdfmx</code>, +<code>dvips</code>, <code>dviout</code></h3> +<p>Set the dvi driver. You do not have to specify it when using the +engine <code>lualatex</code>. If it is not specified (with +<code>platex</code> or <code>uplatex</code>), then <code>dvipdfmx</code> +is used.</p> <h3 id="trimmarks_paper"><code>trimmarks_paper</code></h3> <p>Set the size of the paper including trim marks.</p> <ul> -<li><code>trimmarks_paper=<paper type></code>: specify via the paper type. for the paper type, you can use <code>a0--a10</code>, <code>b0--b10</code> and <code>c2--c8</code>. Note that <code>b0--b10</code> is `JIS B' (Japanese B-series variant).</li> -<li><code>trimmarks_paper={<width>,height>}</code>: specify via the width and height.</li> -<li><code>trimmarks_paper=<paper size>+{<width>,<height>}</code> (e.g. <code>trimmarks_paper=a4+{1cm,2cm}</code>): <code><width></code> (resp. <code><height></code>) is added to the width (resp. height) of the paper size specified by <code><paper size></code> For <code><paper size></code>, one can use <code><paper type></code> or <code>{<width>,<height>}</code> as in the above.</li> -<li><code>trimmarks_paper=a4+2cm</code> is equivalent to <code>trimmarks_paper=a4+{2cm,2cm}</code>.</li> -<li>If <code><paper size></code> is empty (e.g. <code>trimmarks_paper=+2cm</code>), the current paper size (which is specified usually by the option for the document class) is used.</li> +<li><code>trimmarks_paper=<paper type></code>: specify via the +paper type. for the paper type, you can use <code>a0--a10</code>, +<code>b0--b10</code> and <code>c2--c8</code>. Note that +<code>b0--b10</code> is `JIS B' (Japanese B-series variant).</li> +<li><code>trimmarks_paper={<width>,height>}</code>: specify via +the width and height.</li> +<li><code>trimmarks_paper=<paper size>+{<width>,<height>}</code> +(e.g. <code>trimmarks_paper=a4+{1cm,2cm}</code>): +<code><width></code> (resp. <code><height></code>) is added +to the width (resp. height) of the paper size specified by +<code><paper size></code> For <code><paper size></code>, one +can use <code><paper type></code> or +<code>{<width>,<height>}</code> as in the above.</li> +<li><code>trimmarks_paper=a4+2cm</code> is equivalent to +<code>trimmarks_paper=a4+{2cm,2cm}</code>.</li> +<li>If <code><paper size></code> is empty (e.g. +<code>trimmarks_paper=+2cm</code>), the current paper size (which is +specified usually by the option for the document class) is used.</li> </ul> <h3 id="landscape"><code>landscape</code></h3> -<p>Swap the width and the height. This swaps only the width and height which is specified with the option <code>trimmarks_paper</code>. For example, <code>landscape,trimmarks_paper=+{1cm,2cm}</code>, adds 1cm to the height and 2cm to the width. But the current paper size is not swapped.</p> +<p>Swap the width and the height. This swaps only the width and height +which is specified with the option <code>trimmarks_paper</code>. For +example, <code>landscape,trimmarks_paper=+{1cm,2cm}</code>, adds 1cm to +the height and 2cm to the width. But the current paper size is not +swapped.</p> <h3 id="show"><code>show</code></h3> -<p>Specify the types of trim marks which the package outputs. It is specified with the comma separated list like <code>show={trimmarks,banner,digital}</code>. If no argument is given, everything will be showed.</p> +<p>Specify the types of trim marks which the package outputs. It is +specified with the comma separated list like +<code>show={trimmarks,banner,digital}</code>. If no argument is given, +everything will be showed.</p> <ul> <li><code>trimmarks</code>: outputs the trim marks.</li> <li><code>banner</code>: date etc.</li> @@ -134,12 +169,16 @@ </ul> <h3 id="bleed_margin"><code>bleed_margin</code></h3> <p>Set the bleed margin. You can also specify as follows.</p> -<div class="sourceCode" id="cb2"><pre class="sourceCode latex"><code class="sourceCode latex"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[bleed_margin={top=3mm,bottom=5mm,gutter=0mm,fore-edge=2mm}]{<span class="ex">jlreq-trimmarks</span>}</span></code></pre></div> +<div class="sourceCode" id="cb2"><pre +class="sourceCode latex"><code class="sourceCode latex"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[bleed_margin={top=3mm,bottom=5mm,gutter=0mm,fore-edge=2mm}]{<span class="ex">jlreq-trimmarks</span>}</span></code></pre></div> <h2 id="jlreqtrimmarkssetup"><code>\jlreqtrimmarkssetup</code></h2> <p>Set the additional settings with the keyval style.</p> <h3 id="banner"><code>banner</code></h3> -<p>The things which the package outputs when <code>show=banner</code> 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</p> -<div class="sourceCode" id="cb3"><pre class="sourceCode latex"><code class="sourceCode latex"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\jlreqtrimmarkssetup</span>{</span> +<p>The things which the package outputs when <code>show=banner</code> 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</p> +<div class="sourceCode" id="cb3"><pre +class="sourceCode latex"><code class="sourceCode latex"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\jlreqtrimmarkssetup</span>{</span> <span id="cb3-2"><a href="#cb3-2" aria-hidden="true" tabindex="-1"></a> banner={</span> <span id="cb3-3"><a href="#cb3-3" aria-hidden="true" tabindex="-1"></a> <Position (top/bottom, left/right, center)>={</span> <span id="cb3-4"><a href="#cb3-4" aria-hidden="true" tabindex="-1"></a> <more precise position>={</span> @@ -151,7 +190,8 @@ <span id="cb3-10"><a href="#cb3-10" aria-hidden="true" tabindex="-1"></a> }</span> <span id="cb3-11"><a href="#cb3-11" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div> <p>Here is an example.</p> -<div class="sourceCode" id="cb4"><pre class="sourceCode latex"><code class="sourceCode latex"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\jlreqtrimmarkssetup</span>{</span> +<div class="sourceCode" id="cb4"><pre +class="sourceCode latex"><code class="sourceCode latex"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\jlreqtrimmarkssetup</span>{</span> <span id="cb4-2"><a href="#cb4-2" aria-hidden="true" tabindex="-1"></a> banner={</span> <span id="cb4-3"><a href="#cb4-3" aria-hidden="true" tabindex="-1"></a> top-right={</span> <span id="cb4-4"><a href="#cb4-4" aria-hidden="true" tabindex="-1"></a> vertical={</span> @@ -170,9 +210,13 @@ <span id="cb4-17"><a href="#cb4-17" aria-hidden="true" tabindex="-1"></a> }</span> <span id="cb4-18"><a href="#cb4-18" aria-hidden="true" tabindex="-1"></a> }</span> <span id="cb4-19"><a href="#cb4-19" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div> -<p>A possible combination of <code>top/bottom/center</code> and <code>left/right/center/gutter/fore-edge</code> can be used for the position. You can use <code>\thepage</code> to output the number of the page.</p> +<p>A possible combination of <code>top/bottom/center</code> and +<code>left/right/center/gutter/fore-edge</code> can be used for the +position. You can use <code>\thepage</code> to output the number of the +page.</p> <p>The keys can be ommited. For example:</p> -<div class="sourceCode" id="cb5"><pre class="sourceCode latex"><code class="sourceCode latex"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\jlreqtrimmarkssetup</span>{</span> +<div class="sourceCode" id="cb5"><pre +class="sourceCode latex"><code class="sourceCode latex"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\jlreqtrimmarkssetup</span>{</span> <span id="cb5-2"><a href="#cb5-2" aria-hidden="true" tabindex="-1"></a> banner={</span> <span id="cb5-3"><a href="#cb5-3" aria-hidden="true" tabindex="-1"></a> vertical={Vertical mode, in the top of the left},</span> <span id="cb5-4"><a href="#cb5-4" aria-hidden="true" tabindex="-1"></a> odd={In the top of the left, only in odd pages.}, <span class="co">% regarded as `horizontal`</span></span> @@ -184,15 +228,43 @@ <h3 id="trimmarks_width"><code>trimmarks_width</code></h3> <p>Set the width of trim marks.</p> <h3 id="-color"><code> color</code></h3> -<p>Set the color of the trim marks. You have to load a package which defines <code>\color</code> (`color' package or its variant) before loading this package to use this function. Here are some examples of specifying the color.</p> +<p>Set the color of the trim marks. You have to load a package which +defines <code>\color</code> (`color' package or its variant) before +loading this package to use this function. Here are some examples of +specifying the color.</p> <ul> <li><code>color=c</code> -> <code>\color[cmyk]{1,0,0,0}</code></li> <li><code>color=cyk</code> -> <code>\color[cmyk]{1,0,1,1}</code></li> <li><code>black</code> -> <code>\color{black}</code></li> -<li><code>[cmyk]0.5,0.5,0.5,0</code> -> <code>\color[cmyk]{0.5,0.5,0.5,0}</code></li> +<li><code>[cmyk]0.5,0.5,0.5,0</code> -> +<code>\color[cmyk]{0.5,0.5,0.5,0}</code></li> </ul> +<h3 id="trimmarks_pattern"><code>trimmarks_pattern</code></h3> +<p>Set the shape of the trim marks by the code. You can change the +shapes of trim marks at the centers of top, bottom, left and right by +the following code. Here, the specified code is the code for the +top-center trim marks and rotated ones are put at the other places. +Here, <code>graphicx</code> code should be loaded.</p> +<div class="sourceCode" id="cb6"><pre +class="sourceCode latex"><code class="sourceCode latex"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\jlreqtrimmarkssetup</span>{</span> +<span id="cb6-2"><a href="#cb6-2" aria-hidden="true" tabindex="-1"></a> trimmarks_pattern = {</span> +<span id="cb6-3"><a href="#cb6-3" aria-hidden="true" tabindex="-1"></a> centers = {</span> +<span id="cb6-4"><a href="#cb6-4" aria-hidden="true" tabindex="-1"></a> <span class="fu">\raisebox</span>{3mm}{</span> +<span id="cb6-5"><a href="#cb6-5" aria-hidden="true" tabindex="-1"></a> <span class="fu">\vrule</span> width10mm height<span class="fu">\jlreqtrimmarkswidth</span> depth 0pt</span> +<span id="cb6-6"><a href="#cb6-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\vrule</span> height10mm width<span class="fu">\jlreqtrimmarkswidth</span> depth 3mm</span> +<span id="cb6-7"><a href="#cb6-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\vrule</span> width10mm height<span class="fu">\jlreqtrimmarkswidth</span> depth 0pt</span> +<span id="cb6-8"><a href="#cb6-8" aria-hidden="true" tabindex="-1"></a> }</span> +<span id="cb6-9"><a href="#cb6-9" aria-hidden="true" tabindex="-1"></a> }</span> +<span id="cb6-10"><a href="#cb6-10" aria-hidden="true" tabindex="-1"></a> }</span> +<span id="cb6-11"><a href="#cb6-11" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div> +<p>You can specify shapes for top, bottom, left and right independently. +For example, you can change the shape at the top-center by +<code>top-center=<code></code>. Similarly one can use +<code>bottom-center</code>,<code>left-center</code>,<code>right-center</code>. +<code>graphix</code> package is not needed for these keys.</p> <h2 id="license">LICENSE</h2> -<p>This package is distributed under the BSD 2-Clause License. See <a href="LICENSE">LICENSE</a>.</p> +<p>This package is distributed under the BSD 2-Clause License. See <a +href="LICENSE">LICENSE</a>.</p> <h2 id="changelog">CHANGELOG</h2> <ul> <li>2018-05-19 @@ -210,24 +282,31 @@ </ul></li> <li>2018-09-01 <ul> -<li>Moved <code>bleed_margin</code> from <code>\jlreqtrimmarkssetup</code> to a package option.</li> +<li>Moved <code>bleed_margin</code> from +<code>\jlreqtrimmarkssetup</code> to a package option.</li> <li>jlreq-trimmarks works with unusugal<code>\mag</code>.</li> <li>Fixed bugs.</li> </ul></li> <li>2018-12-10 <ul> -<li>Extended <code>banner</code> in <code>\jlreqtrimmarkssetup</code>.</li> +<li>Extended <code>banner</code> in +<code>\jlreqtrimmarkssetup</code>.</li> </ul></li> <li>2019-04-01 <ul> -<li>Extended <code>banner</code> in <code>\jlreqtrimmarkssetup</code>.</li> +<li>Extended <code>banner</code> in +<code>\jlreqtrimmarkssetup</code>.</li> <li>Extended <code>bleed_margin</code>.</li> </ul></li> <li>2020-05-01 <ul> -<li><code>jlreq-trimmarks</code> outputs the contents in <code>\@bannertoken</code> when <code>banner</code> in <code>\jlreqtrimmarkssetup</code> is not used.</li> -<li><code>\@bannertoken</code> is ignored when <code>banner</code> in <code>\jlreqtrimmarkssetup</code> is used.</li> -<li><code>\@bannerfont</code> is ignored when <code>banner_font</code> in <code>\jlreqtrimmarkssetup</code> is used.</li> +<li><code>jlreq-trimmarks</code> outputs the contents in +<code>\@bannertoken</code> when <code>banner</code> in +<code>\jlreqtrimmarkssetup</code> is not used.</li> +<li><code>\@bannertoken</code> is ignored when <code>banner</code> in +<code>\jlreqtrimmarkssetup</code> is used.</li> +<li><code>\@bannerfont</code> is ignored when <code>banner_font</code> +in <code>\jlreqtrimmarkssetup</code> is used.</li> </ul></li> <li>2021-07-22 <ul> @@ -241,9 +320,15 @@ <ul> <li>Fixed a bug: an error occurred when loading.</li> </ul></li> +<li>2022-11-28 +<ul> +<li>Added <code>trimmarks_pattern</code> to +<code>\jlreqtrimmarkssetup</code>.</li> +</ul></li> </ul> <hr /> -<p>Noriyuki Abe <a href="https://github.com/abenori/jlreq">https://github.com/abenori/jlreq</a></p> +<p>Noriyuki Abe <a +href="https://github.com/abenori/jlreq">https://github.com/abenori/jlreq</a></p> </article> </body> </html> |