summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/bxpdfver/README-ja.md
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /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.md118
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