Note on sisu markup 2006-04-15, Ralph Amissah

SiSU 0.38 ships with document markup samples prepared with an experimental
notation for structure.

This note is to point out that sisu-0.38 should be able to process both the
experimental and traditional markup, and a script is provided within
sisu-examples to make conversion between 0.36 and 0.38 experimental markup
fairly simple.

The script modify.rb is found in: 
  sisu-examples/config/convert/modify.rb

The changelog describes it thus:

  an auto-converter, with canned conversion from 0.36/traditional to 0.38 (rad)
  markup and back from 0.38 (rad) to 0.36/traditional is tossed in to
  sisu-examples (permissions at 644)
    sisu-examples/config/convert/modify.rb

    once enabled (permissions and path set), usage:
      modify.rb --convert [filename/wildcard]

    for further options and generally a better place to begin:
      modify.rb --help
      [which currently brings up the following:]

        This is a script that contains canned text conversions for reuse

        modify.rb --default [filename/wildcard]
          performs the current default conversion that is set
        
        modify.rb --to38 [filename/wildcard]
          converts pre 0.36 sisu markup to 0.38 experimental
        
        modify.rb --to36 [filename/wildcard]
          converts pre 0.36 sisu markup to 0.38 experimental
        
        modify.rb --default
          performs the current default conversion that is set
          on the files matched in default the settings

    this is a fairly generic simple tool that can be used to store other canned
    conversions

SiSU markup sample Notes:
SiSU http://www.jus.uio.no/sisu
SiSU markup for 0.16 and later:
  0.20.4 header 0~links 
  0.22 may drop image dimensions (rmagick)
  0.23 utf-8 ß
  0.38 or later, may use alternative notation for headers, e.g. @title: (instead of 0~title)
  0.38 document structure alternative markup, experimental (rad) A,B,C,1,2,3 maps to 1,2,3,4,5,6
