Debian Codegraph @

upstream/fedora-44/man1/sgml2html.1

raw
1 .\" Process this file with
2 .\" groff -man -Tascii sgml2html.1
3 .\"
4 .TH SGML2HTML 1 "16 May 2000"
5 .SH NAME
6 sgml2html \- create HTML output from a LinuxDoc DTD SGML source file
7 .SH SYNOPSIS
8 .B sgml2html [generic-option...] [--split
9 .I 0|1|2
10 .B ] [--toc
11 .I 0|1|2
12 .B ] [--dosnames] [--imagebuttons]
13 .IR file [.sgml]
14 .SH DESCRIPTION
15 .B sgml2html
16 is an old and obsoleted form of the html converter command
17 of LinuxDoc-Tools. It is recommended to switch the new form
18 .B linuxdoc -B html
19 now.
20 This converts a LinuxDoc DTD SGML source file to HTML output.
21 Output will appear in the top level file
22 .I file.html
23 and
24 .I file-n.html
25 for each section, where
26 .I file
27 is the name of the SGML source file and
28 .I n
29 is the section name.
30 .LP
31 The attribute/value pair "output=html" is set for conditionals.
32 .SH OPTIONS
33 .B sgml2html accepts all the generic options described in
34 .BR linuxdoc (1),
35 and the following specific options:
36 .IP "--split, -s"
37 What level to split source documents. 0 = don't split, 1 = split by
38 major sections, 2 = split by subsections.
39 .IP "--toc, -T"
40 What level to generate toc.
41 0 = don't generate toc at all,
42 1 = includes major sections(/chapters/parts),
43 2 = includes subsections.
44 .IP "--dosnames, -h"
45 Use ".htm" rather than ".html" as the extension of
46 .IP "--imagebuttons, -I"
47 Use the "next", "previous", and "contents" arrow image icons included
48 in /usr/share/linuxdoc-tools as navigation buttons.
49 .IP "--footer, -F"
50 Use the specified file as the footer in each resulted html file.
51 Default footer is just plain
52
53 .nh
54 .nf
55 .ad l
56 </BODY>\\n </HTML>\\n
57 .hy
58 .fi
59 .IP "--header, -H"
60 Use the specified file as the top part of the header in each resulted
61 html file. Note this is not the full part of the header.
62 (i.e. the title and the links (next,previous,contents) in the default
63 header are retained. Default is
64
65 .nh
66 .nf
67 .ad l
68 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">\\n
69 <HTML>\\n <HEAD>\\n
70 .hy
71 .fi
72 .IP file
73 The SGML source file, named either
74 .I file
75 or
76 .IR file.sgml .
77 .SH FILES
78 Many files and executables in /usr/share/linuxdoc-tools and /usr/bin are used.
79 .SH BUGS
80 None known.
81 .SH AUTHOR
82 Originally written by Greg Hankins <[email protected]>, and
83 Cees de Groot <[email protected]> for SGML-Tools (v1).
84 Currently maintained by Taketoshi Sano <[email protected]> for Linuxdoc-Tools.
85 .SH "SEE ALSO"
86 .BR linuxdoc (1),
87 .BR sgml2info (1),
88 .BR sgml2latex (1),
89 .BR sgml2lyx (1),
90 .BR sgml2rtf (1),
91 .BR sgml2txt (1),
92 .BR sgmlcheck (1).