
    ooxml ECMA-376 Office Open XML File Formats


    This directory contains a freely distributable pure tcl extension called ooxml.


SYNOPSIS

    Read and write Office Open XML "XLSX" spreadsheets (since Excel 2007) and
    create Office Open XML "DOCX" word processing documents.

    Spreadsheets (package ooxml)

        This package contains several commands to edit Excel files. The three
        most important are the following three:

            Import Excel files into a Tcl array with ::ooxml::xl_read,
            export Tcl data to an Excel file with ::ooxml::xl_write and
            export a Tcl tablelist to an Excel file with ::ooxml::tablelist_to_xl.

    Word processing documents (package ooxml::docx)

        Create ECMA-376 WordprocessingML documents readable by Microsoft Word
        and LibreOffice. Documents are built from scratch or from an existing
        .docx template with ::ooxml::docx::docx. The objects have methods to
        add and style paragraphs, tables, images, headers and footers,
        footnotes, comments, fields, hyperlinks, lists, textboxes and math
        formulas (OMML).

    For information on how to use these commands, see the examples and the
    man-pages at https://fossil.sowaswie.de/ooxml.


DEPENDENCIES

    Tcl >= 8.6.7
    tdom >= 0.9.0 (the docx writer requires tdom >= 0.9.6)

    Reading xlsx and docx files uses the zlib command built into Tcl
    and needs no additional package. Optional fallback backends for
    archives the built-in reader cannot handle: Tcl 9 zipfs, tcllib
    zipfile::decode or tclvfs vfs::zip >= 1.0.4.

GETTING THE CODE

    The development repository is hosted at https://fossil.sowaswie.de/ooxml
    You are encouraged to use trunk.


INSTALLING

    Simply extract the download ooxml-<version>.zip into your Tcl library path.

    Since ooxml is TEA-compatible you should be able to do

        ./configure
        make test
        make install

    By default this installs into the lib directory of the Tcl
    installation found by configure (use --with-tcl to point it to the
    tclConfig.sh of another Tcl), so that this tclsh finds the package
    on its auto_path. To install into a different location use

        ./configure --prefix /path/to/tree

    which installs the package into /path/to/tree/lib/ooxml<version>.


REPORTING BUGS

    Please head to https://fossil.sowaswie.de/ooxml/ticket and
    click on "New Ticket". Log in as anonymous and report your findings.
    If you prefer to have an individual login write Alex a mail.


HISTORY

    ooxml was started by Alexander Schoepe (fossil@sowaswie.de)
    and improved with contributions by Rolf Ade (rolf@pointsman.de),
    Harald Oehlmann and Miguel Bañón. The docx subsystem was developed
    by Rolf Ade with contributions by Miguel Bañón.
