OASIS OpenDocument Essentials
   Next

OASIS OpenDocument Essentials

Using OASIS OpenDocument XML

Table of Contents

Preface
Who Should Read This Book?
Who Should Not Read This Book?
About the Examples
Organization of This Book
Conventions Used in This Book
How to Contact Us
Acknowledgments
1. The Open Document Format
The Proprietary World
The OpenDocument Approach
Inside an OpenDocument file
The manifest.xml File
Namespaces
Unpacking and Packing OpenDocument files
The Virtues of Cheating
2. The meta.xml, styles.xml, settings.xml, and content.xml Files
The settings.xml File
Configuration Items
Named Item Maps
Indexed Item Maps
The meta.xml File
The Dublin Core Elements
Elements from the meta Namespace
Time and Duration Formats
Case Study: Extracting Meta-Information
Archive::Zip::MemberRead
XML::Simple
The Meta Extraction Program
The styles.xml File
Font Declarations
Office Default and Named Styles
The content.xml File
3. Text Document Basics
Characters and Paragraphs
Whitespace
Defining Paragraphs and Headings
Character and Paragraph Styles
Asian and Complex Text Layout Characters
Case Study: Extracting Headings
Sections
Pages
Specifying a Page Master
Master Styles
Pages in the content.xml file
Bulleted, Numbered, and Outlined Lists
Case Study: Adding Headings to a Document
4. Text Documents—Advanced
Frames
Style Information for Frames
Body Information for Frames
Inserting Images in Text
Style Information for Images in Text
Body Information for Images in Text
Background Images
Fields
Date and Time Fields
Page Numbering
Document Information
Footnotes and Endnotes
Tracking Changes
Tables in Text Documents
Text Table Style Information
Text Table Body Information
Merged Cells
Case Study: Creating a Table of Changes
5. Spreadsheets
Spreadsheet Information in styles.xml
Spreadsheet Information in content.xml
Column and Row Styles
Styles for the Sheet as a Whole
Number Styles
Internationalizing Number Styles
Cell Styles
Table Content
Columns and Rows
String content Table Cells
Numeric Content in Table Cells
Putting it all Together
Formula Content in Table Cells
Merged Cells in Spreadsheets
Case Study: Modifying a Spreadsheet
Main Program
Getting Parameters
Converting the XML
DOM Utilities
Parsing the Format Strings
Print Ranges
Case Study: Creating a Spreadsheet
6. Drawings
A Drawing’s styles.xml File
A Drawing’s content.xml File
Lines
Line Attributes
Arrows
Measure Lines
Attaching Text to a Line
Basic Shapes
Fill Styles
Drop Shadows
Rectangles
Circles and Ellipses
Arcs and Segments
Polylines, Polygons, and Free Form Curves
Adding Text to Drawings
Rotation of objects
Case Study: Weather Diagram
Styles for the Weather Drawing
Objects in the Weather Drawing
Grouping Objects
Connectors
Custom Glue Points
Three-dimensional Graphics
The dr3d:scene element
Lighting
The Object
Extruded Objects
Styles for 3-D Objects
7. Presentation
Presentation Styles in styles.xml
Page Layouts in styles.xml
Master Styles in styles.xml
A Presentation’s content.xml File
Text Boxes in a Presentation
Images and Objects in a Presentation
Text Animation
SMIL Animations
Transitions
Interaction in Presentations
Case Study: Creating a Slide Show
8. Charts
Chart Terminology
Charts are Objects
Common Attributes for <draw:object>
Charts in Word Processing Documents
Charts in Drawings
Charts in Spreadsheets
Chart Contents
The Plot Area
The Chart Data Table
Case Study - Creating Pie Charts
Three-D Charts
9. Filters in OpenOffice.org
The Foreign File Format
Building the Import Filter
Building the Export Filter
Installing a Filter
A. The XML You Need for OpenDocument
What is XML?
Anatomy of an XML Document
Elements and Attributes
Name Syntax
Well-Formed
Comments
Entity References
Character References
Character Encodings
Unicode Encoding Schemes
Other Character Encodings
Validity
Document Type Definitions (DTDs)
Putting It Together
XML Namespaces
Tools for Processing XML
Selecting a Parser
XSLT Processors
B. The XSLT You Need for OpenDocument
XPath
Axes
Predicates
XSLT
XSLT Default Processing
Adding Your Own Templates
Selecting Nodes to Process
Conditional Processing in XSLT
XSLT Functions
XSLT Variables
Named Templates, Calls, and Parameters
C. Utilities for Processing OpenDocument Files
An XSLT Transformation
Getting Rid of the DTD
The Transformation Program
Transformation Script
Using XSLT to Indent OpenDocument Files
An XSLT Framework for OpenDocument files
OpenDocument White Space Representation
Showing Meta-information Using SAX
Creating Multiple Directory Levels
D. GNU Free Documentation License
0. PREAMBLE
1. APPLICABILITY AND DEFINITIONS
2. VERBATIM COPYING
3. COPYING IN QUANTITY
4. MODIFICATIONS
5. COMBINING DOCUMENTS
6. COLLECTIONS OF DOCUMENTS
7. AGGREGATION WITH INDEPENDENT WORKS
8. TRANSLATION
9. TERMINATION
10. FUTURE REVISIONS OF THIS LICENSE
ADDENDUM: How to use this License for your documents

