lovasoa/ophir

This package is abandoned and no longer maintained. No replacement package was suggested.
There is no license information available for the latest version (0.1) of this package.

Convert ODT (OpenDocument) files to HTML

0.1 2014-05-13 20:51 UTC

This package is not auto-updated.

Last update: 2019-02-20 19:50:41 UTC


README

PHP script that converts ODT to HTML

ophir.php is a lightweight script that parses an open document file and outputs a simple HTML file, with very few tags (contrarily to most other tools that do the same thing).

Features

Currently, the script can convert the following:

  • bold (<strong> tag)
  • italic (<i> tag)
  • underline (<u> tag)
  • quotations (<blockquote> tag)
  • images (using data URIs)
  • links
  • headings (h1, h2, ...)
  • lists (ul and li)
  • tables (table tr and td)
  • annotations
  • footnotes.

Ophir.php can also ignore or remove some tags on demand. This can be useful if you want to extract only unformatted text from a document, or if you don't want tables, footnotes or annotations in the resulting HTML, or if the application that generated the ODT file produced unnecessary formatting informations ...

Limitations

Everything that is not mentioned in the feature section is not supported.

How to use this script

This script requires libzip and XMLReader, that are usually installed by default with php5. If you meet these requirements, just put ophir.php on your server, and use it like that:

require("ophir.php");

$OPHIR_CONF["footnote"] = 0; //Do not import footnotes
$OPHIR_CONF["annotation"] = 0; //Do not import annotations

$OPHIR_CONF["list"] = 1; //Import lists, but prints them as simple text (no ul or li tags will be generated)
$OPHIR_CONF["link"] = 1; //Import links, but prints them as simple text (only extract text from the links)

/*Available parameters are:
"header", "quote", "list", "table", "footnote", "link", "image", "note", and "annotation"
*/

echo odt2html("/path/to/file.odt");

License

Ophir.php is under LGPLv3. You can use it in both your free and proprietary software projects, but if you change some of the code, you have to share your improvements. Full license informations available at http://www.gnu.org/licenses/lgpl.html.

Other scripts

This script was coded in one afternoon to answer to my personal needs. More professional tools, with more features, that produce uglier HTML files are available: