summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/bxpdfver/README-ja.md
blob: 368811e072b89406e19629a9ba8ac2dc9dfa41e1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
BXpdfver パッケージバンドル
===========================

LaTeX: 出力 PDF のバージョンや圧縮状態を指定する

LaTeX 文書を PDF 文書に変換する際に出力 PDF に関する以下の設定を文書中で
行う機能を提供する。

  * PDF バージョン(1.4, 1.5 等)
  * ストリームの圧縮の有無
  * オブジェクトストリームの使用の有無

### 前提環境

  * フォーマット: LaTeX
  * エンジン: 不問
  * DVIウェア: dvipdfmx、および PDF 出力のエンジン
  * 依存パッケージ:
      - atbegshi(dvipdfmx ドライバの場合)

### インストール

  - `*.sty` → $TEXMF/tex/latex/BXpdfver

### ライセンス

本パッケージは MIT ライセンスの下で配布される。

bxpdfver パッケージ
-------------------

### パッケージ読込

    \usepackage[<オプション>,...]{bxpdfver}

利用可能なオプションは以下の通り。

  * `1.4`、`1.5`、`1.6`、`1.7`: PDF バージョンを指定する。
  * `nocompress`: ストリームの圧縮を抑止する。
  * `compress`(既定): ストリームの圧縮を抑止しない。
  * `noobjcompress`: オブジェクトストリームの使用を抑止する。
  * `objcompress`(既定): オブジェクトストリームの使用を抑止しない。
  * ドライバオプション: 以下の通り。なお、後述の「ドライバ指定」の
    節も参照されたい。
      + PDF 出力のエンジンの場合は、既定で適切なドライバが選択される
        のでドライバオプションは不要である。
      + `dvipdfmx`: dvipdfmx 用のドライバを指定する。
      + `disabled`: 全ての機能を無効化する。
  * `lenient`: サポートしない機能に対するエラーを警告に格下げする。

`compress`、`objcompress` はこのパッケージによる抑止を行わないという意味
であり、既に抑止されている場合にそれを再び有効化するものではない。

### ドライバ指定

  * pdfTeX および LuaTeX では全ての機能が使用可能。
  * XeTeX および dvipdfmx の場合:
      - 「PDF バージョン指定」は無条件に使用可能。
      - 「オブジェクト圧縮抑止」および「オブジェクトストリーム抑止」の
        機能を使用するためには、(x)dvipdfmx のバージョンが 20160307 以上
        である必要がある。またバージョン判定のために外部プログラムの
        起動を利用するため、シェルエスケープが制限付許可または完全許可
        されている必要がある。
      - dvipdfmx のバージョン情報は補助ファイル(.aux)中にキャッシュ
        される。このため、何か状況が変わった場合は、一旦補助ファイルを
        削除する必要が生じる。
  * 使用不可能な機能を使おうと試みるとエラーが発生する。
  * `dvips` 等の“全く対応していない”若干のドライバオプションを認識
    する。この場合、全ての機能の呼出でエラーが発生する。
  * `disabled` は特殊で、これを指定した場合は、どの機能の呼出でも
    エラーは発生しないが、全く何の動作も行わない。

### 機能

  * `\setpdfversion{<バージョン>}`: 出力 PDF バージョンを指定する。
    `<バージョン>` には以下の何れかを指定する。
      + `1.4`、`1.5`、`1.6`、`1.7` の何れか。バージョンをその値に設定
        する。
      + PDF ファイルの名前。この場合、その PDF のバージョンと同じ値に
        設定する。
  * `\suppresspdfcompression`: ストリームの圧縮を抑止する。
  * `\suppresspdfobjcompression`: オブジェクトストリームの使用を抑止
    する。(実はこの指定自体は圧縮とは無関係であるが、pdfTeX エンジンの
    プリミティブ `\pdfobjcompresslevel` に合わせた命令名を用いた。)


更新履歴
--------

  * Version 0.3  ‹2016/08/11›
      - dvipdfmx/XeTeX でも全ての機能がサポートされる。
  * Version 0.2b ‹2016/08/10›
      - `lenient` オプションを追加。
      - 新しい LuaTeX エンジンのサポート。
  * Version 0.2a ‹2015/08/05›
      - 細かい修正。
  * Version 0.2  ‹2014/07/04›
      - 最初の公開版。

--------------------
Takayuki YATO (aka. "ZR")  
http://zrbabbler.sp.land.to/