Updating filters status

This page describes how to update the filter status information on the web site to reflect changes in the KOffice filters.

The filter status information is documented for each version of KOffice in tabular form. Optionally, each filter may also have a separate page that provides more information about the filter such as supported features, or workarounds for missing features. These notes are linked to from the filters status table for that version.

The filter status table is constructed from an XML file. The XML file that describes the filter status for the next release of KOffice is located in the Subversion repository at trunk/koffice/filters/filterstatus.xml and can be viewed here.

Since the website maintains filter status pages for recent versions of KOffice, it's necessary to keep a separate version of the file for each KOffice branch. Thus if a filter is improved during the life of a branch, its web page can be updated from the copy of filterstatus.xml in that branch.

Required software

The xsltproc program is needed to update the filter status table.

From XML description to HTML

To update the filter status table on the website, you'll need a checkout of:

• the filters directory on the website
• the filters directory for the relevant KOffice branch (a non-recursive checkout will do, only filterstatus.xml is needed)

For example, suppose the filters information for KOffice 1.4 needs to be updated, the procedure is as follows.

If you don't already have a checkout of the KOffice www tree (see here for more information), then checkout the filters directory:

$ svn co https://svn.kde.org/home/kde/trunk/www/areas/koffice/filters \
    filters-www

And a copy of the filterstatus.xml file for the relevant branch:

$ svn co -N https://svn.kde.org/home/kde/branches/koffice/1.4/koffice/filters \
    filters-1.4

Now change into the filters directory in the website checkout:

$ cd filters-www

A new version of the filter status page can be built using xsltproc and a stylesheet in the website source to parse the filterstatus.xml file from the KOffice branch.

xsltproc scripts/FilterStatusStablePhp.xslt \
  ../filters-1.4/filterstatus.xml > 1.4/index.php