.TH "html2stx" "1" "" "Panu A. Kalliokoski"
.SH NAME
html2stx \- convert HTML documents into Stx
.SH SYNOPSIS
.PP
\fChtml2stx\fP [ \fIfile\fP ]
.SH DESCRIPTION
.PP
\fChtml2stx\fP takes the given \fIfile\fP, which should contain an HTML
document, and converts it to structured text (Stx).  If no file is
given, standard input is read instead.
.PP
The program does not attempt to convert every possibly convertible piece
of markup into Stx.  For example, <font> tags are simply
ignored.  This tends to result in a nice, clean, beautiful document.
(If it doesn't, the source document probably does not contain enough
information to start with.)
.SH OPTIONS
.PP
None.
.SH DIAGNOSTICS
.PP
\fChtml2stx\fP is a python script and will throw an exception if something
goes amiss.  In this case, the return value will be non-zero.
.SH SEE ALSO
.PP
\fCstx2any\fP (1), Stx-ref.html
.SH BUGS
.RS 4
.IP \(bu 4
\&The word wrapping algorithm is probably not very clever.
.IP \(bu 4
\&Sometimes there are extra linebreaks in the output.
.IP \(bu 4
\&Probably many others.
.RE
.SH AUTHOR
.PP
This manual page was written by Panu A. Kalliokoski.
.PP
\fChtml2stx\fP is derived from the \fChtml2text\fP utility by Aaron Swartz.
\fChtml2text\fP is a utility for converting html into \(lqMarkdown\(rq
structured text; the changes required to make it work for Stx were done
by Panu Kalliokoski.