Manpages

名 称

grohtml − groff の HTML ド ラ イ バ

書 式

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 バ ー ジ ョ ン 番 号 を 印 字 し ま す 。

−? 使 用 法 を 表 示 し ま す 。

使 用 法

R, I, B, BI と い う 形 式 が あ り 、 フ ォ ン ト ポ ジ シ ョ ン 1 か ら 4 に マ ウ ン ト さ れ ま す 。 groff を -mhtml マ ク ロ セ ッ ト 付 き で 起 動 す る 事 を お 勧 め し ま す 。 こ の マ ク ロ セ ッ ト を 指 定 す る と 、 へ ッ ダ 、 フ ッ タ 、 ハ イ フ ネ ー シ ョ ン を 無 効 に し て 、 更 に テ キ ス ト を 右 揃 え し ま す 。

依 存 関 係

grohtml は grops と gs に 依 存 し ま す 。 grohtml が gif フ ァ イ ル を 生 成 す る よ う 構 成 さ れ て い る 場 合 に は 、 更 に ppmtogif と ppmquant に も 依 存 し ま す 。 し か し な が ら png フ ァ イ ル を 生 成 す る よ う 構 成 さ れ て い る 場 合 (デ フ ォ ル ト ) に は png 出 力 デ バ イ ス を 持 つ gs に 依 存 し ま す 。 画 像 は 表 、 図 、 式 や 線 に 遭 遇 し た 時 に 生 成 さ れ ま す 。

バ グ

こ れ は ま だ ま だ ア ル フ ァ バ ー ジ ョ ン で す 。 少 な く と も 三 つ の 大 き な バ グ が 残 っ て い ま す 。 第 一 に 、 grohtml は HTML テ ー ブ ル の 終 わ り の 判 断 を 間 違 え て 、 同 じ テ キ ス ト が 2 回 出 力 さ れ て し ま う こ と が あ り ま す 。 第 二 に 式 番 号 が 正 し く 処 理 さ れ ま せ ん 。 第 三 に 式 マ ク ロ と 図 の マ ク ロ が grohtml を 混 乱 さ せ る こ と が あ り ま す 。

関 連 項 目

afmtodit(1), groff(1), troff(1), psbb(1), groff_out(5), groff_font(5), groff_char(7)