diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/bxpdfver/README-ja.md')
| -rw-r--r-- | Master/texmf-dist/doc/latex/bxpdfver/README-ja.md | 68 |
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 |