diff options
author | Karl Berry <karl@freefriends.org> | 2013-11-03 23:41:58 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2013-11-03 23:41:58 +0000 |
commit | 5ce7edc70ecd5dba9645d946c65be9ab5095ed0b (patch) | |
tree | 3e7410f1d7e7efb44d4e77f6b94264ac219dfab5 /Master/texmf-dist/doc/latex/bxcjkjatype/README-ja.md | |
parent | 40dd5deea554f1ec46b8fd7b196adc94d193aed3 (diff) |
bxcjkjatype
git-svn-id: svn://tug.org/texlive/trunk@32048 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/bxcjkjatype/README-ja.md')
-rw-r--r-- | Master/texmf-dist/doc/latex/bxcjkjatype/README-ja.md | 237 |
1 files changed, 237 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/bxcjkjatype/README-ja.md b/Master/texmf-dist/doc/latex/bxcjkjatype/README-ja.md new file mode 100644 index 00000000000..2017dfb85ac --- /dev/null +++ b/Master/texmf-dist/doc/latex/bxcjkjatype/README-ja.md @@ -0,0 +1,237 @@ +BXcjkjatype パッケージバンドル +============================== + +LaTeX: pdfLaTeX と CJK パッケージを利用した日本語組版の支援 + +本パッケージは、日本語組版に適した CJK パッケージの設定を提供する。その +上で、pLaTeX ユーザにとって CJK パッケージの使用が容易にするために、 +pLaTeX カーネルや pLaTeX 用パッケージのものに類似した命令を提供する。 + +なお、CJK パッケージ自体は多種の入力エンコーディングをサポートしている +が、本パッケージでは UTF-8 のみをサポートすることに注意。 + +### 前提環境 + + * フォーマット: LaTeX + * エンジン: pdfTeX(DVI・PDF モード共に可) + * DVIウェア: 不問 + - 既定以外のフォント設定では dvipdfmx/pdfTeX が必須。 + * 依存パッケージ: + - CJK、CJKutf8、CJKspace、CJKpunct、etoolbox + - ipaex-type1(既定のフォントマップ使用時) + - zhmetrics(既定以外のフォントマップ使用時) + +### インストール + + - `*.sty` → $TEXMF/tex/latex/BXcjkjatype + +bxcjkjatype パッケージ +---------------------- + +### パッケージ読込 + + \usepackage[<option>,...]{bxcjkjatype} + +利用可能なオプションを以下で挙げる。 + +#### 自動囲み込み + +文書本体を `CJK(*)` 環境で自動的かつ安全に囲うためのオプション。文書中に +多量の CJK テキストが含まれる場合、或いは「動く引数」に CJK テキストが +含まれる場合はこれを指定するのが適切である。 + + * `whole`、`wholeCJK*`: 文書全体を `CJK*` 環境で囲む。(厳密に言うと + `\begin{uCJK*}`~`\end{uCJK*}` で囲む。) + * `wholeCJK`: 文書全体を `CJK` 環境で囲む。(厳密に言うと + `\begin{uCJK}`~`\end{uCJK}` で囲む。) + * `nowhole`(既定): `wholeCJK*` 及び `wholeCJK` の否定。 + +#### 「自動チルダ」 + +`autotilde` オプションを指定すると、`\CJKtilde` が自動的に呼び出されて +`~` が和欧文間空白(四分空き)の意味になる。なお、`\CJKtilde` 有効時は +`\nbs` で非分割欧文空白(本来の `~` の意味)が挿入できる。また、 +`\standardtilde` は `\CJKtilde` の効力を打ち消す。(これらは CJK +パッケージの機能である。) + + * `autotilde`: 全ての `CJK(*)` 環境の先頭で `\autotilde` が呼び出され + るようにする。 + * `noautotilde`(既定): `autotilde` の否定。 + +#### フォントマップ設定 + +[pxchfon パッケージ] と同等のフォントマップのプリセットが利用できる。 +詳細についてはそちらの解説文書を参照されたい。 + + * `oneweight`、`nooneweight`: pxchfon と同様。 + * pxchfon で利用可能なプリセットオプション(`ms` 等)が利用できる。 + (旧式のものを除く。) + * `ipaex-type1`: 本パッケージのフォント管理を無効にし、ipaex-type1 + パッケージのファミリ(`ipxm` と `ipxg`)を直接用いる。この設定では + `\mcdefault` の値は `ipxm` に、`\gtdefault` の値は `ipxg` になる。 + +[pxchfon パッケージ]: http://www.ctan.org/pkg/pxchfon + +#### CJK フォントスケール + + * `scale=<実数>`: CJK フォントに対するスケール値を設定する。 + +注意: `ipaex-type1` 指定時は CJK フォントスケールは使用不可。 + +#### その他のオプション + + * `everypage`: フォントマップ情報を出力 DVI 文書の全てのページに出力 + する。`dvipdfmx` ドライバでのみ有効。 + * `noeverypage`(既定): `everypage` の否定。 + * ドライバオプション: + `pdftex`、`dvipdfmx`、`dvips`、`none` が指定できる。ドライバ設定は + 既定(ipaex-type1)以外のフォントマップの使用時にのみ意味をもつ。 + さらに、フォントマップ変更は `pdftex` と `dvipdfmx` でのみサポート + されまたこの 2 つの値は常に自動判定可能(PDF モードでは `pdftex`、 + DVI モードでは `dvipdfmx` が既定)なので、実際にはドライバを指定する + 必要はない。 + +### 機能 + +#### CJK フォントの選択 + +本パッケージでは、pLaTeX + [japanese-otf パッケージ] で用いられるものと +同等の 3 つの「総称」CJK ファミリを用意する: 明朝(`\mcfamily`)、 +ゴシック(`\gtfamily`)、丸ゴシック(`\mgfamily`)。既定では ipaex-type1 +パッケージのフォントが割り当てられている:明朝→IPAex明朝、ゴシック→ +IPAexゴシック。この割り当ては変更可能である。 + + * `\mcfamily`: CJK ファミリを明朝ファミリに変更する。 + `\CJKfamily{\mcdefault}` と等価である。 + * `\gtfamily`: CJK ファミリをゴシックファミリに変更する。 + `\CJKfamily{\gtdefault}` と等価である。 + * `\mgfamily`: CJK ファミリを丸ゴシックファミリに変更する。 + `\CJKfamily{\mgdefault}` と等価である。 + +高度な命令: + + * `\mcdefault`/`\gtdefault`/`\mgdefault`: 総称ファミリに対応する + CJK ファミリ名である。標準の割当ではこれらの値は `mc`/`gt`/`mg` で + ありこの割当が既定で用いられる。 + + * `\setCJKfamilydefault{<CJKファミリ>}`: 既定の CJK ファミリを設定 + する。この既定値は、ある種の命令(例えば `\CJKfamily{}` や + `\begin{CJK}{UTF8}{}`)でファミリ名が省略された時に用いられる。 + (再定義後の)`\normalfont` は CJK ファミリをこの命令で設定した既定 + ファミリに変更する。 + + この既定ファミリの既定値は、文書の本体の先頭で有効である欧文ファミリ + の「対応ファミリ」となる。(次小節を参照。) + +[japanese-otf パッケージ]: http://www.ctan.org/pkg/japanese-otf + +#### CJK と欧文のファミリの連動 + +CJK パッケージ(および pTeX エンジン)では CJK と欧文で別々の「現在 +ファミリ」を管理する。この取扱は利点もあるが、多くの場合はこの 2 つの +「現在ファミリ」を連動させた方が都合がよい。この為、本パッケージでは現在 +欧文フォントを切り替える幾つかの LaTeX 命令について、CJK ファミリを欧文 +の「対応ファミリ」に切り替えるように再定義する。ここで「対応ファミリ」は +以下のように定められる: + + * `\rmfamily`(セリフ) → `\mcfamily`(明朝) + * `\sffamily`(サンセリフ) → `\gtfamily`(ゴシック) + * `\ttfamily`(等幅) → `\gtfamily`(ゴシック) + * その他のファミリについては、対応ファミリは `\mcfamily` とする。 + +再定義される命令: + + * `\rmfamily`/`\sffamily`/`\ttfamily`: 本来の動作の後、CJKファミリ + を欧文ファミリの「対応ファミリ」に変更する。 + * `\normalfont`: CJK ファミリを、`\setCJKfamilydefault` 命令により + 指定された既定 CJK ファミリに変更する。 + +`CJK`/`CJK*` 環境の省略系: + + * `\begin{uCJK*}...\end{uCJK*}`: 次のものと等価: + + \begin{CJK*}{UTF8}{対応ファミリ}...\end{CJK*} + + ただし `対応ファミリ` は現在の欧文ファミリの対応ファミリを表す。 + + 次のものと等価ではないことに注意: + + \begin{CJK*}{UTF8}{}...\end{CJK*} + + こちらは既定の CJK ファミリを使用する。 + + * `\begin{uCJK}...\end{uCJK}`: 次のものと等価: + + \begin{CJK}{UTF8}{対応ファミリ}...\end{CJK} + +#### フォントマップ設定 + +これらの命令の使い方は pxchfon パッケージの時と同じであるので、詳細に +ついてはそちらの解説文書を参照されたい。 + + * `\setminchofont[<ID>]{<フォントファイル名>}` + * `\setgothicfont[<ID>]{<フォントファイル名>}` + * `\setmarugothicfont[<ID>]{<フォントファイル名>}` + * `\setmediumminchofont[<ID>]{<フォントファイル名>}` + * `\setboldminchofont[<ID>]{<フォントファイル名>}` + * `\setmediumgothicfont[<ID>]{<フォントファイル名>}` + * `\setboldgothicfont[<ID>]{<フォントファイル名>}` + * `\setxboldgothicfont[<ID>]{<フォントファイル名>}` + +ところが、pdfTeX エンジンについてはフォントマップの仕様に関して重大な +制限が存在する。TrueType グリフであってかつ TTC 形式でないフォントのみ +が使用できる。(dvipdfmx 使用時は全ての種類の OpenType フォントが使用 +可能。) + +注意: 本パッケージは「明朝・細字」のフォントをサポートしない。従って、 +`\setlightminchofont` は動作しない。 + +#### その他の命令 + + * `\UTF{<16進数字>}`: CJK 文字を Unicode 符号値で入力する。例えば、 + `\UTF{5B57}` は `\Unicode{"5B}{"57}` と等価である。 + + * `\CJKforce{<character>...}`: 以降は引数の中にある各々の文字を CJK + 文字として扱う(CJK フォントで出力される)。 + + * `\CJKunforce{<character>...}`: `\CJKforce` の効果を打ち消す。 + + * `\@<character>`: 非 ASCII 文字の前に `\@` がある場合は、その文字 + (その出現のみ)を CJK 文字として扱う。ASCII 文字の前の `\@` は + LaTeX 本来の意味を保持する。 + + * `\CJKecglue`: 和欧文間空白を挿入する。`\CJKtilde` が有効な時は `~` + はこの命令を呼び出す。この命令をユーザが再定義して和欧文間空白の量を + 調節することができる(和文間空白の `\CJKglue` と同様)。 + + 使用例: + + \renewcommand{\CJKecglue}{\hspace{0.125em minus 0.125em}} + +### 補足事項 + + * 本パッケージで標準に用いられるフォントは、例えそれに ipaex-type1 の + フォントが割り当てられている場合でも、縦書きをサポートしない。しかし + ipaex-type1 が提供するファミリ(`ipxm` と `ipxg`)は縦書きをサポート + しており、`ipaex-type1` オプションを指定することでそれらのファミリを + 直接使うことができる。 + +更新履歴 +-------- + + * Version 0.2c <2013/10/18> + - CJK フォントスケールをサポートした。 + - `\CJKforce`、`\CJKunforce`、`\@` を追加。 + + * Version 0.2b <2013/09/28> + - `\UTF`、`\CJKecglue` を追加。 + + * Version 0.2a <2013/08/08> + - `autotilde` オプションを追加。 + + * Version 0.2 <2013/08/08> + - 最初の公開版。 + +-------------------- +Takayuki YATO (aka. "ZR") +http://zrbabbler.sp.land.to/ |