Skip to content

Docs: clarify difference between odt and opendocument output formats (and fix old link) #10518

Closed
@stragu

Description

The manual is not clear about the difference between the odt and opendocument output formats.

... but this all depends on what exactly is the difference between the two.

Using pandoc 3.1.3, I get the following in meta.xml for the extracted odt output:

<office:document-meta xmlns:office="urn:oasis:names:tc:opendocument:xmlns:office:1.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:meta="urn:oasis:names:tc:opendocument:xmlns:meta:1.0" xmlns:ooo="http://openoffice.org/2004/office" xmlns:grddl="http://www.w3.org/2003/g/data-view#" office:version="1.3">

And for the opendocument output, I only get a single text file that is roughly the same as the contents of the <office:text>...</office:text> tag of the contents.xml of the full ODT output. (It has more lines, not sure what the difference is, but there is no XML header whatsoever, so not even a flat ODF / FODF).

I'm not sure what this opendocument format output is used for in practice, and what software supports opening this kind of header-less file (if any), but this distinction between opendocument's plain text vs odt's usual zip-compressed collection of XML files should be made clear in the documentation. (And users we should tell users they likely want to use odt.)

What do you think?

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions