.ig \"-*- nroff -*-
.\" jpman %Id: grohtml.1,v 1.3 2000/04/25 16:54:27 yt-kage Stab %
.\" WORD: hyphenation	ハイフネーション (ハイフンで文字を連結する)
Copyright (C) 1999-2000 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.
..
.\" 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"
..
.TH GROHTML 1 "7 December 2000" "Groff Version 1.16.1"
.SH 名称
grohtml \- groff の HTML ドライバ
.SH 書式
.nr a \n(.j
.ad l
.nr i \n(.i
.in +\w'\fBgrohtml 'u
.ti \niu
.B grohtml
.de OP
.ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]"
.el .RB "[\ " "\\$1" "\ ]"
..
.OP \-atTvdgm?
.OP \-F dir
.OP \-I imagetype
.OP \-r resolution
.RI "[\ " files\|.\|.\|. "\ ]"
.br
.ad \na
.PP
コマンドラインオプションとパラメータの間に空白を含めることが可能です。
.SH 解説
.B grohtml
は GNU
.B troff
の出力を HTML に翻訳します。
通常は
.B grohtml
は
.B \-Thtml
オプションを付けて groff コマンドを使用することで起動されます。
ファイルが与えられない場合、
.B grohtml
は標準入力を読みます。
ファイル名が
.B \-
のときでも、
.B grohtml
は標準入力を読みます。
HTML 出力は標準出力へ書き出されます。
.B groff
から
.B grohtml
を実行する時は、
.B groff
.B \-P
を使用して
.B grohtml
にオプションを渡すことが出来ます。
.SH オプション
.TP
.B \-a
.B grohtml
に troff が指定したのと同じ位置で HTML の改行を出力するよう強制します。
このオプションなしでは
.B grohtml
は HTML ブラウザにより整形される段落中にテキストを出力します。
.TP
.B \-d
内部デバッギングを有効にします。
.TP
.B \-g
.B grohtml
に表題や見出しを推測しないよう伝えます。
-m や -a フラグと一緒にこのフラグを使用することにより
.B grohtml
は HTML ブラウザを整形機ではなくプリンタとして扱います。
.TP
.B \-m
余白をそのままにします。
.B grohtml
は左の余白を取り除きません。
.TP
.B \-t 
.B grohtml
が字下げや表の文を実現する時に HTML の表を生成することを禁止します。
.B grohtml
は表あるいは HTML の字下げにより .IP を実現出来ます。
しかしながら .2C が使用される場合には、
テーブル構造を使用したときだけ、それと判るように HTML に変換出来ます。
HTML のテーブルのコードに 2,3 の既知のバグがまだ存在するため、
このオプションは、開発中のコードの実行を抑止するために存在します。
.B grohtml
でのデフォルトは、適切な時には HTML テーブルが生成されます。
.TP
.B \-T
tbl からの出力を処理するときに、
.B grohtml
がイメージを生成することを禁止します。
簡単なテキストの表が生成されるときに有用です。
.TP
.BI \-F dir
フォントとデバイス記述ファイルのために
.IB dir /dev name
を検索します ;
.I name
がデバイスの名前であり、通常は
.BR html 
です。
.TP
.BI \-I imagetype
grohtmlが式や表、図に遭遇した時に生成する画像の形式を選択します。
このデフォルトは png256 です。
受け付けられる画像形式は gif および ghostscript gs(1) によりサポート
される任意の png です。
.TP
.BI \-r resolution
全ての画像の解像度を選択します。
デフォルトではインチ当り 80 ピクセルです。
例: -r100 はインチ当り 100 ピクセルを示します。
.TP
.B \-v
バージョン番号を印字します。
.TP
.B \-?
使用法を表示します。
.SH 使用法
.BR R ,
.BR I ,
.BR B ,
.B BI
という形式があり、フォントポジション 1 から 4 にマウントされます。
groff を -mhtml マクロセット付きで起動する事をお勧めします。
このマクロセットを指定すると、へッダ、フッタ、ハイフネーションを
無効にして、更にテキストを右揃えします。
.SH 依存関係
.B grohtml
は grops と gs に依存します。
.B grohtml
が gif ファイルを生成するよう構成されている場合には、更に ppmtogif と
ppmquant にも依存します。
しかしながら png ファイルを生成するよう構成されている場合 (デフォルト)
には png 出力デバイスを持つ gs に依存します。
画像は表、図、式や線に遭遇した時に生成されます。
.SH バグ
これはまだまだアルファバージョンです。
少なくとも三つの大きなバグが残っています。
第一に、
.B grohtml
は HTML テーブルの終わりの判断を間違えて、同じテキストが 2 回出力されて
しまうことがあります。
第二に式番号が正しく処理されません。
第三に式マクロと図のマクロが
.BR grohtml 
を混乱させることがあります。
.SH 関連項目
.BR afmtodit (1),
.BR groff (1),
.BR troff (1),
.BR psbb (1),
.BR groff_out (5),
.BR groff_font (5),
.BR groff_char (7)