File: jlreq-trimmarks-ja.html

package info (click to toggle)
texlive-lang 2022.20230122-1
links: PTS, VCS
area: main
in suites: bookworm
size: 1,447,264 kB
sloc: perl: 61,377; xml: 53,781; makefile: 4,525; sh: 4,338; ansic: 2,892; python: 2,861; ruby: 1,031; lisp: 750; awk: 649; java: 159; sed: 142; csh: 25
file content (292 lines) | stat: -rw-r--r-- 19,559 bytes
<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="utf-8">
  <meta name="generator" content="pandoc">
  <title>jlreq-trimmarks</title>
  <style>
    .markdown-body {
      padding-top: 10px;
      padding-bottom: 10px;
      background-color: white;
      padding: 30px;
      line-height: 170%;
    }
    h1{
      font-size: 200%;
    }
    h2{
      border-style: solid;
      border-width: 0 0 0.1em 0em;
      padding: 0 0 0.2em 0em;
      border-color: #EEEEEE;
      margin-top: 2em;
    }
    h3{
      border-style: solid;
      border-width: 0 0 0 0.5em;
      padding: 0 0 0 0.5em;
      border-color: #EEEEEE;
      margin-top: 2em;
    }
    code{
      white-space: pre;
      font-weight: normal;
      background-color: #F4F4F4;
      border-color: #F4F4F4;
      border-style: solid;
      border-width: .2em .5em;
      border-radius: .2em;
    }
    pre{
      background-color: #F8F8F8;
      border-color: #F8F8F8;
      border-width: 1em;
      border-style: solid;
      border-radius: .5em;
      padding: 0;
      margin: 0;
      line-height: 130%;
    }
    pre code{
      background-color: #F8F8F8;
      border-style: none;
    }
    div.sourceCode { overflow-x: auto; text-indent: 0em;}
    code span.kw { color: #007020; font-weight: bold; } /* Keyword */
    code span.dt { color: #902000; } /* DataType */
    code span.dv { color: #40a070; } /* DecVal */
    code span.bn { color: #40a070; } /* BaseN */
    code span.fl { color: #40a070; } /* Float */
    code span.ch { color: #4070a0; } /* Char */
    code span.st { color: #4070a0; } /* String */
    code span.co { color: #008000; } /* Comment */
    code span.ot { color: #007020; } /* Other */
    code span.al { color: #ff0000; font-weight: bold; } /* Alert */
    code span.fu { color: #0040FF; } /* Function */
    code span.er { color: #ff0000; font-weight: bold; } /* Error */
    code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
    code span.cn { color: #880000; } /* Constant */
    code span.sc { color: #4070a0; } /* SpecialChar */
    code span.vs { color: #4070a0; } /* VerbatimString */
    code span.ss { color: #bb6688; } /* SpecialString */
    code span.im { } /* Import */
    code span.va { color: #19177c; } /* Variable */
    code span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
    code span.op { color: #666666; } /* Operator */
    code span.bu { color: #0040FF; } /* BuiltIn */
    code span.ex { } /* Extension */
    code span.pp { color: #bc7a00; } /* Preprocessor */
    code span.at { color: #7d9029; } /* Attribute */
    code span.do { color: #ba2121; font-style: italic; } /* Documentation */
    code span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
    code span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
    code span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
  </style>
</head>
<body>
<article class="markdown-body">
<h1 id="jlreq-trimmarks">jlreq-trimmarks</h1>
<h2 id="これは何">これは何？</h2>
<p>トンボ（トリムマーク）を出力するためのパッケージです．<a
href="https://osdn.jp/projects/luatex-ja/wiki/FrontPage">LuaTeX-ja</a> /
pLaTeX / upLaTeX / dvipdfmx / Dvips /
dviout上で動きます．jlreqクラスファイルのみでなく，汎用的に動くように設計されています．以下の機能を提供します．</p>
<ul>
<li>トンボの出力</li>
<li>可能な場合には，TrimBox / BleedBoxを設定</li>
<li>紙サイズの設定</li>
</ul>
<p>なお，本パッケージは<a
href="https://www.w3.org/TR/jlreq/ja/">日本語組版処理の要件</a>
(JLReq)とは無縁です．JLReqにはトンボに関する記述はありません．</p>
<h2 id="インストール">インストール</h2>
<p>$TEXMF/tex/latex/jlreq内にjlreq-trimmarks.styとjlreq-helpers.styを配置してください．</p>
<h2 id="使い方">使い方</h2>
<p>ドライバおよびエンジンを指定して<code>\usepackage</code>で読み込みます．エンジンは省略が可能です．</p>
<pre><code>\usepackage[dvipdfmx,platex]{jlreq-trimmarks}</code></pre>
<p>なお，クラスファイルの<code>tombow</code>オプションは使わないでください．</p>
<h2 id="ノート">ノート</h2>
<p>jlreq-trimmarksは紙サイズを設定しますが，その他のパッケージとの兼ね合いで正しく機能しないことがあります．その際は<a
href="https://github.com/zr-tex8r/BXpapersize">bxpapersize</a>のようなより強力なパッケージを試してみてください．</p>
<h2 id="オプション">オプション</h2>
<p>以下のパッケージオプションを受け付けます．keyval形式です．</p>
<h3 id="platex-uplatex-lulatex"><code>platex</code>,
<code>uplatex</code>, <code>lulatex</code></h3>
<p>エンジンの指定です．省略時は，</p>
<ul>
<li><code>jlreq</code>クラスファイルを読み込んでいる場合はそれと連動する</li>
<li>そうでなければ自動推定</li>
</ul>
<p>です．</p>
<h3
id="dvipdfmxdvipsdviout"><code>dvipdfmx</code>，<code>dvips</code>，<code>dviout</code></h3>
<p>dviドライバの指定です．エンジンに<code>lualatex</code>を利用する場合は指定する必要はありません．省略時は<code>dvipdfmx</code>が使われます．</p>
<h3 id="trimmarks_paper"><code>trimmarks_paper</code></h3>
<p>トンボ付きの紙サイズを指定します．</p>
<ul>
<li><code>trimmarks_paper=a4</code>のように，<code>a0--a10</code>,
<code>b0--b10</code>, <code>c2--c8</code>（BはJIS
B列）を指定できる他，<code>trimmarks_paper={&lt;width&gt;,&lt;height&gt;}</code>と直接寸法を指定することができます．</li>
<li><code>a4+{1cm,2cm}</code>や<code>{10cm,20cm}+{1cm,2cm}</code>のように<code>&lt;紙サイズ&gt;+{&lt;寸法横&gt;,&lt;寸法縦&gt;}</code>とした場合は，指定された紙サイズから指定された寸法だけ増やした紙サイズを設定します．</li>
<li><code>a4+2cm</code>は<code>a4+{2cm,2cm}</code>と等価です．</li>
<li><code>+2cm</code>と紙サイズの部分を省略すると，現在の紙サイズを利用します．</li>
<li>デフォルトは<code>+2in</code>です．</li>
</ul>
<h3 id="landscape"><code>landscape</code></h3>
<p>紙のサイズの縦と横とを入れ替えます．ただし入れ替えるのは<code>trimmarks_paper</code>で明示的に指定された値に限ります．例えば<code>landscape,trimmarks_paper=+{1cm,2cm}</code>とすると，もともとの紙サイズ（これは入れ替わらない）の横幅が2cm増え，縦幅が1cm増えた紙サイズとなります．</p>
<h3 id="show"><code>show</code></h3>
<p>出力する対象を指定します．<code>show={trimmarks,banner,digital}</code>のようにカンマ区切りのリストを与えます．引数を与えない場合は全て表示します．</p>
<ul>
<li><code>trimmarks</code>：トンボ自身を出力します．</li>
<li><code>banner</code>：日付などを出力します．</li>
<li><code>digital</code>：TrimBoxとBleedBoxの設定を行います（デジタルトンボ）．</li>
<li><code>no</code>：何も表示しません．</li>
</ul>
<h3 id="bleed_margin"><code>bleed_margin</code></h3>
<p>仕上がりと裁ち落としの間（ドブ）の長さを指定します．次のようにすると，上下左右を独立に変更できます．</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>
<h2 id="jlreqtrimmarkssetup"><code>\jlreqtrimmarkssetup</code></h2>
<p>パッケージオプションで指定できない設定を行えます．keyval形式です．</p>
<h3 id="banner"><code>banner</code></h3>
<p><code>show=banner</code>時に出力される文字列．通常は左上に出力されますが，四つ角および上下左右の中心に出力することもできます．指定は</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>    &lt;場所（上下，左右中央）&gt;={</span>
<span id="cb3-4"><a href="#cb3-4" aria-hidden="true" tabindex="-1"></a>      &lt;細かな位置&gt;={</span>
<span id="cb3-5"><a href="#cb3-5" aria-hidden="true" tabindex="-1"></a>        &lt;ページ数の偶奇に応じて&gt;={</span>
<span id="cb3-6"><a href="#cb3-6" aria-hidden="true" tabindex="-1"></a>          &lt;表示項目&gt;</span>
<span id="cb3-7"><a href="#cb3-7" aria-hidden="true" tabindex="-1"></a>        }</span>
<span id="cb3-8"><a href="#cb3-8" aria-hidden="true" tabindex="-1"></a>      }</span>
<span id="cb3-9"><a href="#cb3-9" aria-hidden="true" tabindex="-1"></a>    }</span>
<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>のようになります．キー名は省略することもできます．例えば次のように指定します．</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>
<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>      tate={</span>
<span id="cb4-5"><a href="#cb4-5" aria-hidden="true" tabindex="-1"></a>        odd={奇数ページの右上に縦書きで表示},</span>
<span id="cb4-6"><a href="#cb4-6" aria-hidden="true" tabindex="-1"></a>        even={偶数ページの右上に縦書きで表示},</span>
<span id="cb4-7"><a href="#cb4-7" aria-hidden="true" tabindex="-1"></a>      },</span>
<span id="cb4-8"><a href="#cb4-8" aria-hidden="true" tabindex="-1"></a>      yoko={右上に横書きで表示}, <span class="co">% ページの偶奇によらず共通</span></span>
<span id="cb4-9"><a href="#cb4-9" aria-hidden="true" tabindex="-1"></a>      corner={右上角に横書きで表示},</span>
<span id="cb4-10"><a href="#cb4-10" aria-hidden="true" tabindex="-1"></a>      in-yoko={右上版面内に横書きで表示},</span>
<span id="cb4-11"><a href="#cb4-11" aria-hidden="true" tabindex="-1"></a>      in-tate={右上版面内に縦書きで表示},</span>
<span id="cb4-12"><a href="#cb4-12" aria-hidden="true" tabindex="-1"></a>    },</span>
<span id="cb4-13"><a href="#cb4-13" aria-hidden="true" tabindex="-1"></a>    bottom-center={</span>
<span id="cb4-14"><a href="#cb4-14" aria-hidden="true" tabindex="-1"></a>      left={中央下の左に表示}, <span class="co">% odd=, even=も使用可能</span></span>
<span id="cb4-15"><a href="#cb4-15" aria-hidden="true" tabindex="-1"></a>      right={中央下の右に表示},</span>
<span id="cb4-16"><a href="#cb4-16" aria-hidden="true" tabindex="-1"></a>      in={中央下の版面内に表示},</span>
<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>    center-gutter={</span>
<span id="cb4-19"><a href="#cb4-19" aria-hidden="true" tabindex="-1"></a>      above={ノド側中央の上側に表示},</span>
<span id="cb4-20"><a href="#cb4-20" aria-hidden="true" tabindex="-1"></a>      below={ノド側中央の下側に表示},</span>
<span id="cb4-21"><a href="#cb4-21" aria-hidden="true" tabindex="-1"></a>    },</span>
<span id="cb4-22"><a href="#cb4-22" aria-hidden="true" tabindex="-1"></a>  }</span>
<span id="cb4-23"><a href="#cb4-23" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
<p>場所は<code>top/bottom/center</code>と<code>left/right/center/gutter/fore-edge</code>の可能な組み合わせが指定可能です．各項目に<code>\thepage</code>を指定するとページ数を出力できます．</p>
<p>次のような指定も可能です．</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>
<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>    tate={左上に縦書き}, <span class="co">% 場所が省略されるとtop-leftと見なされる．</span></span>
<span id="cb5-4"><a href="#cb5-4" aria-hidden="true" tabindex="-1"></a>    odd={左上奇数ページ}, <span class="co">% 省略されたのでyokoと見なされる．</span></span>
<span id="cb5-5"><a href="#cb5-5" aria-hidden="true" tabindex="-1"></a>    top-right={</span>
<span id="cb5-6"><a href="#cb5-6" aria-hidden="true" tabindex="-1"></a>      odd={右上奇数ページ} <span class="co">% ここもyokoが省略されている．</span></span>
<span id="cb5-7"><a href="#cb5-7" aria-hidden="true" tabindex="-1"></a>    }</span>
<span id="cb5-8"><a href="#cb5-8" aria-hidden="true" tabindex="-1"></a>  }</span>
<span id="cb5-9"><a href="#cb5-9" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
<h3 id="trimmarks_width"><code>trimmarks_width</code></h3>
<p>トンボ自身の太さを指定します．</p>
<h3 id="-color"><code> color</code></h3>
<p>トンボの色．この機能を利用するには，あらかじめ<code>\color</code>を定義するパッケージ（<code>color</code>パッケージまたはその派生）を読み込んでおく必要があります．ここでの指定は次のようにして<code>\color</code>命令に変換されます．</p>
<ul>
<li><p><code>cy</code>や<code>myk</code>のように<code>cmyk</code>という文字列の一部の場合は，<code>cmyk</code>で指定された色のみの色になります．例えば<code>color=cy</code>は<code>\color[cmyk]{1,0,1,0}</code>となります．</p></li>
<li><p>そうでない場合は<code>\color</code>の引数に回されます．<code>[***]</code>という形が先行する場合は，<code>\color</code>のオプションとして扱われます．例えば以下のようになります．</p>
<ul>
<li><code>black</code> -&gt; <code>\color{black}</code></li>
<li><code>[cmyk]0.5,0.5,0.5,0</code> -&gt;
<code>\color[cmyk]{0.5,0.5,0.5,0}</code></li>
</ul></li>
</ul>
<h3 id="trimmarks_pattern"><code>trimmarks_pattern</code></h3>
<p>トンボの形．直接の描画コードを指定します．次のように<code>centers</code>に指定すると，上下左右の真ん中のトンボの形が変わります．指定するのは上の真ん中のトンボの描画コードであり，そのほかの場所にはそれを回転したものが描画されます．なお，指定前に<code>graphicx</code>パッケージを読み込んでおく必要があります．また<code>\jlreqtrimmarkswidth</code>には</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>上下左右の形を個別に指定することもできます．例えば上の真ん中のみ変更するには<code>top-center=&lt;描画コード&gt;</code>を指定します．同様に<code>bottom-center</code>，<code>left-center</code>，<code>right-center</code>が指定できます．個別指定には<code>graphicx</code>パッケージは不要です．</p>
<h2 id="ライセンス">ライセンス</h2>
<p>このパッケージは二条項BSDライセンスの元で配布されています．詳しくは<a
href="LICENSE">LICENSE</a>をご覧ください．</p>
<h2 id="履歴">履歴</h2>
<ul>
<li>2018-05-19
<ul>
<li>最初のバージョン</li>
</ul></li>
<li>2018-06-17
<ul>
<li>バグ修正．</li>
</ul></li>
<li>2018-08-08
<ul>
<li><code>trimmarks_paper</code>を拡張．</li>
<li>パッケージオプション<code>landscape</code>を追加．</li>
</ul></li>
<li>2018-09-01
<ul>
<li><code>bleed_margin</code>を<code>\jlreqtrimmarkssetup</code>からパッケージオプションに移した．</li>
<li><code>\mag</code>が<code>1000</code>でない場合も動くようにした（つもり）</li>
<li>バグ修正</li>
</ul></li>
<li>2018-12-10
<ul>
<li><code>\jlreqtrimmarkssetup</code>内の<code>banner</code>を拡張．</li>
</ul></li>
<li>2019-04-01
<ul>
<li><code>\jlreqtrimmarkssetup</code>内の<code>banner</code>を更に拡張．</li>
<li><code>bleed_margin</code>を拡張．</li>
</ul></li>
<li>2020-05-01
<ul>
<li><code>\jlreqtrimmarkssetup</code>の<code>banner</code>を使わない場合，<code>\@bannertoken</code>の中身を偶奇ページ両方に出力するようにした．</li>
<li><code>\jlreqtrimmarkssetup</code>の<code>banner</code>を使う場合，<code>\@bannertoken</code>の中身を無視するようにした．</li>
<li><code>\jlreqtrimmarkssetup</code>の<code>banner_font</code>が指定された場合，<code>\@bannerfont</code>を無視するようにした．</li>
</ul></li>
<li>2021-07-22
<ul>
<li>expl3コードとの親和性を高めた．</li>
</ul></li>
<li>2021-08-12
<ul>
<li><code>etoolbox</code>に依存しないようにした．</li>
</ul></li>
<li>2022-07-13
<ul>
<li>読み込み時にエラーが出るバグ修正．</li>
</ul></li>
<li>2022-11-28
<ul>
<li><code>trimmarks_pattern</code>を<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>
</article>
</body>
</html>