書式
grohtml [ -atTvdgm? ] [ -Fdir ] [ -Iimagetype ] [ -rresolution ] [ files... ]
コマンドラインオプションとパラメータの間に空白を含めることが可能です。
解説
grohtml は GNU troff の出力を HTML に翻訳します。 通常は grohtml は -Thtml オプションを付けて groff コマンドを使用することで起動されます。 ファイルが与えられない場合、 grohtml は標準入力を読みます。 ファイル名が - のときでも、 grohtml は標準入力を読みます。 HTML 出力は標準出力へ書き出されます。 groff から grohtml を実行する時は、 groff -P を使用して grohtml にオプションを渡すことが出来ます。オプション
- -a
- grohtml に troff が指定したのと同じ位置で HTML の改行を出力するよう強制します。 このオプションなしでは grohtml は HTML ブラウザにより整形される段落中にテキストを出力します。
- -d
- 内部デバッギングを有効にします。
- -g
- grohtml に表題や見出しを推測しないよう伝えます。 -m や -a フラグと一緒にこのフラグを使用することにより grohtml は HTML ブラウザを整形機ではなくプリンタとして扱います。
- -m
- 余白をそのままにします。 grohtml は左の余白を取り除きません。
- -t
- grohtml が字下げや表の文を実現する時に HTML の表を生成することを禁止します。 grohtml は表あるいは HTML の字下げにより .IP を実現出来ます。 しかしながら .2C が使用される場合には、 テーブル構造を使用したときだけ、それと判るように HTML に変換出来ます。 HTML のテーブルのコードに 2,3 の既知のバグがまだ存在するため、 このオプションは、開発中のコードの実行を抑止するために存在します。 grohtml でのデフォルトは、適切な時には HTML テーブルが生成されます。
- -T
- tbl からの出力を処理するときに、 grohtml がイメージを生成することを禁止します。 簡単なテキストの表が生成されるときに有用です。
- -Fdir
- フォントとデバイス記述ファイルのために dir/devname を検索します ; name がデバイスの名前であり、通常は html です。
- -Iimagetype
- grohtmlが式や表、図に遭遇した時に生成する画像の形式を選択します。 このデフォルトは png256 です。 受け付けられる画像形式は gif および ghostscript gs(1) によりサポート される任意の png です。
- -rresolution
- 全ての画像の解像度を選択します。 デフォルトではインチ当り 80 ピクセルです。 例: -r100 はインチ当り 100 ピクセルを示します。
- -v
- バージョン番号を印字します。
- -?
- 使用法を表示します。