List of Figures

1.1. Text Document
2.1. General Document Properties
2.2. Document Description
2.3. User-defined Information
2.4. Document Statistics
3.1. Document with Mixed Languages
3.2. Document Created with Whitespace XSLT Extension
3.3. OpenOffice.org Format Menu
3.4. Styled Headings
3.5. Tab Stops in OpenOffice.org
3.6. Column Spacing
3.7. Relationship Among Elements When Specifying Pages
3.8. Relationship Among Elements When Specifying Lists
3.9. Screenshot of an Outline List
4.1. Graphic Object Toolbars
4.2. Footnotes and Endnotes
4.3. Document with Changes Tracked
4.4. Table Width and Spacing
4.5. Other Table Properties
4.6. Cells Spanning Rows
4.7. Change Summary, Sorted by Time
5.1. Spreadsheet Page Options
5.2. Number Styles Dialog
5.3. Spreadsheet Showing Various Data Types
5.4. Spreadsheet Showing Number Style Linkages
5.5. Spreadsheet Print Ranges
5.6. Result of Gradebook Transformation
6.1. Measure Line for a Horizontal Line
6.2. Arrow Labelled with Text
6.3. Effect of Border on Gradients
6.4. Effect of Angle on Gradients
6.5. Effect of Center Coordinates on Gradients
6.6. Simple Polyline
6.7. Callout Text in a Drawing
6.8. Graphic weather template
6.9. Finished Weather Report Drawing
6.10. Default Glue Points
6.11. Custom Glue Points
6.12. Path for a Cone, Shell, and Half-Sphere
6.13. Flat-shaded Spheres with Differing Numbers of Segments
6.14. Gouraud-shaded Spheres with Differing Numbers of Segments
8.1. Chart Derived from Spreadsheet
8.2. Chart with Series in Rows
8.3. Scatter Chart
8.4. Chart With Even-Staggered Labels
8.5. Spreadsheet with Survey Responses
8.6. Text Document with Survey Responses
8.7. Insufficient Three-Dimensional Information
9.1. Imported Club Database
9.2. Styles in Writer Template
9.3. General Filter Information
9.4. Filter Transformation Information
B.1. Tree Representation of Sample Document

List of Tables

1.1. MIME Types and Extensions for OpenDocument Documents
1.2. Namespaces for OpenDocument
2.1. Dublin Core Elements in meta.xml
2.2. OpenDocument Elements in meta.xml
2.3. Attributes of the <meta:document-statistic> Element
2.4. Attributes of the <style:font-face> element
4.1. Document Information Fields
5.1. office:value-type and office:value
6.1. Path Commands
7.1. Default Presentation Styles
7.2. Some of the Many SMIL Transition Types
A.1. Examples of poorly formed XML documents
A.2. Predefined entity references in XML 1.0
A.3. Example character references in UTF-8
B.1. Examples of XPath Axes

List of Examples

