summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/bxpdfver/README-ja.md
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/bxpdfver/README-ja.md')
-rw-r--r--Master/texmf-dist/doc/latex/bxpdfver/README-ja.md68
1 files changed, 42 insertions, 26 deletions
diff --git a/Master/texmf-dist/doc/latex/bxpdfver/README-ja.md b/Master/texmf-dist/doc/latex/bxpdfver/README-ja.md
index 368811e072b..dc466aa98bd 100644
--- a/Master/texmf-dist/doc/latex/bxpdfver/README-ja.md
+++ b/Master/texmf-dist/doc/latex/bxpdfver/README-ja.md
@@ -13,8 +13,8 @@ LaTeX 文書を PDF 文書に変換する際に出力 PDF に関する以下の
### 前提環境
* フォーマット: LaTeX
- * エンジン: 不問
- * DVIウェア: dvipdfmx、および PDF 出力のエンジン
+ * エンジン: pdfTeX、XeTeX、LuaTeX、および DVI 出力のエンジン
+ * DVIウェア(DVI出力時): dvipdfmx
* 依存パッケージ:
- atbegshi(dvipdfmx ドライバの場合)
@@ -45,48 +45,64 @@ bxpdfver パッケージ
+ PDF 出力のエンジンの場合は、既定で適切なドライバが選択される
のでドライバオプションは不要である。
+ `dvipdfmx`: dvipdfmx 用のドライバを指定する。
- + `disabled`: 全ての機能を無効化する。
+ + `disabled`/`nodvidriver`: 全ての機能を無効化する。
* `lenient`: サポートしない機能に対するエラーを警告に格下げする。
`compress`、`objcompress` はこのパッケージによる抑止を行わないという意味
であり、既に抑止されている場合にそれを再び有効化するものではない。
-### ドライバ指定
+### 機能
- * pdfTeX および LuaTeX では全ての機能が使用可能。
- * XeTeX および dvipdfmx の場合:
- - 「PDF バージョン指定」は無条件に使用可能。
- - 「オブジェクト圧縮抑止」および「オブジェクトストリーム抑止」の
- 機能を使用するためには、(x)dvipdfmx のバージョンが 20160307 以上
- である必要がある。またバージョン判定のために外部プログラムの
- 起動を利用するため、シェルエスケープが制限付許可または完全許可
- されている必要がある。
+ * `\setpdfversion{<バージョン>}`: 出力 PDF バージョンを指定する。
+ `<バージョン>` には以下の何れかを指定する。
+ + `1.4`、`1.5`、`1.6`、`1.7` の何れか。その値に設定する。
+ + PDF ファイルの名前。そのファイルのバージョンと同じ値に設定する。
+ * `\suppresspdfcompression`: ストリームの圧縮を抑止する。
+ * `\suppresspdfobjcompression`: オブジェクトストリームの使用を抑止
+ する。(実はこの指定自体は圧縮とは無関係であるが、pdfTeX エンジンの
+ プリミティブ `\pdfobjcompresslevel` に合わせた命令名を用いた。)
+ * `\setpdfdecimaldigits{<精度>}`: PDF 命令列中に現れる小数値の精度
+ (小数点以下の桁数)を指定する。
+ * `\preservepdfdestinations`: PDF 目的地(PDF destination)の名前の
+ 短縮を抑止し、TeX 文書で指定された名前を用いる。異なる PDF 文書間で
+ のリンクを正常に機能させるために必要である。
+
+### ドライバ指定に関する補足
+
+ \ Drivers (engines) pdfTeX dvipdfmx
+ Features / LuaTeX / XeTeX others
+ --------------------------- --------- --------- ------
+ \setpdfversion Yes Yes No
+ \suppresspdfcompression Yes Maybe(*2) No
+ \suppresspdfobjcompression Yes Maybe(*2) No
+ \setpdfdecimaldigits Yes Maybe(*2) No
+ \preservepdfdestinations No-op(*1) Maybe(*2) No
+
+ 1. pdfTeX/LuaTeX では PDF 目的地の名前が短縮されるることはない。つまり
+ `\preservepdfdestinations` は常に有効になっていると見なせる。
+ 2. これらの機能を使用するためには、(x)dvipdfmx のバージョンが 20160307
+ 以上である必要がある。
+ - バージョン判定のために kpsewhich と extractbb の起動を利用する
+ ため、少なくともこれらのプログラムについて、シェルエスケープが
+ 許可されている必要がある。
- dvipdfmx のバージョン情報は補助ファイル(.aux)中にキャッシュ
される。このため、何か状況が変わった場合は、一旦補助ファイルを
削除する必要が生じる。
+
+以下のことにも注意されたい。
+
* 使用不可能な機能を使おうと試みるとエラーが発生する。
* `dvips` 等の“全く対応していない”若干のドライバオプションを認識
する。この場合、全ての機能の呼出でエラーが発生する。
* `disabled` は特殊で、これを指定した場合は、どの機能の呼出でも
エラーは発生しないが、全く何の動作も行わない。
-### 機能
-
- * `\setpdfversion{<バージョン>}`: 出力 PDF バージョンを指定する。
- `<バージョン>` には以下の何れかを指定する。
- + `1.4`、`1.5`、`1.6`、`1.7` の何れか。バージョンをその値に設定
- する。
- + PDF ファイルの名前。この場合、その PDF のバージョンと同じ値に
- 設定する。
- * `\suppresspdfcompression`: ストリームの圧縮を抑止する。
- * `\suppresspdfobjcompression`: オブジェクトストリームの使用を抑止
- する。(実はこの指定自体は圧縮とは無関係であるが、pdfTeX エンジンの
- プリミティブ `\pdfobjcompresslevel` に合わせた命令名を用いた。)
-
更新履歴
--------
+ * Version 0.4 ‹2017/02/11›
+ - `\setpdfdecimaldigits`、`\preservepdfdestinations` を追加。
* Version 0.3 ‹2016/08/11›
- dvipdfmx/XeTeX でも全ての機能がサポートされる。
* Version 0.2b ‹2016/08/10›
@@ -99,4 +115,4 @@ bxpdfver パッケージ
--------------------
Takayuki YATO (aka. "ZR")
-http://zrbabbler.sp.land.to/
+https://github.com/zr-tex8r