Man page - groff_mwww(7)
Manual
GROFF_MWWW
名 称書 式
解 説
書 式
リ ク エ ス ト
セ ク シ ョ ン 見 出 し へ の リ ン ク
grohtml の 制 限
関 連 フ ァ イ ル
関 連 項 目
作 者
バ グ
名 称
groff_mwww - ウ ェ ブ ペ ー ジ の オ ー サ リ ン グ 用 groff マ ク ロ
書 式
groff -mwww [ options ] file ...
解 説
こ の マ ニ ュ ア ル ペ ー ジ は 、 GNU -mwww マ ク ロ に つ い て 解 説 し て い ま す 。 こ れ は 、 groff ド キ ュ メ ン ト 整 形 シ ス テ ム の 一 部 で す 。 こ の マ ニ ュ ア ル ペ ー ジ は 、 ご く 基 本 的 な ガ イ ド に 過 ぎ ま せ ん し 、 html デ バ イ ス ド ラ イ バ (grohtml) は い ま だ に ア ル フ ァ 版 と い う 段 階 で す 。 多 く の 人 達 が テ ス ト す る 機 会 を 持 て る よ う に す る た め 、 こ の マ ク ロ を 配 布 物 に 含 め て い る の で す 。 こ の マ ク ロ フ ァ イ ル は 、 -Thtml を 使 用 す れ ば ( troffrc フ ァ イ ル に よ っ て ) 自 動 的 に 呼 ば れ る の だ と い う こ と に 注 意 し て く だ さ い 。
ハ イ パ ー リ ン ク が 動 作 す る こ と を 確 認 す る に は 、 こ の マ ニ ュ ア ル ペ ー ジ を grohtml デ バ イ ス を 用 い て 整 形 し て く だ さ い 。
こ れ は 、 こ の マ ク ロ セ ッ ト で 見 つ か る 機 能 の 概 要 で す 。
書 式
|
.HTMLINDEX |
セ ク シ ョ ン / ヘ ッ ダ 用 に 自 動 的 に |
|
|
作 成 さ れ る リ ン ク の レ ベ ル を 決 定 し ま す 。 |
||
|
.BODYCOLOR |
ウ ェ ブ ペ ー ジ の 色 を 指 定 し ま す 。 |
|
|
.BACKGROUND |
背 景 画 像 を 指 定 し ま す 。 |
|
|
.URL |
2 つ の パ ラ メ ー タ を 用 い て URL を 作 成 し ま す 。 |
|
|
.MAILTO |
HTML 用 電 子 メ ー ル ア ド レ ス を 作 成 し ま す 。 |
|
|
.FTP |
FTP へ の 参 照 を 作 成 し ま す 。 |
|
|
.IMAGE |
画 像 フ ァ イ ル を 挿 入 し ま す 。 |
|
|
.HTML |
デ バ イ ス ド ラ イ バ に 生 の HTML |
|
|
リ ク エ ス ト を 渡 し ま す 。 |
||
|
.TAG |
$1 か ら HTML の name タ グ を 生 成 し ま す 。 |
|
|
.LINE |
水 平 方 向 の 罫 線 を 幅 い っ ぱ い に 作 成 し ま す 。 |
pic , eqn , refer お よ び tbl プ リ プ ロ セ ッ サ の 出 力 を 入 力 と し て 受 け 付 け る こ と が で き ま す 。
リ ク エ ス ト
HTMLINDEX
見 出 し に 対 し て 自 動 的 に 作 成 さ れ る リ ン ク の 切 り 捨 て レ ベ ル を 決 定 し ま す 。 デ フ ォ ル ト で は 、 troff ド キ ュ メ ン ト 中 に あ る す べ て の 見 出 し へ の リ ン ク が HTML ウ ェ ブ ペ ー ジ の 先 頭 に 作 成 さ れ ま す 。 お そ ら く 、 細 か い レ ベ ル の 見 出 し に は リ ン ク は 必 要 な い こ と が 多 い で し ょ う 。 ま た ウ ェ ブ ペ ー ジ に よ っ て は 、 見 出 し へ の リ ン ク は 一 切 必 要 な い も の も あ る か も し れ ま せ ん 。 こ の よ う な 場 合 、
.HTMLINDEX 0
と す る と 、 grohtml が リ ン ク を 生 成 し な い よ う に な り ま す 。 HTMLINDEX を 2 に す る と
1.1.1 Some Title
と い う 見 出 し も 、 3 レ ベ ル 目 の 見 出 し が あ る と い う こ と に よ り 、 リ ン ク に 含 ま れ な い よ う に な り ま す 。 自 動 的 な 見 出 し を 切 り 替 え る 別 の 方 法 は 、 コ マ ン ド ラ イ ン ス イ ッ チ -P-l で す 。
BODYCOLOR
5 つ パ ラ メ ー タ を 取 り ま す : 文 字 色 、 背 景 色 、 ア ク テ ィ ブ な ハ イ パ ー リ ン ク の 色 、 ま だ 訪 問 し た こ と が な い ハ イ パ ー リ ン ク の 色 、 そ し て 訪 問 し た こ と の あ る ハ イ パ ー リ ン ク の 色 で す 。
BACKGROUND
こ の マ ク ロ の 唯 一 の パ ラ メ ー タ は 、 背 景 画 像 フ ァ イ ル を 示 し ま す 。
|
URL |
2 つ あ る い は 3 つ の パ ラ メ ー タ を 使 用 し て URL を 生 成 し ま す 。 $1 は リ ン ク 名 、 $2 は 実 際 の URL、 そ し て $3 は $2 の 直 後 に 印 字 さ れ る オ プ シ ョ ン 部 分 で す 。 実 際 の URL を 印 字 す る 間 、 ハ イ フ ネ ー シ ョ ン は 無 効 化 さ れ ま す 。 明 示 的 な 改 行 位 置 は 、 \: で 挿 入 す べ き で す 。 こ れ は 、 http://groff.ffii.org/ : の エ ン コ ー ド の 方 法 を 示 し た も の で す 。 |
.URL "groff の ホ ー ム ペ ー ジ " http://\:groff.\:ffii.\:org/ :
-Thtml 以 外 の デ バ イ ス で こ れ を 処 理 す る と 、 次 の よ う に 表 示 さ れ ま す : groff の ホ ー ム ペ ー ジ ⟨ http://groff. ffii.org⟩ 。 URL マ ク ロ は 、 ど ん な 種 類 の 要 素 で も 使 え ま す 。 例 え ば 、 pic.html と い う 参 照 を 次 の よ う に し て 作 る こ と が で き ま す :
.URL "Eric Raymond の pic ガ イ ド " pic.html
|
MAILTO |
HTML 用 の 電 子 メ ー ル 参 照 を 生 成 し ま す 。 第 1 引 数 は 、 電 子 メ ー ル ア ド レ ス と し て 必 須 の も の で す 。 第 2 引 数 は オ プ シ ョ ン で あ り 、 ブ ラ ウ ザ に 表 示 さ れ る テ キ ス ト で す 。 そ し て 、 第 3 引 数 も オ プ シ ョ ン で あ り 、 こ れ は 第 2 引 数 の 直 後 に 表 示 さ れ る も の で す 。 実 際 の 電 子 メ ー ル ア ド レ ス を 印 字 す る 間 、 ハ イ フ ネ ー シ ョ ン は 無 効 化 さ れ ま す 。 例 え ば 、 groff メ ン テ ナ は と で す 。 こ れ は 、 次 の マ ク ロ で 実 現 し ま す : |
.MAILTO wl@gnu.org "Werner Lemberg" .MAILTO Ted.Harding@nessie.mcc.ac.uk "Ted Harding" .
実 際 に は 、 groff で は URL は テ キ ス ト と し て の 空 白 を 一 切 使 わ な い も の と し て 扱 わ れ る こ と に 注 意 し て く だ さ い 。 こ の こ と は 、 い く つ か の 問 題 の 原 因 と な り ま す の で バ グ だ と 考 え ら れ る で し ょ う 。 こ れ を 回 避 す る た め に 、 www.tmac は 他 に 影 響 を 与 え な い 空 白 に 展 開 さ れ る 幅 0 の 文 字 を 挿 入 し ま す (-Thtml 付 で 実 行 さ れ た 場 合 の み )。
|
FTP |
デ ー タ が FTP 経 由 で 取 得 で き る こ と を 示 し ま す 。 第 1 引 数 は 、 ブ ラ ウ ザ に 表 示 さ れ る テ キ ス ト で あ り 、 第 2 引 数 は URL で す 。 第 3 引 数 は 、 先 に 述 べ た マ ク ロ と 同 様 に 、 第 2 引 数 の 直 後 に 表 示 さ れ る テ キ ス ト と し て 扱 わ れ ま す 。 第 2 お よ び 第 3 の 引 数 は オ プ シ ョ ン で す 。 実 際 の URL を 印 字 す る 間 、 ハ イ フ ネ ー シ ョ ン は 無 効 化 さ れ ま す 。 例 と し て 、 こ れ は 、 ftp://ftp.ffii.org/pub/groff/devel/groff-current.tar.gz の 場 所 で す 。 こ の マ ク ロ の 例 は 、 次 の よ う に 指 定 し ま す : |
.FTP "現 在 の groff 開 発 者 用 配 布 物 " \ ftp://ftp.ffii.org/\:pub/\:groff/\:devel/\:groff-current.tar.gz
|
IMAGE |
ド キ ュ メ ン ト に 画 像 を 含 め る こ と が で き ま す 。 第 1 引 数 は 画 像 フ ァ イ ル で す 。 第 2 の オ プ シ ョ ン は 、 水 平 位 置 を 指 定 し ま す 。 l は 画 像 を 左 寄 せ に 、 r は 画 像 を 右 寄 せ に し ま す 。 そ の 他 の 値 は 画 像 を 中 央 に 置 き ま す 。 次 の 2 つ の 引 数 は オ プ シ ョ ン で す 。 第 3 引 数 は 画 素 数 で の 画 像 の 幅 で す (指 定 が な け れ ば 、 デ フ ォ ル ト は 400 画 素 で す )。 第 4 引 数 は 画 素 数 で の 画 像 の 高 さ で す (指 定 が な け れ ば 、 デ フ ォ ル ト は 画 像 幅 と 同 じ で す )。 |
||
|
HTML |
こ の マ ク ロ の 後 に 続 い た テ キ ス ト は す べ て 生 の HTML と し て 扱 わ れ ま す 。 ド キ ュ メ ン ト が -Thtml を 使 わ ず に 処 理 さ れ る 場 合 、 こ の マ ク ロ は 無 視 さ れ ま す 。 こ の マ ク ロ は 、 よ り 高 水 準 な 他 の マ ク ロ の 構 成 要 素 で す 。 |
例 え ば 、 BACKGROUND マ ク ロ は 次 の よ う に 定 義 さ れ ま す :
.de BACKGROUND . HTML <body background=\$1> ..
|
TAG |
引 数 か ら HTML の name タ グ を 生 成 し ま す 。 こ の タ グ は 、 #URL マ ク ロ を 使 っ て 参 照 で き ま す 。 御 覧 の 通 り 、 同 一 ド キ ュ メ ン ト 内 の 参 照 で す の で 、 タ グ 名 の 前 に は ‘ # ’ を 付 け な く て は な り ま せ ん 。 こ の リ ン ク は 、 先 の URL マ ク ロ の 記 述 の 中 で TAG を 置 く こ と で 実 現 し た の で す 。 ソ ー ス は 次 の よ う に な り ま す : |
.TP .B URL は 、 .TAG URL を 生 成 し ま す 。 URL は 2 個 あ る い は 3 個 の 引 数 を 使 い ま す 。 $1 が リ ン ク の 名 前 、 そ し て $2 が 実 際 の URL で す 。
|
LINE |
水 平 方 向 に 幅 い っ ぱ い の 罫 線 を 生 成 し ま す 。 次 が 例 で す : |
.LINE
|
LINKS |
は 、 grohtml が 自 動 的 に 生 成 さ れ る リ ン ク を こ の 位 置 へ 置 く よ う 要 求 し ま す 。 例 : |
セ ク シ ョ ン 見 出 し へ の リ ン ク
デ フ ォ ル ト で は 、 grohtml は セ ク シ ョ ン の 見 出 し す べ て へ の リ ン ク を 生 成 し 、 リ ン ク を HTML ド キ ュ メ ン ト の 先 頭 に 配 置 し ま す 。 オ フ に し た り 位 置 を 変 え る た め の 詳 細 は #LINK を 参 照 し て く だ さ い 。
grohtml の 制 限
tbl 情 報 は 、 現 状 png イ メ ー ジ で 描 か れ ま す 。
関 連 フ ァ イ ル
/usr/share/tmac/mwww.tmac
(www.tmac へ の ラ ッ パ )
/usr/share/tmac/www.tmac
関 連 項 目
groff (1), troff (1), grohtml (1)
作 者
grohtml は が 書 き ま し た 。
バ グ
バ グ レ ポ ー ト は へ 送 っ て く だ さ い 。 バ グ が 再 現 で き る よ う に 、 完 全 で 自 己 完 結 し て い る 例 を 付 け て く だ さ い 。 ま た 、 ど の バ ー ジ ョ ン の groff を 使 っ て い る か も 伝 え て く だ さ い 。