8a12b9944b
Reviewed by: Japanese Online Manual Project <man-jp@jp.FreeBSD.ORG> Submitted by: Kazuo Horikawa <k-horik@yk.rim.or.jp>
374 lines
8.7 KiB
Groff
374 lines
8.7 KiB
Groff
.ig \"-*- nroff -*-
|
|
Copyright (C) 1989-1995 Free Software Foundation, Inc.
|
|
|
|
Permission is granted to make and distribute verbatim copies of
|
|
this manual provided the copyright notice and this permission notice
|
|
are preserved on all copies.
|
|
|
|
Permission is granted to copy and distribute modified versions of this
|
|
manual under the conditions for verbatim copying, provided that the
|
|
entire resulting derived work is distributed under the terms of a
|
|
permission notice identical to this one.
|
|
|
|
Permission is granted to copy and distribute translations of this
|
|
manual into another language, under the above conditions for modified
|
|
versions, except that this permission notice may be included in
|
|
translations approved by the Free Software Foundation instead of in
|
|
the original English.
|
|
..
|
|
.de TQ
|
|
.br
|
|
.ns
|
|
.TP \\$1
|
|
..
|
|
.\" Like TP, but if specified indent is more than half
|
|
.\" the current line-length - indent, use the default indent.
|
|
.de Tp
|
|
.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
|
|
.el .TP "\\$1"
|
|
..
|
|
.\"
|
|
.\" Original Revision: 1.1.1.1
|
|
.\" jpman %Id: groff_font.5,v 1.3 1998/08/09 15:05:21 ryo2 Stab %
|
|
.\"
|
|
.\" FreeBSD jpman project 訳語表
|
|
.\" WORD: machine unit マシン単位
|
|
.\" WORD: scaled point スケールドポイント (troff.1 の記述にあわせた)
|
|
.\" WORD: font position フォント位置 (troff.1 の記述にあわせた)
|
|
.\" WORD: mount マウント
|
|
.\"
|
|
.TH GROFF_FONT 5 "7 September 1996" "Groff Version 1.11"
|
|
.SH 名称
|
|
groff_font \- groff のデバイスとフォントを記述するファイルの書式
|
|
.SH 解説
|
|
groff のフォントの書式は ditroff のフォントの書式に対し、
|
|
ほぼスーパセットになっています。
|
|
ditroff のフォントの書式とは異なり、
|
|
関連したバイナリ書式はありません。
|
|
.I name
|
|
というデバイス用のフォントファイルは
|
|
.BI dev name
|
|
というディレクトリに納められます。
|
|
ファイルには 2 つの種類があります: それは
|
|
.B DESC
|
|
と呼ばれるデバイス記述ファイルと、各フォント
|
|
.I F
|
|
ごとに存在する
|
|
.IR F
|
|
と呼ばれるフォントファイルです。
|
|
これらはテキストファイルであり、関連したバイナリ書式の
|
|
ファイルはありません。
|
|
.SS DESC ファイルの書式
|
|
DESC ファイルは以下の形式の行を含むことができます:
|
|
.TP
|
|
.BI res\ n
|
|
1 インチあたりのマシン単位は
|
|
.I n
|
|
です。
|
|
.TP
|
|
.BI hor\ n
|
|
水平解像度は
|
|
.I n
|
|
マシン単位です。
|
|
.TP
|
|
.BI vert\ n
|
|
垂直解像度は
|
|
.I n
|
|
マシン単位です。
|
|
.TP
|
|
.BI sizescale\ n
|
|
ポイント数への倍率を指定します。デフォルトの値は 1 です。1
|
|
.I スケールドポイント
|
|
は、1
|
|
.RI ポイント/ n
|
|
と等しくなります。
|
|
.B unitwidth
|
|
コマンドと
|
|
.B sizes
|
|
コマンドへの引数はスケールドポイントで指定されます。
|
|
.TP
|
|
.BI unitwidth\ n
|
|
ポイントサイズが
|
|
.I n
|
|
スケールドポイントのフォントに対して、
|
|
フォントファイル毎の数量をマシン単位で与えます。
|
|
.TP
|
|
.B tcommand
|
|
ポストプロセッサが
|
|
.B t
|
|
と
|
|
.B u
|
|
の出力コマンドを扱えることを表します。
|
|
.TP
|
|
.BI sizes\ s1\ s2\|.\|.\|.\|sn\ 0
|
|
デバイスが
|
|
.IR s1 ,
|
|
.IR s2 ,\|.\|.\|.\| sn
|
|
スケールドポイントのフォントを持つことを表します。
|
|
大きさのリストは
|
|
.BR 0
|
|
で終らなければなりません。
|
|
各
|
|
.BI s i
|
|
は大きさの範囲
|
|
.IR m \- n
|
|
でも指定できます。
|
|
リストは複数行にわたることも可能です。
|
|
.TP
|
|
.BI styles\ S1\ S2\|.\|.\|.\|Sm
|
|
先頭
|
|
.I m
|
|
個のフォント位置が、スタイル
|
|
.IR S1\|.\|.\|.\|Sm
|
|
に関連づけられます。
|
|
.TP
|
|
.BI fonts\ n\ F1\ F2\ F3\|.\|.\|.\|Fn
|
|
フォント
|
|
.I F1\|.\|.\|.\|Fn
|
|
がフォント位置
|
|
.IR m +1,\|.\|.\|., m + n
|
|
にマウントされます(
|
|
.I m
|
|
はスタイル数)。
|
|
このコマンドは複数行にわたることができます。
|
|
.B 0
|
|
というフォント名を指定すると、
|
|
対応するフォント位置にはフォントはマウントされません。
|
|
.TP
|
|
.BI family\ fam
|
|
デフォルトのフォントファミリは
|
|
.IR fam
|
|
です。
|
|
.TP
|
|
.B charset
|
|
この行とファイル内の以下に続く行はすべて無視されます。
|
|
これは下位互換性のために許されています。
|
|
.LP
|
|
res, unitwidth, fonts, sizes の行は必須です。
|
|
他のコマンドは
|
|
.B troff
|
|
には無視されますが、デバイスに関する任意の情報を DESC ファイルに
|
|
入れておくためにポストプロセッサにより使われるかもしれません。
|
|
.SS フォントファイルの書式
|
|
フォントファイルには 2 つのセクションがあります。
|
|
最初のセクションは空白で区切られた単語が並んだ一連の行からなります。
|
|
行の最初の単語はキーで、以降の単語はそのキーに対する値となります。
|
|
.TP
|
|
.BI name\ F
|
|
フォントの名前は
|
|
.IR F
|
|
です。
|
|
.TP
|
|
.BI spacewidth\ n
|
|
空白の通常の幅は
|
|
.IR n
|
|
です。
|
|
.TP
|
|
.BI slant\ n
|
|
フォントの文字が
|
|
.I n
|
|
度傾斜していることを表します (正の値は進行方向を意味します)。
|
|
.TP
|
|
.BI ligatures\ lig1\ lig2\|.\|.\|.\|lign\ \fR[ 0 \fR]
|
|
文字
|
|
.IR lig1 ,
|
|
.IR lig2 ,\|.\|.\|., lign
|
|
は合字 (リガチャ; ligature) です。合字には
|
|
.BR ff ,
|
|
.BR fi ,
|
|
.BR fl ,
|
|
.BR ffl
|
|
が使用可能です。
|
|
下位互換性のために、合字のリストは
|
|
.BR 0
|
|
で終ってもかまいません。
|
|
合字のリストは複数行にわたってはいけません。
|
|
.TP
|
|
.B special
|
|
フォントは
|
|
.IR スペシャル
|
|
です。これは現在のフォントに存在しない文字が要求された場合、
|
|
マウントされた全てのスペシャルフォントが検索されることを示しています。
|
|
.LP
|
|
他のコマンドは
|
|
.B troff
|
|
には無視されますが、フォントに関する任意の情報をフォントファイルに
|
|
入れておくためにポストプロセッサにより使われるかも知れません。
|
|
.LP
|
|
最初のセクションには
|
|
.B #
|
|
文字ではじまるコメントを、行末まで入れることができます。
|
|
.LP
|
|
次のセクションには 1 つか 2 つのサブセクションが含まれます。
|
|
サブセクション
|
|
.I charset
|
|
は必須で、サブセクション
|
|
.I kernpairs
|
|
はオプションです。
|
|
これらのサブセクションは任意の順番で書くことができます。
|
|
各サブセクションは、サブセクション名のみからなる行から始まります。
|
|
.LP
|
|
単語
|
|
.B charset
|
|
で charset サブセクションを開始します。
|
|
.B charset
|
|
行には一連の行が続きます。
|
|
各行は 1 文字の情報を与えます。
|
|
行は空白かタブにより区切られたいくつかのフィールドから成ります。
|
|
書式は
|
|
.IP
|
|
.I
|
|
name metrics type code comment
|
|
.LP
|
|
で、
|
|
.I name
|
|
は文字を識別します:
|
|
.I name
|
|
が単一の文字
|
|
.I c
|
|
ならば、それは groff の入力文字
|
|
.I c
|
|
を表します。
|
|
.BI \e c
|
|
という形式で c が単一の文字なら、groff の入力文字
|
|
.BI \e c
|
|
を表します。それ以外は groff の入力文字
|
|
.BI \e[ name ]
|
|
を表します (2 文字の
|
|
.I xx
|
|
だとすると、
|
|
.BI \e( xx
|
|
として入力されます) 。
|
|
groff は 8 ビット文字に対応していますが、いくつかのユーティリティでは
|
|
8 ビット文字を扱うのが困難です。
|
|
このような理由から、文字コードが
|
|
.I n
|
|
である単一の文字と等価な
|
|
.BI char n
|
|
という表記法が存在します。
|
|
例えば、
|
|
.B char163
|
|
は ISO Latin-1 で英国ポンド記号を表す文字コード 163 の文字と等価です。
|
|
.B \-\-\-
|
|
という name は特別で、その文字に名前が無いことを示します。
|
|
そのような文字は
|
|
.BR troff
|
|
中でエスケープシーケンス
|
|
.B \eN
|
|
によってのみ使われます。
|
|
.LP
|
|
.I type
|
|
フィールドは文字の種類を示します:
|
|
.TP
|
|
1
|
|
は descender (ベースラインより下にはみ出した部分) を持つ
|
|
文字であることを表します。例えば p があてはまります。
|
|
.TP
|
|
2
|
|
は ascender (x の高さより上に出る部分) を持つ文字であることを表します。
|
|
例えば b があてはまります。
|
|
.TP
|
|
3
|
|
は ascender と descender の両方を持つ文字であることを表します。
|
|
例えば ( があてはまります。
|
|
.LP
|
|
.I code
|
|
フィールドはポストプロセッサが文字を印字するために使うコードを示します。
|
|
.B \eN
|
|
というエスケープシーケンスを用いたこのコードを使って、groff に文字を
|
|
入力することもできます。
|
|
code はどんな整数でもかまいません。
|
|
.B 0
|
|
から始まると、8 進数として扱われ、
|
|
.B 0x
|
|
や
|
|
.B 0X
|
|
で始まると 16 進数として扱われます。
|
|
.LP
|
|
行の code フィールド以降はすべて無視されます。
|
|
.LP
|
|
.I metrics
|
|
フィールドの形式はこのようになります:
|
|
.IP
|
|
.IR width [\fB, height [\fB, depth [\fB, italic_correction [\fB, \
|
|
left_italic_correction [\fB, subscript_correction ]]]]]
|
|
.LP
|
|
サブフィールド間には空白を入れてはいけません。
|
|
サブフィールドが存在しない場合は 0 として扱われます。
|
|
サブフィールドは全て 10 進数の整数で指定されます。
|
|
対応するバイナリフォーマットが存在しないので、
|
|
ditroff のようにこれらの値を
|
|
.B char
|
|
型変数の範囲に合わせるという必要はありません。
|
|
サブフィールド
|
|
.I width
|
|
では文字の幅を指定します。
|
|
サブフィールド
|
|
.I height
|
|
では文字の高さを指定します (上が正)。
|
|
文字がベースラインよりも上にいかない場合、負の高さを持つとするのではなく
|
|
高さが 0 であるとします。
|
|
サブフィールド
|
|
.I depth
|
|
では文字の深さを指定します。これはベースラインから文字の一番下までの
|
|
長さです (下が正) 。
|
|
文字がベースラインより下に出ていない場合、負の深さを持つとするのではなく
|
|
深さが 0 であるとします。
|
|
サブフィールド
|
|
.I italic_correction
|
|
では直後にローマンフォントの文字が続く時に、文字の後に加えられる空白の
|
|
量を指定します。
|
|
サブフィールド
|
|
.I left_italic_correction
|
|
では直前にローマンフォントの文字がある時に、文字の前に加えられる空白の
|
|
量を指定します。
|
|
サブフィールド
|
|
.I subscript_correction
|
|
では添字 (subscript) を加える際に文字の後に加えられる空白の量を
|
|
指定します。
|
|
これはイタリック補正 (上記の italic_correction) よりは少なくなければ
|
|
なりません。
|
|
.LP
|
|
charset セクション内では、以下のような書式の行も可能です
|
|
.IP
|
|
.I
|
|
name \fB"
|
|
.LP
|
|
これは
|
|
.I name
|
|
が前の行で言及した文字の別名であることを表します。
|
|
.LP
|
|
kernpairs セクションは
|
|
.B kernpairs
|
|
という単語から始まります。このセクションは以下のような書式の
|
|
行からなります:
|
|
.IP
|
|
.I
|
|
c1 c2 n
|
|
.LP
|
|
文字
|
|
.I c1
|
|
が文字
|
|
.I c2
|
|
の次に現れる時には、それらの間の空白に
|
|
.IR n
|
|
を加えることを意味します。
|
|
kernpairs セクションのほとんどのエントリは
|
|
.IR n
|
|
に負の値を持つことになります。
|
|
.SH 関連ファイル
|
|
.Tp \w'/usr/share/groff_font/devname/DESC'u+3n
|
|
.BI /usr/share/groff_font/dev name /DESC
|
|
デバイス
|
|
.IR name
|
|
用のデバイス記述ファイル
|
|
.TP
|
|
.BI /usr/share/groff_font/dev name / F
|
|
デバイス
|
|
.IR name
|
|
のフォント
|
|
.I F
|
|
用のフォントファイル
|
|
.SH 関連項目
|
|
.BR groff_out (5),
|
|
.BR troff (1).
|