https://github.com/sideshowbarker/rng-incelim

incelim — Relax NG Splicer
https://github.com/sideshowbarker/rng-incelim

Last synced: 5 months ago
JSON representation

incelim — Relax NG Splicer

• Host: GitHub
• URL: https://github.com/sideshowbarker/rng-incelim
• Owner: sideshowbarker
• License: other
• Created: 2012-03-02T05:33:06.000Z (over 14 years ago)
• Default Branch: master
• Last Pushed: 2012-03-02T05:35:45.000Z (over 14 years ago)
• Last Synced: 2025-10-06T13:56:05.772Z (9 months ago)
• Homepage:
• Size: 97.7 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.html
  • License: license.txt

Awesome Lists containing this project

README

          


incelim — Relax NG Splicer









incelim — Relax NG Splicer

Version 1







This is a github fork of the incelim sources from

http://ftp.davidashen.net/incelim/





Table of Contents



Package Contents

Invocation

Aknowledgements

Terms and Conditions

News and updates











   incelim takes a Relax NG grammar in XML syntax, expands all

   includes and externalRefs, and optionally replaces references

   to text, empty, or notAllowed with the patterns. The result is

   a 'compiled' schema convenient for distribution.

  





    The package includes stylesheets for each of the transformation

    steps, and two kinds of glue: XSLT stylesheet incelim.xsl, which

    chains the transformations using exsl:node-set(), and a shell

    script, incelim, which applies each of the stylesheets to the 

    serialized result of the previous one.

  





Package Contents



inc.xsl



        literally inserts contents of included files (and externalRefs);

      

elim.xsl

removes overriden defines;

      

strip.xsl

splices references to single parameterless patterns

        (text,empty,notAllowed);

      

clean.xsl

filters out empty divs and unreferenced defines;

      

incelim.xsl

XSLT glue to chain the transformations;

      

incelim

(ash or bash) shell script to run each of the

      transformations in order;

      

saxon-6.5.3.diff

performance patch for SAXON 6.5.3;

      

readme.txt, readme.dbx

brief description in plain text and DocBook XML formats;

      

license.txt

the license.

      









Invocation

For the XSLT glue, the arguments are the source schema and

  the stylesheet. Parameter rinses specifies

  the number of times to apply strip/clean phase (it should be recursive,

  but it would be too complex for XSLT to stop timely). 1 is the default,

  more than 3 does not make sense in most practical cases.

  



Note





    xsltproc compiled against libxml 20604, libxslt 10102 and libexslt 802

    and earlier versions cannot be used with this stylesheets due to bugs

    in implementation of exsl:node-set();

    



    SAXON 6.5.[23] and jd.xslt 1.5.5 are slow, a patch for SAXON 6.5.3 that

    makes it fast is included in the distribution (saxon-6.5.3.diff).

    





The shell script takes a list of schema files and puts the

  result for each schema.rng into

  schema-compiled.rng. Additionally,the following

  command-line options are accepted:

  



-nnn

number of strip/clean passes (default is -1)

    

-processor

XSLT processor to use, default is

    -saxon, other options are xt, jd.xslt, xalan,

    4xslt, xsltproc

    





  Environment variable INCELIM should point to the

  directory containing XSLT scripts, default is

  /usr/local/lib/incelim.  Temporary files are

  created in a directory pointed to by environment variable

  TMPDIR, /tmp by default.









Aknowledgements

I would like to thank Sebastian Rahtz for the idea, inspiration, sample

stylesheet using exsl:node-set(),  and testing of the program.









Terms and Conditions

This software is distributed under BSD license. The details

are in license.txt.









News and updates



Visit http://davidashen.net/.