
------------------------------------------------------
Precode Cookbook/Addon Recipe/Module for PmWiki 2.2.4+
------------------------------------------------------

About:
======
General utility block markup for displaying codes on wiki pages. 

Features:
=========
1. Long rfc style text can be input and referenced by line.
2. Can be used by syntax-highlighting js tools like highlightjs/prettify
   with all its features.

Installation:
======================================================
HOW TO USE/INSTALL Precode v.1.x in PmWiki v.2.2.4+
======================================================
1. Place the precode folder under cookbook/

2. Make an entry in your config.php file

    if (file_exists("cookbook/precode/precode.php")) {
        $EnablePrecode = 1;
        $Precode['wwwdir'] = '/www/path/to/precode';
        $Precode['jquery'] = '/www/path/to/jquery.js';
        include_once('cookbook/precode/precode.php');
    }

3. Options for directives.

```showlines linereset=200 liststyle='upper-roman' step=1
[@
  .... lines of code ....
  .... lines of code ....
@]
```

  3.1. showlines | showlines=0
  3.2. liststyle=decimal
        OPTIONS:
        disc | circle | square | decimal | decimal-leading-zero |
        lower-roman | upper-roman | lower-greek | lower-latin |
        upper-latin | armenian | georgian| lower-alpha | upper-alpha |
        none | inherit | disclosure-open | disclosure-closed
  3.3. linereset=1 (+/-number)
  3.4. step=1 (+/-number)
  3.5. prefix=text
  3.6. suffix=text
  3.7. classreset=class[:(+/-number)]
  3.8. highlights=<comma separated numbers>, eg. 2,4


/* USAGE
///////////////////////////////////////////////////

```python showlines linereset=200 liststyle='upper-roman'
[@
@requires_authorization
def somefunc(param1='', param2=0):
    r'''A docstring'''
    if param1 > param2: # interesting
        print 'Gre\'ater'
    return (param2 - param1 + 1) or None

class SomeClass:
    pass
@]
```

///////////////////////////////////////////////////
