GSoC 2009 ODT Import Plugin by atmb4u

From Scribus Wiki
Jump to navigation Jump to search

Proposal

Abstract

Developed as a part of OpenOffice.org 2 and now a part of an ISO standard supported by Google Docs, the Open Document Text (ODT) format based on the former OpenOffice.org format SXW is the most widely used open word-processing file format. This project aims to implement full import of ODT/SXW files into Scribus. This goal will be achieved through implementation of an ODT/SXW file import plug-in. ODT/SXW file text export from Scribus will be taken into consideration during the import plug-in design phase.


Motivation

The need for the rich word processing format import capabilities in desktop publishing software is undisputed. When it comes to the most widely used format, the problem becomes crucial. ODT and SXW are very popular universal open word processing formats thus it is essential that they can be imported natively into Scribus. Scribus makes desktop publishing with free and open software possible and import of ODT/SXW files directly into the scribus workspace will only make it work better. As with all DTP software, Scribus is rarely used to write text. Instead, it is used for layout purposes while the text is prepared in a word processor. Therefore, as I found during the time I spent using Scribus, it is necessary to import documents from a word processor. This project will produce wide-reaching usability improvements for most Scribus users. I choose SXW along with ODT, since these file formats are very similar. Moreover, I'd appreciate working with an open source project like Scribus and the open source community.


Objectives

The project's objectives are to produce:

- ODT/SXW import plug-in module and, if time permits, ODT export for Scribus via plug-in.

- In the import, focus on text, images, formatting and margins.*

- Document the plug-in.


Challenges

The major challenges that will be faced during the implementation of this project are

- Reading ODT/SXW files.

- Importing basic and common items like text, graphics, page setup, margins, page numbering, static headers and footers, paragraph and character styles and document meta-data as supported by Scribus.

- Opening an ODT/SXW in the workspace by converting it to a Scribus document.


The Plan

- Decode (read the XML) the ODT/SXW files from the compressed form and save them in a temporary storage space.

- Read bitmap, vector and text contents from ODT/SXW.

- Styles, page layout and margins will be read from the source file and imported into the Scribus document.

- Convert the entire ODT/SXW file into a Scribus document.

- Positioning the objects has to be correctly determined, but this will have lower priority as there is no anchor support in Scribus yet.

Each Project time line division consists of first few days of research, discussion in the Scribus community followed by implementation.


Timeline

From June 10 to October 31


June 10 –June 15: Understand the XML formatting of ODT and SXW files. Read the documentation of Scribus, especially learn as much as possible about working with Scribus codebase. Communicate with mentors and clear basic doubts about the project. Design the structure of the plug-in, the scope of import and discuss its structure on IRC and mailing lists.

June 15-June 25: Convert existing ODT text import as a part of proposed plug-in.

June 25-July 5 : Study about the scope of import of image files in ODT files

July 5 -July 30: -UNAVIALABLE-

July 31-August 31: Import image files from ODT/SXW files into the Scribus document.

September 1- September 5 :Study about Text Styles and text formating(bold,italics,size) in ODT as well as Scribus.

September 6- September 25:Code for text formating in ODT files import to Scribus.

September 25-September 30:Study about Margins, Paragraphs and other page formating in ODT.

October 1-October 20 :Code for Importing page formating to Scribus.

October 20-October 25:Complete the coding and sync. the entire project.

October 26-October 31:Complete the documentation for future developments in the plug-in.


Note: Timeline doesn't include the expected everyday interaction with my mentor.


Project Outcomes

The expected outcomes of this project:

- ODT/SXW files can be imported with basic contents and the breadth of the import support will be expanded as time allows with a minimum guarantee for basic and common items like text, graphics, page setup, margins, page numbering, paragraph and character styles in ODT/SXW files to be imported into Scribus. This will not be a complete ODT/SXW importer, which would be too large to be fit in the limited time frame.

- Proper documentation acceptable to the Scribus maintainers accompanies the code.


Notes

  • Currently, focus 4 major imports as the short term project and elaborate the plug-in later on for complete import.