WebODF

WebODF is a JavaScript library created by KO GmbH.

It makes it easy to add Open Document Format (ODF) support to your website and to your mobile or desktop application. It uses HTML and CSS to display ODF documents.

Visit the project homepage at: WebODF
Want some live demos? Visit: WebODF Demos
Get in contact, by the mailing list or IRC (#webodf auf freenode, Web access)

License

WebODF is a Free Software project. All code is available under the AGPL.

If you are interested in using WebODF in your commercial product (and do not want to disclose your sources / obey AGPL), contact KO GmbH for a license suited to your needs.

Creating webodf.js...

webodf.js is compiled by using the Closure Compiler. This compiler concatenates and compacts all JavaScript files, so that they are smaller and execute faster. CMake is used to setup the buildsystem, so webodf.js can be created:

git clone https://github.com/kogmbh/WebODF.git webodf
mkdir build
cd build
cmake ../webodf
make webodf.js-target

A successful run will yield the file "webodf.js" in the subfolder "build/webodf/" (among other things), from where you can then copy it and use for your website.

For more details about preparing the build of webodf.js , e.g. on Windows or OSX, please study "README-Building.md".

... and more

This repository not only contains code for the library webodf.js, but also a few products based on it. Here is the complete list:

build target	output location (in build/)	description	download/packages
webodf.js-target	webodf/webodf.js	the library	(see product-library)
product-library	webodf.js-x.y.z.zip	zip file with library and API docs	WebODF homepage
product-wodotexteditor	wodotexteditor-x.y.z.zip	simple to use editor component	WebODF homepage
product-wodocollabtexteditor	wodocollabtexteditor-x.y.z.zip	collaborative editor component	WebODF homepage
product-firefoxextension	firefox-extension-odfviewer-x.y.z.xpi	ODF viewer Firefox add-on	Mozilla's Add-on website

("x.y.z" is a placeholder for the actual version number)

For more details about the different products, please study "README-Products.md".

Changes between 0.5.8 and 0.5.9

WebODF

Fixes

Fix an issue where ODF zip files were incorrectly generated (#917)

Changes between 0.5.7 and 0.5.8

WebODF

Fixes

Fix chrome selections that cannot be collapsd by clicking inside them (#905)
Fix Inserted images being 1cm by 1cm in LibreOffice/OO (#904)
Fix exported zip file being uncompressed ([#21]https://github.com/kogmbh/WebODF/issues/21)

Wodo.TextEditor

Fixes

Disable custom buttons save/saveAs/close/download when there is no session (#893)

Changes between 0.5.6 and 0.5.7

WebODF

Fixes

Fix breaking all empty annotations on merging the paragraph they are contained in with the one before (#877))
Fix error message popup on deleting an annotation starting at the end of a paragraph or styled range (#880))
Fix wrong style information for text in annotations (#881))

Improvements

In OpAddAnnotation support annotated ranges with 0 length (#879))

Breaking changes

OpAddAnnotation spec changed: length=0 no longer means unranged annotation, but a range of 0 length. For unranged annotations now use length=undefined.

Wodo.TextEditor

See also section about WebODF

Improvements

Add a "review" modus where users can add, edit and remove own annotations, but not modify the actual document content (#883))

Changes between 0.5.5 and 0.5.6

WebODF

Fixes

No longer fail due to possible Byte Order Marks in ODF-internal XML files with Chromium (#872))

Wodo.TextEditor

See also section about WebODF

Improvements

Add options for "Save as" and "Download" buttons in Wodo.TextEditor (#865))

Changes between 0.5.4 and 0.5.5

WebODF

Improvements

Add a "documentModified" state with change signal to UndoManager classes (#857))

Fixes

No longer fail on "draw:master-page-name" attributes values with non-alphabetic chars (#742))

Wodo.TextEditor

See also section about WebODF

Improvements

Add a "documentModified" state with change signal (#857))

Fixes

Fix wrongly enabled hyperlink tools with no document loaded (#833)
Prevent Cross-Site Scripting from style names and font names (#849) (CVE-2015-3012)
Avoid badly rendered toolbar element with subsets of tools (#855))
Prevent Cross-Site Scripting from links (#850) (CVE-2015-3012)
Prevent browser translation service breaking the editor logic (#862))

Changes between 0.5.3 and 0.5.4

WebODF

Fixes

Only highlight ODF fields in edit mode (#816)
Prevent Cross-Site Scripting from file names (#851) (CVE-2014-9716)

Wodo.TextEditor

See also section about WebODF

Fixes

Fix broken loading of other files via "Open file..." button in localfileeditor example

Changes between 0.5.2 and 0.5.3

WebODF

Improvements

Add support for double line-through in Firefox (Chrome/Safari + IE don't support this feature) (#758)
Add support for subscript & superscript (#755)
In odf.OdfContainer allow creation of document template types as well as querying and setting the template state of the document

Fixes

Fixed occasional crash when splitting a paragraph (#723)
Keep IME composition menu & avatar in the correct position when entering characters
Allow screen-readers to read the document content correctly in OSX 10.8+ versions of Safari
Scroll newly created annotations completely into view (#486)
Improve line ending detection when word-wrapping occurs (#774)

Wodo.TextEditor

See also section about WebODF

Firefox Add-on ODF Viewer

Improvements

Add support for the flat-xml and template variants of ODT, ODP, ODS (i.e. FODT, FODP, FODS and OTT, OTP, OTS)

Changes between 0.5.1 and 0.5.2

WebODF

Fixes

For ODP files sometimes template elements from the master pages were rendered inside the actual slides.
Navigation via home/end keys, or up/down cursor keys is more reliable on all browsers. (#555, #405, #224, #185, #124, #98)
More elements from master pages are now correctly positioned when displayed inside slides.
In slides hide elements of class "header", "footer", "page-number" and "date-time" from master pages when configured so.

Changes between 0.5.0 and 0.5.1

WebODF

Improvements

numbering of multi-level lists is now well supported in rendering, including display of only a subset of the list numbers and continued numbering from previous lists (both text:continue-numbering and text:continue-list) (#565)

Fixes

Loading of documents without optional <style:list-level-properties> or <style:list-level-label-alignment> no longer fails and stalls
Loading of ODT files with annotations in Internet Explorer 10 (and possibly other versions) no longer fails and stalls

Wodo.TextEditor

See also section about WebODF

Fixes

Start-up of editor no longer hangs in some browsers Two different bugs were fixed which so far broke the start-up with Safari and other browsers using older WebKit versions as well as the default browser on Android 4.0.3 (#693)
All toolbar elements are now disabled when no document is loaded. (#709)