mirror of
https://git.FreeBSD.org/src.git
synced 2024-12-20 11:11:24 +00:00
179 lines
4.6 KiB
Plaintext
179 lines
4.6 KiB
Plaintext
.\"
|
|
.\" a simple set of macros to provide HTML documents with basic www functionality
|
|
.\"
|
|
.\" please can someone with more skill at creating macros improve on this
|
|
.\" many thanks - Gaius
|
|
.\"
|
|
.\" suggestion: maybe when run with non -Thtml all the urls should appear as
|
|
.\" references.
|
|
.\"
|
|
.\" some simple html additions to any macro set
|
|
.\"
|
|
.de HTML
|
|
.if '\*(.T'html' \X^html:\\$*^
|
|
..
|
|
.de HTMLINDEX
|
|
.if '\*(.T'html' \X^index:\\$*^
|
|
..
|
|
.\"
|
|
.\" BODYCOLOR - $1 is foreground color
|
|
.\" $2 is background color
|
|
.\" $3 is the color of an active hypertext link
|
|
.\" $4 is the color of a hypertext link not yet visited
|
|
.\" $5 is the color of a visited hypertext link
|
|
.\"
|
|
.de BODYCOLOR
|
|
. HTML <body text=\\$1 bgcolor=\\$2 link=\\$3 alink=\\$4 vlink=\\$5>
|
|
..
|
|
.\"
|
|
.\" BACKGROUND - $1 is the background image file
|
|
.\"
|
|
.de BACKGROUND
|
|
. HTML <body background=\\$1>
|
|
..
|
|
.\"
|
|
.\" URL - $1 is the classical underlined blue text
|
|
.\" $2 is the url
|
|
.\"
|
|
.de URL
|
|
. ie '\*(.T'html' \{\
|
|
. HTML <a href="\\$2">\\$1</a>
|
|
. \}
|
|
. el \{\
|
|
\\$1 (<url: \\$2>)
|
|
. \}
|
|
..
|
|
.\"
|
|
.\" LINK - $1 is the classical underlined blue text
|
|
.\" $2 is the URL *with* the textual reference within a document
|
|
.\"
|
|
.\" example: .LINK "a nice heading" "#heading123"
|
|
.\"
|
|
.\" provides a link from "a nice heading" to the
|
|
.\" textual name reference "heading123"
|
|
.\"
|
|
.\" .LINK "The GNU FSF" "" "www.gnu.org"
|
|
.\"
|
|
.\" deprecated - use the URL macro instead
|
|
.\"
|
|
.\"
|
|
.de LINK
|
|
. ie !'\\$3'' \{\
|
|
. @error the LINK macro has changed, use the URL (or FTP if appropriate) macro here
|
|
. @error you are advised to replace with URL or FTP macro "\\$1" "\\$3#\\$2"
|
|
. URL "\\$1" "\\$3#\\$2"
|
|
. \}
|
|
. el \{\
|
|
. ie '\*(.T'html' \{\
|
|
. HTML <a href=\\$2>\\$1</a>
|
|
. \}
|
|
. el \{\
|
|
. URL "\\$1" "\\$2"
|
|
. \}
|
|
. \}
|
|
..
|
|
.\"
|
|
.\" FTP - $1 is the classical underlined blue text
|
|
.\" $2 is the ftp url
|
|
.de FTP
|
|
. ie '\*(.T'html' \{\
|
|
. HTML <a href=\\$2>\\$1</a>
|
|
. \}
|
|
. el \{\
|
|
$1 (<ftp:\\$2>)
|
|
. \}
|
|
..
|
|
.\"
|
|
.\" MAILTO - generate html email reference
|
|
.\" $1 is the email address
|
|
.\" $2 is the optional name
|
|
.\"
|
|
.\" example .MAILTO fred@foo.bar "Fredrick Bloggs"
|
|
.\"
|
|
.de MAILTO
|
|
.\"
|
|
.\" force reset after a potential heading by performing some motion..
|
|
.\" how do we do this --fixme--
|
|
.\" \h'\w' ''\h'-\w' '' doesn't work..
|
|
. ie '\*(.T'html' \{\
|
|
. ie '\\$2'' \{\
|
|
. HTML "<a href=mailto:\\$1>\\$1</a>"
|
|
. \}
|
|
. el \{\
|
|
. HTML "<a href=mailto:\\$1>\\$2</a>"
|
|
. \}
|
|
. \}
|
|
. el \{\
|
|
\s-2\fB<email:\\$1>\fP\s+2
|
|
. \}
|
|
..
|
|
.\"
|
|
.\"
|
|
.\" TAG - generate an html name $1
|
|
.\"
|
|
.de TAG
|
|
.HTML <a name="\\$1"></a>
|
|
..
|
|
.\"
|
|
.\" IMAGE - reference an image
|
|
.\" $1 is the image file
|
|
.\" $2 is the x width (default if absent 400 pixels)
|
|
.\" $3 is the y width (default if absent is the x value)
|
|
.\"
|
|
.de IMAGE
|
|
. ie '\*(.T'html' \{\
|
|
. nr HTMLWIDTH 400
|
|
. if '\\$2'' \{\
|
|
. nr HTMLWIDTH \\$2
|
|
. \}
|
|
. nr HTMLHEIGHT \\n[HTMLWIDTH]
|
|
. if '\\$3'' \{\
|
|
. nr HTMLHEIGHT \\$3
|
|
. \}
|
|
. HTML <img src="\\$1" width=\\n[HTMLWIDTH height=\\n[HTMLHEIGHT]>
|
|
. \}
|
|
. el \{\
|
|
. B1
|
|
\fB\s-2<img src=\\$1>\fP\s+2
|
|
. B2
|
|
. \}
|
|
..
|
|
.\"
|
|
.\" CDFTP - if we are processing this on machine \\$1 then we create a
|
|
.\" FTP reference using \\$2 --> \\$3
|
|
.\"
|
|
.\" otherwise we create a URL from \\$2 --> \\$4
|
|
.\"
|
|
.\" example:
|
|
.\"
|
|
.\" .CDFTP "foobar" "somegnusoftware.tar.gz" \
|
|
.\" "ftp://ftp.gnu.org/gnu/somegnusoftware.tar.gz" \
|
|
.\" "../../../TARGZ/somegnusoftware.tar.gz"
|
|
.\"
|
|
.\" meaning if we are on machine foobar then generate an ftp url
|
|
.\" to the GNU anonymous ftp server otherwise generate a file url
|
|
.\" to a local copy (cdrom maybe)
|
|
.\"
|
|
.\" Useful when one machine is designated as a cdrom burner and another
|
|
.\" designated as an appache server.
|
|
.\" The same source for web pages can be burnt onto a CD and also
|
|
.\" served across the network. It doesn't solve the problem of one
|
|
.\" machine doing both though :-(
|
|
.\"
|
|
.\"
|
|
.de CDFTP
|
|
. sy /bin/rm -f /tmp/tmac.n
|
|
. sy /bin/echo ".ds HOSTNAME `hostname --short`" > /tmp/tmac.n
|
|
. so /tmp/tmac.n
|
|
. sy /bin/rm -f /tmp/tmac.n
|
|
. ie '\\*[HOSTNAME]'\\$1' \{\
|
|
. FTP "\\$2" "\\$3"
|
|
. \}
|
|
. el \{\
|
|
. URL "\\$2" "\\$4"
|
|
. \}
|
|
..
|
|
.\" it doesn't make sense to use hyphenation with html, so we turn it off.
|
|
.hy 0
|
|
.nr HY 0
|