office-gobmx/xmloff
Michael Stahl 9c2c48f145 tdf#128150 xmloff: ODF import/export of fill-use-slide-background
This would be better as a value of draw:fill, but we can't add values as
an extension.

Change-Id: I05db879a8cb5018e0261f049ae91a5b9aaa760b6
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/135814
Tested-by: Jenkins
Reviewed-by: Samuel Mehrbrodt <samuel.mehrbrodt@allotropia.de>
2022-06-20 10:36:55 +02:00
..
dtd dtd files are not xml files and shouldn't have xml headers 2021-06-09 12:41:53 +02:00
inc add o3tl::equalsAscii 2022-05-03 09:12:32 +02:00
qa tdf#149551 write draw:text-rotate-angle only once 2022-06-16 00:57:51 +02:00
source tdf#128150 xmloff: ODF import/export of fill-use-slide-background 2022-06-20 10:36:55 +02:00
util WASM --enable-wasm-strip now skips lots of LO code 2022-01-20 12:28:54 +01:00
CppunitTest_xmloff_draw.mk CppunitTest_xmloff_draw needs the ASan LD_LIBRARY_PATH hack now too 2021-12-07 17:14:20 +01:00
CppunitTest_xmloff_style.mk ODF export: sort <style:font-face> elements based on the style:name attribute 2021-03-11 16:14:57 +01:00
CppunitTest_xmloff_text.mk tdf#62032 ODT export: handle style:list-level="..." for para styles 2021-09-03 19:01:08 +02:00
CppunitTest_xmloff_uxmloff.mk gbuild: Remove MSVC 2013 legacy code 2017-04-21 18:18:44 +02:00
CustomTarget_generated.mk GSoC - implement global tokenhandler for odf-tokens 2016-08-16 20:31:31 +00:00
IwyuFilter_xmloff.yaml rename xmlnmspe -> xmlnamespace 2020-08-14 13:59:05 +02:00
JunitTest_xmloff_unoapi.mk Simplify and fix Java UNO API test makefiles 2018-11-09 07:37:00 +01:00
Library_xo.mk sw content controls: add ODT import 2022-04-11 12:43:45 +02:00
Library_xof.mk WASM --enable-wasm-strip now skips lots of LO code 2022-01-20 12:28:54 +01:00
Makefile switch to include-based build rather than sourced-based build 2012-02-05 19:34:05 -06:00
Module_xmloff.mk Fix the minimal build-tools target 2020-09-11 18:34:48 +02:00
Package_dtd.mk gbuild: set Package default target to INSTDIR 2013-10-28 20:17:26 +01:00
README.md Updated README.md files 2021-04-19 11:13:41 +02:00

ODF Import and Export Filter Logic

The main library "xo" contains the basic ODF import/export filter implementation for most applications. The document is accessed via its UNO API, which has the advantage that the same import/export code can be used for text in all applications (from/to Writer/EditEngine). The filter consumes/produces via SAX UNO API interface (implemented in "sax"). Various bits of the ODF filters are also implemented in applications, for example [git:sw/source/filter/xml].

There is a central list of all element or attribute names in [git:include/xmloff/xmltoken.hxx]. The main class of the import filter is SvXMLImport, and of the export filter SvXMLExport.

The Import filter maintains a stack of contexts for each element being read. There are many classes specific to particular elements, derived from SvXMLImportContext.

Note that for export several different versions of ODF are supported, with the default being the latest ODF version with "extensions", which means it may contain elements and attributes that are only in drafts of the specification or are not yet submitted for specification. Documents produced in the other (non-extended) ODF modes are supposed to be strictly conforming to the respective specification, i.e., only markup defined by the ODF specification is allowed.

There is another library "xof" built from the source/transform directory, which is the filter for the OpenOffice.org XML format. This legacy format is a predecessor of ODF and was the default in OpenOffice.org 1.x versions, which did not support ODF. This filter works as a SAX transformation from/to ODF, i.e., when importing a document the transform library reads the SAX events from the file and generates SAX events that are then consumed by the ODF import filter.

OpenOffice.org XML File Format

There is some stuff in the "dtd" directory which is most likely related to the OpenOffice.org XML format but is possibly outdated and obsolete.

Add New XML Tokens

When adding a new XML token, you need to add its entry in the following three files:

  • [git:include/xmloff/xmltoken.hxx]
  • [git:xmloff/source/core/xmltoken.cxx]
  • [git:xmloff/source/token/tokens.txt]