Docs: clarify difference between odt
and opendocument
output formats (and fix old link) #10518
Description
The manual is not clear about the difference between the odt
and opendocument
output formats.
- I only see one difference in the export of the tex_math_dollars extension
- The external link for
opendocument
is the legacy http://opendocument.xml.org/ and should probably link to the committee's page http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=office or to the relevant format specification page, e.g. https://www.oasis-open.org/2021/06/16/opendocument-v1-3-oasis-standard-published/ for version 1.3. - The external link for
odt
is currently titled "OpenOffice text document" and links to the Wikipedia page "OpenDocument". I think the text should be "OpenDocument Format" or something similar, as the format is not tool-specific (it can be used in LibreOffice, MS Office and many more), and OpenOffice is hardly maintained anyway.
... 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?