FX2SX

Section: Misc. Reference Manual Pages (AUGUST 2002)
Index

NAME

fx2sx - convert a flat xml file into a structured

SYNOPSIS

fx2sx prefix

DESCRIPTION

fx2sx consists of a shell script and a xslt stylesheet for converting a flat xml file into a structured version. The rules for the structure are read from the file <prefix>.dsd. <prefix>.xsl - which follows these rules - is generated and applied to <prefix>.xml. The result is written to stdout. File locations and the path to the xsl processor are adjustable within this script.

FILES

fx2sx: Shell script for linux platforms
fx2sx.cmd: Shell script for MS NT platforms
fx2sx.xsl: The stylesheet which generates <prefix>.xsl
<prefix>.xml: The flat xml file. See sx.dtd for details.
<prefix>.dsd: The ruleset describing the source and target structures in XML. See sx.dtd for details.
sx.dtd: DTD for the structuring rules http://www.msdd.net/fx2sx/sx.dtd

FEATURES

- ultra flexible tag name handling
- arbitrary insertion of elements
- intuitive data structure definition

SAMPLE

input data: presentation.xml: http://www.msdd.net/fx2sx/sample/presentation.xml
structuring rules for input and output: presentation.dsd: http://www.msdd.net/fx2sx/sample/presentation.dsd
output data: output.xml: http://www.msdd.net/fx2sx/sample/output.xml
generated stylesheet: presentation.xsl: http://www.msdd.net/fx2sx/sample/presentation.xsl

PREREQUISITES

A working xslt processor (p.e. saxon, xt or sablotron)

DOWNLOADS

http://www.msdd.net/fx2sx/fx2sx-0.2.0.tgz: Archive containing scripts for all available platforms.

INSTALLATION

1.: Get the archive from the download section and unpack it.
2.: Choose the appropriate shell script and make adjustments to file paths using your favourite text editor.
3.: Now change to the sample directory and give it a try: #../fx2sx presentation
4.: Play arround with presentation.dsd and watch the changes in the output
5.: Do your own conversions

BUGS

As long as the input files are wellformed no error is returned. However, the output might not match your expectations. XML parsing errors are returned by the xsl processor used.

AUTHOR

Friedhelm Duesterhoeft <fx2sx at msdd dot net>

The latest version of the scripts is available at

http://www.msdd.net/fx2sx/

CREDITS

Toru Marumoto: for his idea of a dsd file ( http://toru.marumoto.net )
all 'csv to xml converter programmers': which I found to leave me with too much work after successfull conversion ;-)

COPYRIGHT

     This program is free software; you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
     the Free Software Foundation; either version 2 of the License, or
     (at your option) any later version.

     This program is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU General Public License for more details.

     You should have received a copy of the GNU General Public License
     along with this program; if not, write to the Free Software
     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Mail bug reports and suggestions to the author

This document was created by man2html, using the manual pages.
Time: 15:27:24 GMT, August 29, 2002