1.1. Listing of Unzipped Text Document
1.2. Program to Unpack an OpenOffice.org Document
1.3. Program to Pack Files to Create an OpenDocument File
2.1. Example of Configuration Items
2.2. Program member_read.pl
2.3. Program show_meta.pl
2.4. Style Defintion in a Word Processing Document
2.5. Style Defintion in a Spreadsheet Document
2.6. Style Defintion in a Drawing Document
2.7. Structure of the content.xml file
3.1. Representation of Whitespace
3.2. XSLT Templates for Expanding Whitespace
3.3. Test XML file for Whitespace Conversion
3.4. Test XSL file for Whitespace Conversion
3.5. Font Declarations Include File
3.6. Using an Included Font Declaration File
3.7. Markup for <text:h>
3.8. Border Specification
3.9. Various Tab Stops
3.10. Extracting Headings from an OpenDocument File
3.11. OpenOffice.org Representation of Sections
3.12. Using a Section Style
3.13. Full Page Master Specification
3.14. Minimal Page Master Specification
3.15. Master Styles
3.16. Using Master Pages in content.xml
3.17. XML for an Outline List
4.1. XML Representation of a Frame
4.2. Footnote and Endnote XML
4.3. OpenDocument Change Tracking
4.4. Change Tracking in the Modified Text
4.5. Three by Two table without Repeating Headers
4.6. Cells Spanning Columns
4.7. XML for Cells Spanning Rows
5.1. Page Options
5.2. Style Information for a Sheet
5.3. Number Style for format #,##0.00
5.4. Number Style for format -#,##0.00 with Negative Values in Red
5.5. Scientific Notation for Format 0.00E+00
5.6. Fraction Style for Format # ??/??
5.7. Percent Style for Format #,##0.00%
5.8. Currency in Format -$#,##0.00
5.9. Currency Format for Greek Drachma
5.10. Date Styles
5.11. Time Style
5.12. Style for a Numeric Cell
5.13. Table Columns in a Spreadsheet
5.14. Return Types from Formulas
5.15. Minimal Formulas
5.16. Money Conversion Parameters
5.17. Structure of Print Ranges
5.18. Sample Gradebook Data
6.1. Master Styles in a Draw Document
6.2. Font Specification in a Drawing
6.3. Simple Horizontal Line
6.4. Style for a Simple Line
6.5. Non-continuous Line
6.6. Double Arrow Marker
6.7. XML for a Measure Line
6.8. XML for Labelled Arrow
6.9. Styles for Labelled Line
6.10. Solid Fill Style
6.11. XML Representation of Gradients
6.12. XML for Hatch Fill
6.13. XML for Bitmap Fill
6.14. XML for a Rectangle
6.15. XML for Circle and Ellipse
6.16. XML for Arcs and Segments
6.17. XML for a Polyline
6.18. Simple Text Box
6.19. XML for Callout Text
6.20. XML for Custom Glue Points
6.21. XML for a Cylinder
7.1. Structure of a styles.xml file
7.2. Text Boxes for a Page with Title and Two Outlines
7.3. Clip Art and Spreadsheet in a Presentation
7.4. Presentation Notes
7.5. Simple SMIL animation
7.6. XML for Presentation Actions Requiring Extra Information
8.1. XML for a Chart in a Word Processing Document
8.2. XML for Chart in Spreadsheet
8.3. Example of Chart Title and Subtitle
8.4. Plot Area and Style
8.5. Styles and Content for a Bar Chart
8.6. Styles for Bar Chart Excerpt
8.7. Table for Bar Chart
9.1. Sample Club Database
9.2. Stylesheet for Transforming Club List to Writer Document
B.1. Sample XML Document
B.2. Simple Templates
B.3. Gradebook Data in XML
B.4. Complex XPath Selector
B.5. Using <xsl:if>
B.6. Example of <xsl:choose>
B.7. Setting Variables
B.8. Named XSLT Template
B.9. XLST Template with Parameters
B.10. Calling an XSLT Template with a Parameter
C.1. Entity Resolver to Ignore DTDs
C.2. XSLT Transformation for OpenDocument files
C.3. Invoking the Transform Program
C.4. XSLT Transformation for Indenting
C.5. Program to Indent OpenDocument Files via XSLT
C.6. XSLT Framework for Transforming OpenDocument
C.7. Transforming Whitespace to OpenDocument XML
C.8. Program sax_show_meta.pl
C.9. Program to Create Directories

Copyright (c) 2005 O’Reilly & Associates, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".

   Next
   Preface