Difference between revisions of "Office Open XML/Legacy Implementation"
| Line 24: | Line 24: | ||
The set of explicit relationships for each package or part is stored in a relationship part whose name (or path) follows a specific convention e.g. the relationship part for a part called '''"/a/b/c.xml"''' is called '''"/a/b/_rels/c.xml.rels"'''. As a special case, the relationship part for the package as a whole is called '''"/_rels/.rels"'''. | The set of explicit relationships for each package or part is stored in a relationship part whose name (or path) follows a specific convention e.g. the relationship part for a part called '''"/a/b/c.xml"''' is called '''"/a/b/_rels/c.xml.rels"'''. As a special case, the relationship part for the package as a whole is called '''"/_rels/.rels"'''. | ||
| − | |||
= AOO.o Implementation = | = AOO.o Implementation = | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Spreadsheet and Presentation import are both in the [[Oox|oox]] module. | Spreadsheet and Presentation import are both in the [[Oox|oox]] module. | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Word document import is in the [[WriterFilter|writerfilter]] module. | Word document import is in the [[WriterFilter|writerfilter]] module. | ||
| − | |||
Some legacy notes: | Some legacy notes: | ||
| Line 59: | Line 42: | ||
[http://bonsai.go-oo.org/cvsquery.cgi?treeid=default&module=all&branch=cws_src680_xmlfilter03&branchtype=match&dir=xml%2Foox&file=&filetype=match&who=&whotype=match&sortby=Date&hours=2&date=week&mindate=&maxdate=&cvsroot=%2Fhome%2Fooweb%2Fcvsup the changes done in the last 2 weeks] | [http://bonsai.go-oo.org/cvsquery.cgi?treeid=default&module=all&branch=cws_src680_xmlfilter03&branchtype=match&dir=xml%2Foox&file=&filetype=match&who=&whotype=match&sortby=Date&hours=2&date=week&mindate=&maxdate=&cvsroot=%2Fhome%2Fooweb%2Fcvsup the changes done in the last 2 weeks] | ||
| + | == Oox == | ||
| + | |||
| + | There is some code in the oox module ([[OOX]]) from the [[Xml]] project. After OpenOffice moves to Apache, to fetch the oox code from SVN: | ||
| + | |||
| + | svn co https://svn.apache.org/repos/asf/incubator/ooo/trunk/main/oox ooo/oox | ||
| + | |||
| + | One important note: we use the term '''fragment''' in the name of our source files to correspond with what the standard calls '''part'''. For instance, the source file that contains class definition that handles the workbook part in [[SpreadsheetML]] is called workbookfragment.cxx. This convention is prevalent across all application types within [[oox]] module. | ||
| + | |||
| + | == Writerfilter == | ||
| + | |||
| + | To fetch the writerfilter code from SVN: | ||
| + | |||
| + | svn co https://svn.apache.org/repos/asf/incubator/ooo/trunk/main/writerfilter ooo/writerfilter | ||
== Implementation Generalities == | == Implementation Generalities == | ||
Revision as of 04:03, 22 June 2012
Contents
OOXML Basics
"Office Open XML" is an XML based file format that has been published as ECMA-376. It is used as default file format by Microsoft Office 2007/2010.
There are plans to support this file format in OpenOffice.org for interoperation with Microsoft Office 2007/2010.
There are 3 major types of formats with 2 minor types as important supplement.
- WordprocessingML - For word processor documents (file extensions may be docx, docm)
- SpreadsheetML - For spreadsheet documents (file extensions may be xlsx, xlsm)
- PresentationML - For presentation documents (file extensions may be pptx, pptm)
- DrawingML - Used by other markup language to represent graphics data.
- VML - A legacy vector markup.
Packaging Conventions
OpenXML document is a package that consists of a flat collection of "parts". Each "part" has a case-insensitive part name that consists of a slash (/) delimited sequence of segment names such as "/pres/slides/slide1.xml".
For the most part, the ZIP compression is used to package the parts, in which case the term "package" refers to the ZIP archive, and the parts refer to the individual files archived within. The part name in this case is the file path within the archive.
Each part also has a content type, and /[Content_Types].xml provides the content type of each part within the archive.
Relationships
Packages and parts can contains explicit relationships to other parts as well as to external resources. Every explicit relationship has an ID and a type, and relationship types are named using URIs.
The set of explicit relationships for each package or part is stored in a relationship part whose name (or path) follows a specific convention e.g. the relationship part for a part called "/a/b/c.xml" is called "/a/b/_rels/c.xml.rels". As a special case, the relationship part for the package as a whole is called "/_rels/.rels".
AOO.o Implementation
Spreadsheet and Presentation import are both in the oox module. Word document import is in the writerfilter module.
Some legacy notes:
The initial version of oox from the CWS xmlfilter02 has been integrated into SRC680_m243. The continuing CWS is xmlfilter03 in SRC680. (view the workspace on EIS)
To fetch the oox code from CVS (using CVSROOT is set properly):
cvs co -r cws_src680_xmlfilter03 -d oox xml/oox
Bonsai is also convenient to follow the changes:
the changes done in the last 2 weeks
Oox
There is some code in the oox module (OOX) from the Xml project. After OpenOffice moves to Apache, to fetch the oox code from SVN:
svn co https://svn.apache.org/repos/asf/incubator/ooo/trunk/main/oox ooo/oox
One important note: we use the term fragment in the name of our source files to correspond with what the standard calls part. For instance, the source file that contains class definition that handles the workbook part in SpreadsheetML is called workbookfragment.cxx. This convention is prevalent across all application types within oox module.
Writerfilter
To fetch the writerfilter code from SVN:
svn co https://svn.apache.org/repos/asf/incubator/ooo/trunk/main/writerfilter ooo/writerfilter
Implementation Generalities
The whole OOX filter makes use of FastParser service to implement an event driven SAX parser.
