PXjahyper パッケージバンドル
============================

LaTeX： pLaTeX 上での hyperref のサポート

(u)pLaTeX 上で hyperref を用いて日本語の文書情報を含む PDF 文書を作成する
場合に必要となる以下の機能を提供する。

  * PDF 文字列内の和文文字のサポート
  * mag 指定に対するサポート

### 前提環境

  * フォーマット： LaTeX
  * エンジン：
      - pTeX 3.0版以降
      - upTeX 0.10版以降
      - pTeX-ng (試験的)
    ※一部の機能では e-TeX 拡張が必要。
  * DVIウェア： dvipdfmx
  * 依存パッケージ：
      - atbegshi
      - hyperref
  * 一部の機能で必要なパッケージ：
      - japanese-otf
      - etoolbox
      - bxjatoucs

### インストール

  - `*.sty`, `*.def` → $TEXMF/tex/platex/PXjahyper

### ライセンス

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


pxjahyper パッケージ ー 本体
----------------------------

詳細についてはマニュアル `pxjahyper.pdf` を参照されたい。


pxjahyper-enc パッケージ ー 文字コード設定
------------------------------------------

他のパッケージの内部で読み込むために pxjahyper から機能を抜粋して作った
パッケージであり、DVI ファイル中の PDF 文字列の漢字コードを指定するため
の「tounicode special」を出力する機能のみをもつ。

※文書作成者は pxjahyper を読み込むことが推奨される。

### パッケージオプション

※オプション無しでの読込が望ましいが、一応グローバルのドライバオプション
に反応するようにしている。

  * ドライバオプション：`dvipdfmx`/`dvips`/`nodvidriver` があり、
    `dvipdfmx` 以外を指定した場合はパッケージの機能を無効化する。

### 機能

