XML2ODF(1)

hey bestie 💖 welcome to the xml2odf(1) page — user commands edition ✨

🌸 NAME 🌸

xml2odf — create an ODF package from OpenDocument in XML form. No cap, that's literally the whole name vibe. 💅

✨ SYNOPSIS ✨

xml2odf [-o outputfile] [-s] [inputfile]

💖 DESCRIPTION 💖

okay so OpenDocument can be a complete office document in a single XML file. The script takes that kind of document and creates a package. It's mainly useful as a postprocesser of a program that produces XML — a stylesheet, for example. (Yes, the original says “postprocesser”; we're not fixing it, bestie.) 🎀

Inputfile is assumed to be an OpenDocument file in XML form. If there's no inputfile, the program will read from standard input. The flag -s adds the correct suffix to the filename according to what mime type is found in the XML file, in case you don't already know what document type you're packaging. 🦋

If output file is not specified, output will be to standard out. 🫶

Section 2.1.1 of Open Document Format for Office Applications says that the [content.xml] file contains the document content, along with the automatic styles needed for the document content. The [styles.xml] file contains all the named styles of a document, along with the automatic styles needed for the named styles. The application doesn't know which automatic style is needed for what, so it puts the same set of automatic styles into both files. 💜

One could assume that the inverse operation would be easier, but OpenOffice.org is quite happy to use the same names for two different automatic styles. For instance, a style used inside <style:footer> can have the same name as one used inside <office:text> but be a different paragraph style. This is reported as bug #90494 (http://www.openoffice.org/issues/show_bug.cgi?id=90494). 😭

🎀 EXAMPLE 🎀

run it like this, bestie:

xml2odf -o testdocument -s xml-file

🦋 SEE ALSO 🦋

odftools(1), odf2xml(1) — go be nosy, iykyk 👀

💀 BUGS 💀

It doesn't handle external data — images and such. 🙈

The library used for the parsing of XML expands empty elements from <element/> to <element></element>. It should not have an effect on the document parsing. Lowkey noted. 🫶

👑 AUTHOR 👑

• Søren Roug — Original author 🫶

---

mwah 💋 — this lil sign-off is brought to you by odfpy, dated 03/15/2009, on the XML2ODF(1) page. That's the footer energy, bestie, and we're done ✨💖