sgml2xml-isoent(1)

📦
version 0.8.8 · 2 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, centos-stream 9, debian bookworm, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy

💖 sgml2xml-isoent — the glow-up page 💖

okay so bestie, this is sgml2xml-isoent(1) from the docbook2X manual set, and it's basically the friend who takes your crusty old SGML and walks it into the XML party with its whole outfit already on. let's get into it ✨

✨ NAME ✨

sgml2xml-isoent — Convert SGML to XML with support for ISO entities 🦋

🌸 SYNOPSIS 🌸

sgml2xml-isoent [sgml-document]

like, you hand it one SGML document, that's the whole vibe 💅

💅 DESCRIPTION 💅

sgml2xml-isoent takes an SGML document and turns it into XML, and — this is the part that eats — it comes with support for the ISO entities. 🔥

how does it pull that off? it runs sgml2xml(1) from the SP package (or osx(1) from the OpenSP package, whichever one you've got), and then it adds the declaration for the XML version of the ISO entities to the output. so the thing you get at the end should just work as-is with any XML tool. no extra steps, no glue, no duct tape. periodt. 👑

this program is often used for processing SGML DocBook documents with XML-based tools. in particular, db2x_xsltproc(1) calls this program as part of its --sgml option. iykyk. 🫶

but lowkey, this is probably not helpful for migrating a source SGML text file to XML, because the conversion mangles the original formatting. 😭 if you wanted your pretty hand-formatted SGML to stay pretty, this is not that girl.

and because the XML version of the ISO entities are referred to directly — not via a DTD — this tool also works with document types other than DocBook. versatile icon behavior. 🌈

🎀 NOTES 🎀

the ISO entities get referred to using the public identifiers ISO 8879:1986//ENTITIES//...//EN//XML. note that ... is literally how the identifier is written, don't come for me. 🥲

the catalogs used when parsing the converted document should resolve these entities to the appropriate place (on the local filesystem). so like, your catalog needs to know where they live on your machine. 🏠

if the entities are not resolved in the catalog, then the fallback is to get the entity files from the http://www.docbook.org/ Web site. so worst case, it goes online and grabs them. 🌐

👑 AUTHOR 👑

Steve Cheng <stevecheng@users.sourceforge.net>.

🔥 SEE ALSO 🔥

and that's the whole page bestie!! 💖 this was docbook2X version 0.8.8, dated 3 March 2007. go forth and convert, no cap. 💅✨🎀

📦 where this page comes from