diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/bxpdfver/README-ja.md |
Initial commit
Diffstat (limited to 'macros/latex/contrib/bxpdfver/README-ja.md')
-rw-r--r-- | macros/latex/contrib/bxpdfver/README-ja.md | 118 |
1 files changed, 118 insertions, 0 deletions
diff --git a/macros/latex/contrib/bxpdfver/README-ja.md b/macros/latex/contrib/bxpdfver/README-ja.md new file mode 100644 index 0000000000..dc466aa98b --- /dev/null +++ b/macros/latex/contrib/bxpdfver/README-ja.md @@ -0,0 +1,118 @@ +BXpdfver パッケージバンドル +=========================== + +LaTeX: 出力 PDF のバージョンや圧縮状態を指定する + +LaTeX 文書を PDF 文書に変換する際に出力 PDF に関する以下の設定を文書中で +行う機能を提供する。 + + * PDF バージョン(1.4, 1.5 等) + * ストリームの圧縮の有無 + * オブジェクトストリームの使用の有無 + +### 前提環境 + + * フォーマット: LaTeX + * エンジン: pdfTeX、XeTeX、LuaTeX、および DVI 出力のエンジン + * DVIウェア(DVI出力時): dvipdfmx + * 依存パッケージ: + - 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`/`nodvidriver`: 全ての機能を無効化する。 + * `lenient`: サポートしない機能に対するエラーを警告に格下げする。 + +`compress`、`objcompress` はこのパッケージによる抑止を行わないという意味 +であり、既に抑止されている場合にそれを再び有効化するものではない。 + +### 機能 + + * `\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` は特殊で、これを指定した場合は、どの機能の呼出でも + エラーは発生しないが、全く何の動作も行わない。 + + +更新履歴 +-------- + + * Version 0.4 ‹2017/02/11› + - `\setpdfdecimaldigits`、`\preservepdfdestinations` を追加。 + * 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") +https://github.com/zr-tex8r |