パッケージを読み込むと、既定動作として、エンジンの内部漢字コードに基づき
適切な「tounicode special」を出力する。

  * `\suppressbigcode`：内部漢字コードが Unicode のときに、`UTF8-UTF16`
    ではなく `UTF8-UCS2` の CMap を指定する。
  * `\suppressdefaulttounicode`：既定動作を無効にする。
  * `\pxjahyperToUnicodeSpecial{<名前>}`：引数の CMap 名を指定して
    「tounicode special」を出力する。


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

  * Version 1.5  〈2024/08/25〉
      - アンカー文字列での動作を修正。

  * Version 1.4  〈2024/08/14〉
      - 設定キー `fallback-warn` を追加。
      - 設定キー `fallback-cidm` を追加。
      - `force-unicode` オプションを非推奨とし、警告を出す。
      - 開発者用命令 `\pxjahyperBadCharacter` を追加。
      - オプション `autodvidriver`、`fallback-geta`、`fallback-delete`
        を非推奨にする。

  * Version 1.3  〈2023/03/01〉
      - “pTeX + hyperref unicode モード”を正式にサポートする。これに
        伴い、unicode モードに関する警告を削除。

  * Version 1.2a 〈2022/10/19〉
      - バグ修正。(thanks: @h20y6m さん)

  * Version 1.2  〈2022/05/27〉
      - LaTeX カーネル 2022/06/01 版への対応。
      - `\pxjahypersetup` を追加。
      - 設定キー `fallback` を追加。
      - `\pxDeclarePdfTextCommand/Composite` の不具合を修正。
      - (試験的) 設定キー `extjis` を追加。
      - (試験的) 設定キー `ajhankaku-chars` を追加。

  * Version 1.1  〈2022/05/10〉
      - オプション `fallback-geta`/`fallback-delete` を追加。
      - `\Uchar` を利用したUnicode文字出力をサポート。
      - オプション `(no)charcmds` を追加。
      - hyperref のドライバ指定が非サポートの場合に警告する。
      - `otfmacros` オプション指定の条件を撤廃する。
      - `autodvidriver` を `resetdvidriver` に変える。

  * Version 1.0a 〈2022/04/15〉
      - バグ修正。

  * Version 1.0  〈2022/04/01〉
      - オプション `auto` を `autodvidriver` に改名（旧名は非推奨）。
      - オプション `nodvidriver` の非推奨の旧名 `none`を廃止した。
      - `disablecmds` の対象に jsclasses 独自の命令を追加した。
      - (試験的)“pTeX + hyperref unicode モード”に対するサポート。

  * Version 0.9d 〈2022/03/15〉
      - LaTeX カーネル 2021/11/15 版への対応。(thanks: @wtsnjp さん)

  * Version 0.9c 〈2021/06/06〉
      - pxjahyper-uni モジュールを実際に使用する。

  * Version 0.9b 〈2021/05/29〉
      - PDF 文字列中で pxbabel の `\UTFJ` をサポート。
      - モジュール pxjahyper-uni.def を追加。

  * Version 0.9a 〈2021/05/11〉
      - バグ修正。

  * Version 0.9  〈2021/05/10〉
      - パッケージオプションの整理：`(no)papersize`、`convbkmk`、
        `(no)otfutf` を追加。
      - out2uni のエスケープ出力で UTF-16 を正しく扱う。
      - pLaTeX で tounicode 前提の動作をするときに、`\Ux` 等の Unicode
        符号入力についてフォールバック（ゲタ文字出力）を行う。

  * Version 0.8  〈2021/05/05〉
      - japanese-otf パッケージに対する実行のタイミングをパッケージ読込
        の直後に変更した。
      - (試験的) `(no)papersize` オプション。

  * Version 0.7b 〈2021/02/26〉
      - バグ修正。

  * Version 0.7a 〈2021/02/23〉
      - バグ修正。

  * Version 0.7  〈2021/02/13〉
      - 「upLaTeX での hyperref の `unicode` 指定への対応」を正式サポート
        の扱いとする。一部の正常動作しなかった機能についても対応させる。

  * Version 0.6a 〈2020/10/10〉
      - pxjahyper-enc：`dvips` 指定時はエラーでなく警告を出す。

  * Version 0.6  〈2020/10/05〉
      - pxjahyper-enc パッケージを追加した。
      - `otfmacros` オプションを既定で有効にする。

  * Version 0.5b 〈2020/10/04〉
      - バグ修正。

  * Version 0.5a 〈2020/09/27〉
      - LaTeX カーネル 2020/10/01 版への対応。

  * Version 0.5  〈2020/06/13〉
      - `otfmacros` オプションを正式にサポート。
      - `disablecmds` オプションを追加。
      - `none`（`nodvidriver` の別名）を非推奨とする。

  * Version 0.4b 〈2020/04/24〉
      - `\copyright` の再定義をやめる。

  * Version 0.4a 〈2019/11/23〉
      - (試験的) PDF 文字列中で japanese-otf の文字入力マクロをサポート
        （`otfmacros` オプション）

  * Version 0.4  〈2019/10/25〉
      - PDF 文字列中で `\CID` をサポート（`otfcid` オプション）

  * Version 0.3e 〈2019/06/20〉
      - hyperref の `unicode` 指定が後から変更された場合はエラーを出す。

  * Version 0.3d 〈2018/07/15〉
      - バグ修正。

  * Version 0.3c 〈2018/01/25〉
      - バグ修正。

  * Version 0.3b 〈2018/01/13〉
      - パッケージ定義の PDF 文字列の文字定義を拡充した。
      - (試験的) 自動判別の誤判定を防ぐため、アウトラインファイルに
        日本語文字のコメントを含ませておく。
      - (試験的) `(no)jacommentline` オプション。

  * Version 0.3a 〈2017/10/17〉
      - `bigcode` を既定に変更。
      - (試験的) upLaTeX で hyperref の `unicode` 指定を可能にする。

  * Version 0.3  〈2012/05/28〉
      - papersize special の調整機能を追加。
      - `\Ux` を追加。

  * Version 0.2  〈2012/05/27〉
      - 最初の公開版。

--------------------
Takayuki YATO (aka. "ZR")  
https://github.com/zr-tex8r
