SGML2HTML(1)

📦
version 0.9.86 · 6 versions
, in arch rolling, debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 SGML2HTML(1) — the glow-up page 💖

okay bestie, gather round 🫶 this is the manual page for sgml2html, living in section 1 of the general commands manual. Let's get into it ✨

✨ NAME ✨

sgml2html — the girl whose whole job is creating HTML output from a LinuxDoc DTD SGML source file 🎀

🌸 SYNOPSIS 🌸

sgml2html [generic-option...] [--split 0|1|2 ] [--toc 0|1|2 ]
[--dosnames] [--imagebuttons] file[.sgml]

🦋 DESCRIPTION 🦋

So sgml2html is, and I say this with love, an old and obsoleted form of the html converter command of LinuxDoc-Tools. Like, the name is genuinely misleading — it is not a tool for any SGML DTD, it only supports the SGML LinuxDoc DTD. It's giving "the name oversells it" 😭

The recommended move? Switch to the new form linuxdoc -B html right now, bestie. Periodt.

What it does do: it converts a LinuxDoc DTD SGML source file to HTML output. Output shows up in the top level file file.html and file-n.html for each section — where file is the name of the SGML source file and n is the section name. Cute, structured, we love a naming convention 💅

Also, the attribute/value pair output=html is set for conditionals. Slay.

💅 OPTIONS 💅

sgml2html accepts all the generic options described in linuxdoc(1) (go read that one, iykyk), plus these specific ones below 👇

  • --split, -s — what level to split source documents at. 0 = don't split, 1 = split by major sections, 2 = split by subsections. Pick your fighter 🎀
  • --toc, -T — what level to generate toc at.
    • 0 = don't generate toc at all,
    • 1 = includes major sections(/chapters/parts),
    • 2 = includes subsections.
  • --dosnames, -h — use .htm rather than .html as the extension of
  • --imagebuttons, -I — use the next, previous, and contents arrow image icons included in /usr/share/linuxdoc-tools as navigation buttons. Aesthetic navigation?? Obsessed 🔥
  • --footer, -F — use the specified file as the footer in each resulted html file. Default footer is just plain
</BODY>\n </HTML>\n
  • --header, -H — use the specified file as the top part of the header in each resulted html file. Note that this is not the full part of the header — i.e., the title and the links (next, previous, contents) in the default header are retained. Default is
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">\n
<HTML>\n <HEAD>\n
  • file — the SGML source file, named either file or file.sgml. Either name works, she's flexible like that 🧚

🍓 FILES 🍓

Many files and executables in /usr/share/linuxdoc-tools and /usr/bin are used. That's the whole vibe. Many. Files. 💀

💀 BUGS 💀

None known. Not a single one. Flawless behaviour, allegedly. 🙈

👑 AUTHOR 👑

Originally written by Greg Hankins <greg.hankins@cc.gatech.edu>, and Cees de Groot <cg@cdegroot.com> for SGML-Tools (v1), and maintained by Taketoshi Sano <sano@debian.org> for Linuxdoc-Tools. Currently maintained by Agustin Martin <agustin6martin AT gmail com>. The lineage?? Immaculate. Respect the elders 🫶

🌈 SEE ALSO 🌈

linuxdoc(1), sgml2info(1), sgml2latex(1), sgml2lyx(1), sgml2rtf(1), sgml2txt(1), sgmlcheck(1) — the whole friendship group, go say hi 💖

And that's the page, bestie!! This version is from SGML2HTML(1) in the General Commands Manual, dated 2025-04-06 ✨ stay slaying, and remember: switch to linuxdoc -B html 💅💖🎀

📦 where this page comes from