Update to the version based on Groff Version 1.19
This commit is contained in:
Kazuo Horikawa
parent
a32fdb17e8
commit
e9d3985134
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=17101
4 changed files with 1173 additions and 574 deletions
|
|
@ -12,7 +12,7 @@ MAN7 = ascii.7\
|
||||||
groff_mm.7\
|
groff_mm.7\
|
||||||
groff_mmse.7\
|
groff_mmse.7\
|
||||||
groff_ms.7\
|
groff_ms.7\
|
||||||
groff_mwww.7\
|
groff_www.7\
|
||||||
hier.7\
|
hier.7\
|
||||||
hostname.7\
|
hostname.7\
|
||||||
intro.7\
|
intro.7\
|
||||||
|
|
@ -34,7 +34,6 @@ MLINKS+=groff_me.7 me.7
|
||||||
MLINKS+=groff_mm.7 mm.7
|
MLINKS+=groff_mm.7 mm.7
|
||||||
MLINKS+=groff_mmse.7 mmse.7
|
MLINKS+=groff_mmse.7 mmse.7
|
||||||
MLINKS+=groff_ms.7 ms.7
|
MLINKS+=groff_ms.7 ms.7
|
||||||
MLINKS+=groff_mwww.7 mwww.7
|
|
||||||
MLINKS+=intro.7 miscellaneous.7
|
MLINKS+=intro.7 miscellaneous.7
|
||||||
|
|
||||||
.include "bsd.prog.mk"
|
.include "bsd.prog.mk"
|
||||||
|
|
|
||||||
File diff suppressed because it is too large
Load diff
|
|
@ -1,308 +0,0 @@
|
||||||
.\" $FreeBSD$
|
|
||||||
.TH GROFF_MWWW 7 "6 August 2001" "Groff Version 1.17.2"
|
|
||||||
.\" Copyright (C) 2000, 2001 Free Software Foundation, Inc.
|
|
||||||
.\" Written by Gaius Mulley (gaius@glam.ac.uk)
|
|
||||||
.\"
|
|
||||||
.\" This file is part of groff.
|
|
||||||
.\"
|
|
||||||
.\" groff is free software; you can redistribute it and/or modify it under
|
|
||||||
.\" the terms of the GNU General Public License as published by the Free
|
|
||||||
.\" Software Foundation; either version 2, or (at your option) any later
|
|
||||||
.\" version.
|
|
||||||
.\"
|
|
||||||
.\" groff is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
||||||
.\" WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
||||||
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
||||||
.\" for more details.
|
|
||||||
.\"
|
|
||||||
.\" You should have received a copy of the GNU General Public License along
|
|
||||||
.\" with groff; see the file COPYING. If not, write to the Free Software
|
|
||||||
.\" Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
||||||
.\"
|
|
||||||
.\" user level guide to using the -mwww macroset
|
|
||||||
.\"
|
|
||||||
.do mso www.tmac
|
|
||||||
.\" we need the .LINKS here as we use it in the middle as an example
|
|
||||||
.\" once the user requests .LINKS then the automatic generation of links
|
|
||||||
.\" at the top of the document is suppresed.
|
|
||||||
.LINKS
|
|
||||||
.SH 名称
|
|
||||||
groff_mwww \- ウェブページのオーサリング用 groff マクロ
|
|
||||||
.LINE
|
|
||||||
.SH 書式
|
|
||||||
.B "groff \-mwww"
|
|
||||||
[ options ]
|
|
||||||
file ...
|
|
||||||
.SH 解説
|
|
||||||
このマニュアルページは、GNU \-mwww マクロについて解説しています。
|
|
||||||
これは、groff ドキュメント整形システムの一部です。
|
|
||||||
このマニュアルページは、ごく基本的なガイドに過ぎませんし、
|
|
||||||
html デバイスドライバ
|
|
||||||
.RB (grohtml)
|
|
||||||
はいまだにアルファ版という段階です。
|
|
||||||
多くの人達がテストする機会を持てるようにするため、
|
|
||||||
このマクロを配布物に含めているのです。
|
|
||||||
このマクロファイルは、\fC-Thtml\fP を使用すれば
|
|
||||||
(\fCtroffrc\fP ファイルによって) 自動的に呼ばれるのだということに
|
|
||||||
注意してください。
|
|
||||||
.PP
|
|
||||||
ハイパーリンクが動作することを確認するには、このマニュアルページを
|
|
||||||
.B grohtml
|
|
||||||
デバイスを用いて整形してください。
|
|
||||||
.PP
|
|
||||||
これは、このマクロセットで見つかる機能の概要です。
|
|
||||||
.SH 書式
|
|
||||||
.ta 2iL
|
|
||||||
\&.HTMLINDEX セクション / ヘッダ用に自動的に
|
|
||||||
.br
|
|
||||||
作成されるリンクのレベルを決定します。
|
|
||||||
.br
|
|
||||||
\&.BODYCOLOR ウェブページの色を指定します。
|
|
||||||
.br
|
|
||||||
\&.BACKGROUND 背景画像を指定します。
|
|
||||||
.br
|
|
||||||
\&.URL 2 つのパラメータを用いて URL を作成します。
|
|
||||||
.br
|
|
||||||
\&.MAILTO HTML 用電子メールアドレスを作成します。
|
|
||||||
.br
|
|
||||||
\&.FTP FTP への参照を作成します。
|
|
||||||
.br
|
|
||||||
\&.IMAGE 画像ファイルを挿入します。
|
|
||||||
.br
|
|
||||||
\&.HTML デバイスドライバに生の HTML
|
|
||||||
.br
|
|
||||||
リクエストを渡します。
|
|
||||||
.br
|
|
||||||
\&.TAG $1 から HTML の name タグを生成します。
|
|
||||||
.br
|
|
||||||
.\"\&.CDFTP optionally create two different links
|
|
||||||
.\".br
|
|
||||||
.\" depending on hostname
|
|
||||||
.\".br
|
|
||||||
\&.LINE 水平方向の罫線を幅いっぱいに作成します。
|
|
||||||
.br
|
|
||||||
.PP
|
|
||||||
.IR pic ,
|
|
||||||
.IR eqn ,
|
|
||||||
.IR refer
|
|
||||||
および
|
|
||||||
.I tbl
|
|
||||||
プリプロセッサの出力を入力として受け付けることができます。
|
|
||||||
.SH リクエスト
|
|
||||||
.TP
|
|
||||||
.B HTMLINDEX
|
|
||||||
見出しに対して自動的に作成されるリンクの
|
|
||||||
切り捨てレベルを決定します。
|
|
||||||
デフォルトでは、troff ドキュメント中にある
|
|
||||||
すべての見出しへのリンクが HTML ウェブページの先頭に作成されます。
|
|
||||||
おそらく、細かいレベルの見出しにはリンクは必要ないことが
|
|
||||||
多いでしょう。またウェブページによっては、見出しへのリンクは一切
|
|
||||||
必要ないものもあるかもしれません。このような場合、
|
|
||||||
.sp
|
|
||||||
.nf
|
|
||||||
\fC\&.HTMLINDEX 0\fP
|
|
||||||
.fi
|
|
||||||
.sp
|
|
||||||
とすると、
|
|
||||||
.B grohtml
|
|
||||||
がリンクを生成しないようになります。
|
|
||||||
\fCHTMLINDEX\fP を 2 にすると
|
|
||||||
.sp
|
|
||||||
.B "1.1.1 Some Title"
|
|
||||||
.sp
|
|
||||||
という見出しも、3 レベル目の見出しがあるということにより、
|
|
||||||
リンクに含まれないようになります。
|
|
||||||
自動的な見出しを切り替える別の方法は、
|
|
||||||
コマンドラインスイッチ \fC-P-l\fP です。
|
|
||||||
.TP
|
|
||||||
.B BODYCOLOR
|
|
||||||
5 つパラメータを取ります: 文字色、背景色、アクティブな
|
|
||||||
ハイパーリンクの色、まだ訪問したことがない
|
|
||||||
ハイパーリンクの色、そして訪問したことのある
|
|
||||||
ハイパーリンクの色です。
|
|
||||||
.TP
|
|
||||||
.B BACKGROUND
|
|
||||||
このマクロの唯一のパラメータは、背景画像ファイルを示します。
|
|
||||||
.TP
|
|
||||||
.B URL
|
|
||||||
2 つあるいは 3 つのパラメータを使用して
|
|
||||||
.TAG URL
|
|
||||||
URL を生成します。
|
|
||||||
$1 はリンク名、$2 は実際の URL、そして $3 は $2 の直後に
|
|
||||||
印字されるオプション部分です。
|
|
||||||
実際の URL を印字する間、ハイフネーションは無効化されます。
|
|
||||||
明示的な改行位置は、
|
|
||||||
.B \e:
|
|
||||||
で挿入すべきです。
|
|
||||||
これは、
|
|
||||||
.URL "groff のホームページ" http://\:groff.\:ffii.\:org/ :
|
|
||||||
のエンコードの方法を示したものです。
|
|
||||||
.sp
|
|
||||||
.nf
|
|
||||||
\s-2\fC\&.URL "groff のホームページ" http://\e:groff.\e:ffii.\e:org/ :\fP\s+2
|
|
||||||
.fi
|
|
||||||
.sp
|
|
||||||
\fC-Thtml\fP 以外のデバイスでこれを処理すると、
|
|
||||||
次のように表示されます:
|
|
||||||
groff のホームページ \(lahttp://groff.\:ffii.\:org\(ra。
|
|
||||||
URL マクロは、どんな種類の要素でも使えます。例えば、
|
|
||||||
.URL "Eric Raymond の pic ガイド" pic.html
|
|
||||||
という参照を次のようにして作ることができます:
|
|
||||||
.sp
|
|
||||||
.nf
|
|
||||||
\s-2\fC\&.URL "Eric Raymond の pic ガイド" pic.html\fP\s+2
|
|
||||||
.fi
|
|
||||||
.sp
|
|
||||||
.TP
|
|
||||||
.B MAILTO
|
|
||||||
HTML 用の電子メール参照を生成します。
|
|
||||||
第 1 引数は、電子メールアドレスとして必須のものです。
|
|
||||||
第 2 引数はオプションであり、ブラウザに表示されるテキストです。
|
|
||||||
そして、第 3 引数もオプションであり、これは第 2 引数の直後に
|
|
||||||
表示されるものです。
|
|
||||||
実際の電子メールアドレスを印字する間、ハイフネーションは無効化されます。
|
|
||||||
例えば、groff メンテナは
|
|
||||||
.MAILTO wl@gnu.org "Werner Lemberg"
|
|
||||||
と
|
|
||||||
.MAILTO Ted.Harding@nessie.mcc.ac.uk "Ted Harding"
|
|
||||||
です。
|
|
||||||
これは、次のマクロで実現します:
|
|
||||||
.sp
|
|
||||||
.nf
|
|
||||||
\s-2\fC\&.MAILTO wl@gnu.org "Werner Lemberg"
|
|
||||||
\&.MAILTO Ted.Harding@nessie.mcc.ac.uk "Ted Harding" .\s+2\fP
|
|
||||||
.fi
|
|
||||||
.sp
|
|
||||||
実際には、groff では URL はテキストとしての空白を
|
|
||||||
一切使わないものとして扱われることに注意してください。
|
|
||||||
このことは、いくつかの問題の原因となりますのでバグだと
|
|
||||||
考えられるでしょう。
|
|
||||||
これを回避するために、\fCwww.tmac\fP は他に影響を
|
|
||||||
与えない空白に展開される幅 0 の文字を挿入します
|
|
||||||
(-Thtml 付で実行された場合のみ)。
|
|
||||||
.TP
|
|
||||||
.B FTP
|
|
||||||
データが FTP 経由で取得できることを示します。
|
|
||||||
第 1 引数は、ブラウザに表示されるテキストであり、
|
|
||||||
第 2 引数は URL です。
|
|
||||||
第 3 引数は、先に述べたマクロと同様に、第 2 引数の
|
|
||||||
直後に表示されるテキストとして扱われます。
|
|
||||||
第 2 および第 3 の引数はオプションです。
|
|
||||||
実際の URL を印字する間、ハイフネーションは無効化されます。
|
|
||||||
例として、これは、
|
|
||||||
.FTP "現在の groff 開発者用配布物" \
|
|
||||||
ftp://ftp.ffii.org/\:pub/\:groff/\:devel/\:groff-current.tar.gz
|
|
||||||
の場所です。
|
|
||||||
このマクロの例は、次のように指定します:
|
|
||||||
.sp
|
|
||||||
.nf
|
|
||||||
\s-2\fC\&.FTP "現在の groff 開発者用配布物" \\
|
|
||||||
ftp://ftp.ffii.org/\e:pub/\e:groff/\e:devel/\e:groff-current.tar.gz \fP\s+2
|
|
||||||
.fi
|
|
||||||
.sp
|
|
||||||
.TP
|
|
||||||
.B IMAGE
|
|
||||||
ドキュメントに画像を含めることができます。
|
|
||||||
第 1 引数は画像ファイルです。
|
|
||||||
第 2 のオプションは、水平位置を指定します。
|
|
||||||
.B l
|
|
||||||
は画像を左寄せに、
|
|
||||||
.B r
|
|
||||||
は画像を右寄せにします。その他の値は画像を中央に置きます。
|
|
||||||
次の 2 つの引数はオプションです。
|
|
||||||
第 3 引数は画素数での画像の幅です (指定がなければ、デフォルトは
|
|
||||||
400 画素です)。
|
|
||||||
第 4 引数は画素数での画像の高さです (指定がなければ、デフォルトは
|
|
||||||
画像幅と同じです)。
|
|
||||||
.sp
|
|
||||||
.TP
|
|
||||||
.B HTML
|
|
||||||
このマクロの後に続いたテキストはすべて生の HTML として
|
|
||||||
扱われます。
|
|
||||||
ドキュメントが \fC-Thtml\fP を \fI使わずに\fP
|
|
||||||
処理される場合、このマクロは無視されます。
|
|
||||||
このマクロは、より高水準な他のマクロの構成要素です。
|
|
||||||
.sp
|
|
||||||
例えば、\fCBACKGROUND\fP マクロは次のように定義されます:
|
|
||||||
.nf
|
|
||||||
\fC\&.de BACKGROUND
|
|
||||||
\&. HTML <body background=\\$1>
|
|
||||||
\&..
|
|
||||||
\fP
|
|
||||||
.fi
|
|
||||||
.TP
|
|
||||||
.B TAG
|
|
||||||
引数から HTML の name タグを生成します。
|
|
||||||
このタグは、
|
|
||||||
.URL URL #URL
|
|
||||||
マクロを使って参照できます。
|
|
||||||
御覧の通り、同一ドキュメント内の参照ですので、タグ名の前には
|
|
||||||
`\fC#\fP' を付けなくてはなりません。
|
|
||||||
このリンクは、先の URL マクロの記述の中で TAG を置くことで
|
|
||||||
実現したのです。ソースは次のようになります:
|
|
||||||
.sp
|
|
||||||
.nf
|
|
||||||
\s-2\fC\&.TP
|
|
||||||
\&.B URL
|
|
||||||
は、
|
|
||||||
\&.TAG URL
|
|
||||||
を生成します。
|
|
||||||
URL は 2 個あるいは 3 個の
|
|
||||||
引数を使います。
|
|
||||||
$1 がリンクの名前、そして $2 が実際の URL です。\fP\s+2
|
|
||||||
.fi
|
|
||||||
.sp
|
|
||||||
.TP
|
|
||||||
.B LINE
|
|
||||||
水平方向に幅いっぱいの罫線を生成します。
|
|
||||||
次が例です:
|
|
||||||
.sp
|
|
||||||
.nf
|
|
||||||
\fC\s-2\&.LINE\fP\s+2
|
|
||||||
.fi
|
|
||||||
.sp
|
|
||||||
.TP
|
|
||||||
.B LINKS
|
|
||||||
.TAG LINK
|
|
||||||
は、grohtml が自動的に生成されるリンクをこの位置へ置くよう要求します。
|
|
||||||
例:
|
|
||||||
.LINKS
|
|
||||||
.SH
|
|
||||||
セクション見出しへのリンク
|
|
||||||
.LP
|
|
||||||
デフォルトでは、
|
|
||||||
.B grohtml
|
|
||||||
はセクションの見出しすべてへのリンクを生成し、
|
|
||||||
リンクを
|
|
||||||
HTML ドキュメントの先頭に配置します。
|
|
||||||
オフにしたり位置を変えるための詳細は
|
|
||||||
.URL LINKS #LINK
|
|
||||||
を参照してください。
|
|
||||||
.SH
|
|
||||||
grohtml の制限
|
|
||||||
.LP
|
|
||||||
tbl 情報は、現状 png イメージで描かれます。
|
|
||||||
.SH 関連ファイル
|
|
||||||
/usr/share/tmac/mwww.tmac (www.tmac へのラッパ)
|
|
||||||
.br
|
|
||||||
/usr/share/tmac/www.tmac
|
|
||||||
.SH "関連項目"
|
|
||||||
.BR groff (1),
|
|
||||||
.BR troff (1),
|
|
||||||
.BR grohtml (1)
|
|
||||||
.LP
|
|
||||||
.SH 作者
|
|
||||||
.B grohtml
|
|
||||||
は
|
|
||||||
.MAILTO gaius@glam.ac.uk "Gaius Mulley"
|
|
||||||
が書きました。
|
|
||||||
.SH バグ
|
|
||||||
バグレポートは
|
|
||||||
.MAILTO bug-groff@gnu.org "Groff Bug Mailing List"
|
|
||||||
へ送ってください。
|
|
||||||
バグが再現できるように、完全で自己完結している例を付けてください。
|
|
||||||
また、どのバージョンの groff を使っているかも伝えてください。
|
|
||||||
.
|
|
||||||
.\" Local Variables:
|
|
||||||
.\" mode: nroff
|
|
||||||
.\" End:
|
|
||||||
421
ja_JP.eucJP/man/man7/groff_www.7
Normal file
421
ja_JP.eucJP/man/man7/groff_www.7
Normal file
|
|
@ -0,0 +1,421 @@
|
||||||
|
.\" $FreeBSD$
|
||||||
|
.TH GROFF_WWW 7 "11 October 2002" "Groff Version 1.19"
|
||||||
|
.\" Copyright (C) 2000, 2001, 2002 Free Software Foundation, Inc.
|
||||||
|
.\" Written by Gaius Mulley (gaius@glam.ac.uk)
|
||||||
|
.\"
|
||||||
|
.\" This file is part of groff.
|
||||||
|
.\"
|
||||||
|
.\" groff is free software; you can redistribute it and/or modify it under
|
||||||
|
.\" the terms of the GNU General Public License as published by the Free
|
||||||
|
.\" Software Foundation; either version 2, or (at your option) any later
|
||||||
|
.\" version.
|
||||||
|
.\"
|
||||||
|
.\" groff is distributed in the hope that it will be useful, but WITHOUT ANY
|
||||||
|
.\" WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
||||||
|
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
||||||
|
.\" for more details.
|
||||||
|
.\"
|
||||||
|
.\" You should have received a copy of the GNU General Public License along
|
||||||
|
.\" with groff; see the file COPYING. If not, write to the Free Software
|
||||||
|
.\" Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
||||||
|
.\"
|
||||||
|
.\" user level guide to using the -mwww macroset
|
||||||
|
.\"
|
||||||
|
.
|
||||||
|
.do mso www.tmac
|
||||||
|
.
|
||||||
|
.\" we need the .LK here as we use it in the middle as an example --
|
||||||
|
.\" once the user requests .LK then the automatic generation of links
|
||||||
|
.\" at the top of the document is suppressed.
|
||||||
|
.LK
|
||||||
|
.
|
||||||
|
.
|
||||||
|
.SH 名称
|
||||||
|
groff_www \- ウェブページのオーサリング用 groff マクロ
|
||||||
|
.HR
|
||||||
|
.SH 書式
|
||||||
|
.B "groff \-mwww"
|
||||||
|
[ options ]
|
||||||
|
file ...
|
||||||
|
.
|
||||||
|
.
|
||||||
|
.SH 解説
|
||||||
|
このマニュアルページは、GNU \-mwww マクロについて解説しています。
|
||||||
|
これは、groff ドキュメント整形システムの一部です。
|
||||||
|
このマニュアルページは、ごく基本的なガイドに過ぎませんし、
|
||||||
|
html デバイスドライバ
|
||||||
|
.RB (grohtml)
|
||||||
|
は完全に書き直されましたがいまだにアルファ版という段階です。
|
||||||
|
多くの人達がテストする機会を持てるようにするため、
|
||||||
|
このマクロを配布物に含めているのです。
|
||||||
|
このマクロファイルは、\fC-Thtml\fP を使用すれば
|
||||||
|
(\fCtroffrc\fP ファイルによって) 自動的に呼ばれるのだということに
|
||||||
|
注意してください。
|
||||||
|
.PP
|
||||||
|
ハイパーリンクが動作することを確認するには、このマニュアルページを
|
||||||
|
.B grohtml
|
||||||
|
デバイスを用いて整形してください。
|
||||||
|
.PP
|
||||||
|
このマクロセットで見つかる機能の概要です。
|
||||||
|
.ta 2iL
|
||||||
|
.nf
|
||||||
|
\&.HX 自動的なヘッダレベルの切り捨て。
|
||||||
|
$1 がセクション/ヘッダを指します。
|
||||||
|
\&.BCL ウェブページの色を指定します。
|
||||||
|
\&.BGIMG 背景画像を指定します。
|
||||||
|
\&.URL 2 つのパラメータを用いて URL を作成します。
|
||||||
|
\&.FTP FTP への参照を作成します。
|
||||||
|
\&.MTO HTML email アドレスを作成します。
|
||||||
|
\&.FTP FTP への参照を作成します。
|
||||||
|
\&.TAG HTML の name を作成します。
|
||||||
|
\&.IMG 画像ファイルを挿入します。
|
||||||
|
\&.PIMG PNG 画像を挿入します。
|
||||||
|
\&.MPIMG PNG を余白に置き、その周辺をテキストで包みます。
|
||||||
|
\&.HnS 見出しを開始します。
|
||||||
|
\&.HnE 見出しを終了します。
|
||||||
|
\&.LK 自動的に収集されたリンクを出力します。
|
||||||
|
\&.HR 水平罫線を出力します。
|
||||||
|
\&.NHR 罫線の自動生成を抑制します。
|
||||||
|
\&.HTL HTML タイトルのみを作成します。
|
||||||
|
\&.ULS 順序無しリストを開始します。
|
||||||
|
\&.ULE 順序無しリストを終了します。
|
||||||
|
\&.LI リスト項目を挿入します。
|
||||||
|
\&.DC ドロップキャピタルを作成します。
|
||||||
|
\&.HTML HTML の生リクエストをデバイスドライバに渡します。
|
||||||
|
.fi
|
||||||
|
.PP
|
||||||
|
Output of the
|
||||||
|
.BR pic ,
|
||||||
|
.BR eqn ,
|
||||||
|
.BR refer ,
|
||||||
|
.B tbl
|
||||||
|
プリプロセッサの出力を入力として受け付けることができます。
|
||||||
|
.
|
||||||
|
.
|
||||||
|
.SH リクエスト
|
||||||
|
.TP
|
||||||
|
.B HX
|
||||||
|
見出しに対して自動的に作成されるリンクの
|
||||||
|
切り捨てレベルを決定します。
|
||||||
|
パラメータに 2 を指定すると、
|
||||||
|
.B grohtml
|
||||||
|
は
|
||||||
|
.B .NH\ 1
|
||||||
|
と
|
||||||
|
.B .NH\ 2
|
||||||
|
にはリンクのリストを作成しますが、
|
||||||
|
.BR .NH\ 3
|
||||||
|
に対してはしません。
|
||||||
|
.RS
|
||||||
|
.IP
|
||||||
|
.nf
|
||||||
|
.B .HX 0
|
||||||
|
.fi
|
||||||
|
.RE
|
||||||
|
.IP
|
||||||
|
とすると、
|
||||||
|
.B grohtml
|
||||||
|
がリンクを生成しないようになります。
|
||||||
|
自動的な見出しをオフにする別の方法は、
|
||||||
|
.BR groff
|
||||||
|
のコマンドラインスイッチ \fC-P-l\fP です。
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B BCL
|
||||||
|
5 つパラメータを取ります: 文字色、背景色、アクティブな
|
||||||
|
ハイパーリンクの色、まだ訪問したことがない
|
||||||
|
ハイパーリンクの色、そして訪問したことのある
|
||||||
|
ハイパーリンクの色です。
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B BGIMG
|
||||||
|
このマクロの唯一のパラメータは、背景画像ファイルを示します。
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B URL
|
||||||
|
2 つあるいは 3 つのパラメータを使用して
|
||||||
|
.TAG URL
|
||||||
|
URL を生成します。
|
||||||
|
第 1 パラメータはリンク名、第 2 パラメータは実際の URL、
|
||||||
|
そして第 3 パラメータは省略可能であり直後に印字されます。
|
||||||
|
実際の URL を印字中はハイフネーションは無効化されます。
|
||||||
|
明示的な改行位置を
|
||||||
|
.B \[rs]:
|
||||||
|
エスケープで挿入すべきです。
|
||||||
|
以下に
|
||||||
|
.URL http://\:foo.\:org/ "foo" :
|
||||||
|
をどのようにエンコードすべきかを示します:
|
||||||
|
.RS
|
||||||
|
.IP
|
||||||
|
.B .URL http://\[rs]:foo.\[rs]:org/ "foo" :
|
||||||
|
.RE
|
||||||
|
.IP
|
||||||
|
これを
|
||||||
|
.B \-Thtml
|
||||||
|
以外のドライバで処理すると、次のようになります:
|
||||||
|
.RS
|
||||||
|
.IP
|
||||||
|
\m[blue]foo\m[] \[la]\f[C]http://foo.org\f[]\[ra]:
|
||||||
|
.RE
|
||||||
|
.IP
|
||||||
|
URL マクロはどんなタイプでも構いません。
|
||||||
|
例えば
|
||||||
|
.URL pic.html "Eric Raymond's pic guide"
|
||||||
|
は次のように参照できます:
|
||||||
|
.RS
|
||||||
|
.IP
|
||||||
|
.B .URL pic.html \[dq]Eric Raymond's pic guide\[dq]
|
||||||
|
.RE
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B MTO
|
||||||
|
HTML 用の電子メール参照を生成します。
|
||||||
|
第 2 引数はオプションであり、ブラウザに表示されるテキストです。
|
||||||
|
そして、第 3 引数もオプションであり、これは第 2 引数の直後に
|
||||||
|
表示されるものです。
|
||||||
|
実際の電子メールアドレスを印字する間、ハイフネーションは無効化されます。
|
||||||
|
例えば
|
||||||
|
.MTO joe@user.org "Joe User"
|
||||||
|
は次のように実現されます:
|
||||||
|
.RS
|
||||||
|
.IP
|
||||||
|
.B .MTO joe@user.org \[dq]Joe User\[dq]
|
||||||
|
.RE
|
||||||
|
.IP
|
||||||
|
実際には、groff では URL はテキストとしての空白を
|
||||||
|
一切使わないものとして扱われることに注意してください。
|
||||||
|
このことは、いくつかの問題の原因となりますのでバグだと
|
||||||
|
考えられるでしょう。
|
||||||
|
これを回避するために、
|
||||||
|
.B www.tmac
|
||||||
|
は他に影響を
|
||||||
|
与えない空白に展開される幅 0 の文字を挿入します
|
||||||
|
.RB ( \-Thtml
|
||||||
|
付きで実行された場合のみ)。
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B FTP
|
||||||
|
データが FTP 経由で取得できることを示します。
|
||||||
|
第 1 引数は URL で、
|
||||||
|
第 2 引数は、ブラウザに表示されるテキストです。
|
||||||
|
第 3 引数は、先に述べたマクロと同様に、第 2 引数の
|
||||||
|
直後に表示されるテキストとして扱われます。
|
||||||
|
第 2 および第 3 の引数はオプションです。
|
||||||
|
実際の URL を印字する間、ハイフネーションは無効化されます。
|
||||||
|
例として、これは、
|
||||||
|
例として、これは、
|
||||||
|
.FTP ftp://\:ftp.gnu.org/ "GNU ftp server"
|
||||||
|
です。
|
||||||
|
このマクロの例は、次のように指定します:
|
||||||
|
.RS
|
||||||
|
.IP
|
||||||
|
.B .FTP ftp://\[rs]:ftp.gnu.org/ \[dq]GNU ftp server\[dq] .
|
||||||
|
.RE
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B TAG
|
||||||
|
引数から HTML の name タグを生成します。
|
||||||
|
このタグは、
|
||||||
|
.URL #URL URL
|
||||||
|
マクロを使って参照できます。
|
||||||
|
御覧の通り、同一ドキュメント内の参照ですので、タグ名の前には
|
||||||
|
.B #
|
||||||
|
を付けなくてはなりません。
|
||||||
|
このリンクは、先の URL マクロの記述の中で TAG を置くことで
|
||||||
|
実現したのです。ソースは次のようになります:
|
||||||
|
.RS
|
||||||
|
.IP
|
||||||
|
.nf
|
||||||
|
.ft B
|
||||||
|
\&.TP
|
||||||
|
\&.B URL
|
||||||
|
は、
|
||||||
|
\&.TAG URL
|
||||||
|
すなわち 2 個か 3 個の引数を使用する URL を作成します。
|
||||||
|
\&.\|.\|.
|
||||||
|
.fi
|
||||||
|
.ft P
|
||||||
|
.RE
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B IMG
|
||||||
|
ドキュメントに画像を含めます。
|
||||||
|
第 2 のオプションは、水平位置、すなわち右・左・中央を指定します
|
||||||
|
.RB ( \-R ,
|
||||||
|
.BR \-L ,
|
||||||
|
.BR \-C )
|
||||||
|
。
|
||||||
|
第 2 引数は画像ファイルです。
|
||||||
|
オプションの第 3 引数と第 4 引数は、幅と高さです。
|
||||||
|
幅を指定しないと、デフォルトの 1 インチになります。
|
||||||
|
高さを指定しないと、幅と同じになります。
|
||||||
|
これは、HTML の IMG タグにマップされます。
|
||||||
|
PNG 画像を挿入する場合、
|
||||||
|
.B PIMG
|
||||||
|
マクロを使用することをお勧めします。
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B PIMG
|
||||||
|
PNG フォーマットの画像を含めます。
|
||||||
|
このマクロは
|
||||||
|
.B IMG
|
||||||
|
マクロとまったく同じパラメータを取ります。
|
||||||
|
PostScript と HTML デバイスと連携動作するという利点があります。
|
||||||
|
また、
|
||||||
|
.B netpbm
|
||||||
|
パッケージの
|
||||||
|
.BR pngtopnm ,
|
||||||
|
.BR pnmcrop ,
|
||||||
|
.BR pnmtops
|
||||||
|
を使用して、自動的に画像を EPS フォーマットに変換するという利点があります。
|
||||||
|
ドキュメントを
|
||||||
|
.B \-Thtml
|
||||||
|
で処理しない場合、groff の
|
||||||
|
.B \-U
|
||||||
|
オプションが必要です。
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B MPIMG
|
||||||
|
PNG 画像を余白に置き、その周辺をテキストで包みます。
|
||||||
|
第 1 パラメータは、左か右の整列位置
|
||||||
|
.RB ( \-L
|
||||||
|
mataha
|
||||||
|
.BR \-R )
|
||||||
|
です。
|
||||||
|
第 2 引数がファイル名です。
|
||||||
|
オプションの第 3 引数と第 4 引数は、幅と高さです。
|
||||||
|
幅を指定しないと、デフォルトの 1 インチになります。
|
||||||
|
高さを指定しないと、幅と同じになります。
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B HnS
|
||||||
|
見出しを開始します。
|
||||||
|
見出しレベルは、第 1 引数で指定します。
|
||||||
|
URL を含む見出しにはこのマクロを使用してください。
|
||||||
|
例:
|
||||||
|
.RS
|
||||||
|
.IP
|
||||||
|
.nf
|
||||||
|
.ft B
|
||||||
|
\&.HnS 1
|
||||||
|
\&.HR
|
||||||
|
GNU Troff
|
||||||
|
\&.URL http://groff.ffii.org (Groff)
|
||||||
|
\&\(em a
|
||||||
|
\&.URL http://www.gnu.org/ GNU
|
||||||
|
\&project.
|
||||||
|
\&Hosted by
|
||||||
|
\&.URL http://ffii.org/ FFII .
|
||||||
|
\&.HR
|
||||||
|
\&.HnE
|
||||||
|
.ft P
|
||||||
|
.fi
|
||||||
|
.RE
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B HnE
|
||||||
|
見出しを終了します。
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B LK
|
||||||
|
.TAG LK
|
||||||
|
この位置に自動生成リンクを置くよう、grohtml に強制します。
|
||||||
|
マニュアルページを
|
||||||
|
.B \-Thtml
|
||||||
|
で処理した場合、リンクはここに見えます。
|
||||||
|
.
|
||||||
|
.LK
|
||||||
|
.
|
||||||
|
.
|
||||||
|
.SH セクション見出しへのリンク
|
||||||
|
デフォルトでは
|
||||||
|
.B grohtml
|
||||||
|
はセクションの見出しすべてへのリンクを生成し、
|
||||||
|
リンクを
|
||||||
|
HTML ドキュメントの先頭に配置します
|
||||||
|
(オフにしたり位置を変えるための詳細は
|
||||||
|
.URL #LK LINKS
|
||||||
|
を参照してください)。
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B HR
|
||||||
|
水平方向の罫線を幅いっぱいに作成します。
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B NHR
|
||||||
|
grohtml がデフォルトで生成する、トップとボトムの罫線の生成を抑制します。
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B HTL
|
||||||
|
HTML タイトルのみを生成します。
|
||||||
|
.B ms
|
||||||
|
マクロパッケージの
|
||||||
|
.B TL
|
||||||
|
マクロは、HTML タイトルと H1 見出しの両方を生成します。
|
||||||
|
これを使って、サーチエンジン用の食材としてて HTML タイトルを提供し、
|
||||||
|
ドキュメント中では画像のタイトルを使用できます。
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B HTML
|
||||||
|
このマクロより後の全テキストは生の HTML として扱われます。
|
||||||
|
.B \-Thtml
|
||||||
|
無しでドキュメントを処理すると、このマクロは無視されます。
|
||||||
|
内部的に、他の高位のマクロの構成要素としてこのマクロが使用されています。
|
||||||
|
.IP
|
||||||
|
例えば
|
||||||
|
.B BGIMG
|
||||||
|
マクロは次のように定義されています。
|
||||||
|
.RS
|
||||||
|
.IP
|
||||||
|
.nf
|
||||||
|
.ft B
|
||||||
|
\&.de BGIMG
|
||||||
|
\&. HTML <body background=\[rs]$1>
|
||||||
|
\&..
|
||||||
|
.ft P
|
||||||
|
.fi
|
||||||
|
.RE
|
||||||
|
.
|
||||||
|
.TP
|
||||||
|
.B DC
|
||||||
|
ドロップキャピタルを生成します。
|
||||||
|
第 1 パラメータが、ドロップされる文字であり大きくなります。
|
||||||
|
第 2 パラメータが、これに続くテキストであり、
|
||||||
|
この高さを最初の文字は越えてはなりません。
|
||||||
|
オプションの 第 3 パラメータは、ドロップされた文字の色です。
|
||||||
|
.
|
||||||
|
.
|
||||||
|
.SH GROHTML の制限
|
||||||
|
.LP
|
||||||
|
.B tbl
|
||||||
|
情報は、現在 PNG 画像として描かれます。
|
||||||
|
.
|
||||||
|
.
|
||||||
|
.SH 関連ファイル
|
||||||
|
/usr/share/tmac/www.tmac
|
||||||
|
.
|
||||||
|
.
|
||||||
|
.SH "関連項目"
|
||||||
|
.BR groff (1),
|
||||||
|
.BR troff (1)
|
||||||
|
.BR grohtml (1),
|
||||||
|
.BR netpbm (1)
|
||||||
|
.
|
||||||
|
.
|
||||||
|
.SH 作者
|
||||||
|
.B grohtml
|
||||||
|
は
|
||||||
|
.MTO gaius@glam.ac.uk "Gaius Mulley"
|
||||||
|
が書きました。
|
||||||
|
.
|
||||||
|
.
|
||||||
|
.SH バグ
|
||||||
|
バグレポートは
|
||||||
|
.MTO bug-groff@\:gnu.org "Groff Bug Mailing List"
|
||||||
|
へ送ってください。
|
||||||
|
バグが再現できるように、完全で自己完結している例を付けてください。
|
||||||
|
また、どのバージョンの groff を使っているかも伝えてください。
|
||||||
|
.
|
||||||
|
.\" Local Variables:
|
||||||
|
.\" mode: nroff
|
||||||
|
.\" End:
|
||||||
Loading…
Reference in a new issue