.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds C`
. ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
. if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. if !\nF==2 \{\
. nr % 0
. nr F 2
. \}
. \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "REM2HTML 1"
.TH REM2HTML 1 2024-04-29 "perl v5.38.2" "VERSION 04.03.07"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
rem2html \- Convert the output of "remind \-pp" to HTML
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 1
\& remind \-pp ... | rem2html [options]
.Ve
.PP
You can also use the old interchange format as below, but the \-pp
version is preferred.
.PP
.Vb 1
\& remind \-p ... | rem2html [options]
.Ve
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\-\-help, \-h" 4
.IX Item "--help, -h"
Print usage information
.IP \-\-version 4
.IX Item "--version"
Print version
.IP \-\-utf8 4
.IX Item "--utf8"
Assume standard input is encoded in UTF\-8; write UTF\-8 data to standard
output.
.IP "\-\-backurl \fIurl\fR" 4
.IX Item "--backurl url"
When producing the small calendar for the previous month, make the
month name a link to \fIurl\fR.
.IP "\-\-forwurl \fIurl\fR" 4
.IX Item "--forwurl url"
When producing the small calendar for the next month, make the
month name a link to \fIurl\fR.
.IP "\-\-imgbase \fIurl\fR" 4
.IX Item "--imgbase url"
When creating URLs for the stylesheet or external images, use \fIurl\fR
as the base URL.
.IP \-\-pngs 4
.IX Item "--pngs"
Normally, rem2html uses inline "data:" URLs for the moon phase images,
yielding a standalone HTML file. The \f(CW\*(C`\-\-pngs\*(C'\fR option makes it use
external images named firstquarter.png, fullmoon.png, lastquarter.png
and newmoon.png, which are expected to live in \f(CW\*(C`\-\-imgbase\*(C'\fR.
.IP "\-\-stylesheet \fIurl.css\fR" 4
.IX Item "--stylesheet url.css"
Use \fIurl.css\fR as the stylesheet. If this option is used,
\&\fIurl.css\fR is interpreted relative to \fBimgbase\fR \fIunless\fR it starts
with a "/".
.IP \-\-nostyle 4
.IX Item "--nostyle"
Produce basic HTML that does not use a CSS stylesheet.
.IP \-\-tableonly 4
.IX Item "--tableonly"
Output results as a sequence only
without any or tags.
.IP "\-\-title \fItitle\fR" 4
.IX Item "--title title"
Use \fItitle\fR as the content between and
tags.
.IP "\-\-prologue \fIhtml_text\fR" 4
.IX Item "--prologue html_text"
Insert \fIhtml_text\fR right after the tag.
.IP "\-\-epilogue \fIhtml_text\fR" 4
.IX Item "--epilogue html_text"
Insert \fIhtml_text\fR right before the tag.
.SH "SPECIALS SUPPORTED"
.IX Header "SPECIALS SUPPORTED"
The rem2html back-end supports the following SPECIAL reminders:
.IP HTML 4
.IX Item "HTML"
Add an HTML reminder to the calendar. All HTML tags are available.
.IP HTMLCLASS 4
.IX Item "HTMLCLASS"
Add a CSS class to the box representing the trigger date. See
"HIGHLIGHTING TODAY" for an example
.IP "WEEK, MOON, SHARE, COLOR" 4
.IX Item "WEEK, MOON, SHARE, COLOR"
The standard SPECIALs supported by all back-ends
.SH "HIGHLIGHTING TODAY"
.IX Header "HIGHLIGHTING TODAY"
Older versions of rem2html used to highlight today's date with a red outline.
The current version does not do that by default. If you wish to highlight
today's date, add the following reminder to your reminders file:
.PP
.Vb 1
\& REM [realtoday()] SPECIAL HTMLCLASS rem\-today
.Ve
.SH AUTHOR
.IX Header "AUTHOR"
rem2html was written by Dianne Skoll with much inspiration from an
earlier version by Don Schwarz.
.SH "HOME PAGE"
.IX Header "HOME PAGE"
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBremind\fR, \fBrem2ps\fR, \fBrem2pdf\fR, \fBtkremind\fR