'\" t
.\"     Title: xml2odf
.\"    Author: S\(/oren Roug
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 10/12/2014
.\"    Manual: User commands
.\"    Source: odfpy
.\"  Language: English
.\"
.TH "XML2ODF" "1" "10/12/2014" "odfpy" "User commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
xml2odf \- Create ODF package from OpenDocument in XML form
.SH "SYNOPSIS"
.HP \w'\fBxml2odf\fR\ 'u
\fBxml2odf\fR [\-o\ \fIoutputfile\fR] [\-s] [\fIinputfile\fR]
.SH "DESCRIPTION"
.PP
OpenDocument can be a complete office document in a single XML file\&. The script will take such a document and create a package\&. This is mainly useful as a postprocesser of a program producing XML, such as a stylesheet\&.
.PP
\(lqInputfile\(rq
is assumed to be an OpenDocument file in XML form\&. If there is no inputfile, the program will read from standard input\&. The flag \-s adds correct suffix to the filename according to what mime type is found in the XML file, in cause you don\*(Aqt know already what document type you are packaging\&.
.PP
If output file is not specified output will be to standard out\&.
.PP
Section 2\&.1\&.1 of
Open Document Format for Office Applications
says that the [content\&.xml] file contains the document content, along with the
\fIautomatic styles\fR
needed for the document content\&. The [styles\&.xml] file contains all the named styles of a document, along with the
\fIautomatic styles\fR
needed for the named styles\&. The application doesn\*(Aqt know which automatic style is needed for what, so it puts the same set of automatic styles into both files\&.
.PP
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)
.SH "EXAMPLE"
.sp
.if n \{\
.RS 4
.\}
.nf
xml2odf \-o testdocument \-s xml\-file
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
.PP
\fBodftools\fR(1),
\fBodf2xml\fR(1)
.SH "BUGS"
.PP
Doesn\*(Aqt handle external data \-\- images and such\&.
.PP
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\&.
.SH "AUTHOR"
.PP
\fBS\(/oren Roug\fR
.RS 4
Original author
.RE