= Seesaw plugin for moin =

http://seesaw.ncl.ac.uk/1.9/SeeSaw

== Configuration ==

 1. Images go in `/home/moin/moin-1.9.3/MoinMoin/web/static/htdocs/seesaw/img`
 1. `seesaw.js` and `jquery*.js` go in `/home/moin/moin-1.9.3/MoinMoin/web/static/htdocs/seesaw/js`
 1. Then edit `moin-1.9.3/wiki/wikiconfig.py` to include the necessary JS {{{#!python
# near the top
from MoinMoin.config import multiconfig, url_prefix_static
...

# at the bottom:
    html_head = '''
<script type="text/javascript" src="%(url_prefix_static)s/seesaw/js/jquery-1.4.4.min.js"></script>
<script type="text/javascript" src="%(url_prefix_static)s/seesaw/js/seesaw.js"></script>
''' % {'url_prefix_static':url_prefix_static}
}}}
 1. Configure Seesaw itself for the paths, `moin-1.9.3/wiki/data/plugin/macro/SeeSaw.py` {{{
#--- Configuration ----------------------------------------
from MoinMoin.config import url_prefix_static
img_prefix = url_prefix_static.rstrip("/") + "/seesaw/img"
}}}
 1. Restart the app process if not running in CGI mode (to reload the changed python files)


== Add borders to seesaw blocks ==

When you have large chunks of seesaw'd markup, adding a faint outline to the block can make it a little easier to identify. This could be done by editing the `common.css` of all your themes, but it's tedious and error prone, and also doesn't get kept as you add more themes.

Instead, let's add it to the seesaw code itself.

 1. Create the container directory for your CSS file, it probably doesn't exist yet. Adjust the path to suit your system {{{
mkdir /home/moin/moin-1.9.3/MoinMoin/web/static/htdocs/seesaw/css
}}}
 1. Add `seesaw.css` to the directory you just created: {{{
div.seesaw {
        border: 1px silver dotted;
}
}}}

 1. Edit `moin-1.9.3/wiki/wikiconfig.py` to include the new CSS, it goes in the edit you made for JS in the original setup {{{#!diff
--- OLDwikiconfig.py	2012-02-13 13:09:32.243905389 +1100
+++ wikiconfig.py	2012-02-13 13:12:08.991916014 +1100
@@ -178,5 +178,6 @@
     html_head = '''
 <script type="text/javascript" src="%(url_prefix_static)s/seesaw/js/jquery-1.4.4.min.js"></script>
 <script type="text/javascript" src="%(url_prefix_static)s/seesaw/js/seesaw.js"></script>
+<link rel="stylesheet" type="text/css" href="%(url_prefix_static)s/seesaw/css/seesaw.css">
 ''' % {'url_prefix_static':url_prefix_static}
 
}}}
 1. Restart the app process if not running in CGI mode (to reload the updated `wikiconfig.py`)



== Customisation ==

This makes the common desired use-case more concise to use when writing moin syntax, and tweaks the visual styling a little so that inline linkage (ie. hyperlinks as you're used to them on the internets) is neat and identifiable.

{{{#!diff
--- SeeSaw.py	2011-01-23 23:11:59.000000000 +1100
+++ /home/moin/moin-1.9.3/wiki/data/plugin/macro/SeeSaw.py	2011-11-14 14:35:39.659539842 +1100
@@ -224,7 +224,9 @@
 # Change this to the relative location of the images
 #
 # img_prefix="/moin_static18x/common"
-img_prefix="/img"
+#img_prefix="/img"
+from MoinMoin.config import url_prefix_static
+img_prefix = url_prefix_static.rstrip("/") + "/seesaw/img"
 #
 # Optionally change this (to extend the list of image sets)
 #
@@ -247,15 +249,15 @@
         else:
             return wikiutil.escape(x)
 
-    parser = wikiutil.ParameterParser('%(section)s%(toshow)s%(tohide)s%(show)b%(bg)s%(inline)s%(image)s%(speed)s%(seesaw)b%(addclass)s%(type)s%(effect)s')
+    parser = wikiutil.ParameterParser('%(section)s%(linktext)s%(toshow)s%(tohide)s%(show)b%(bg)s%(inline)s%(image)s%(speed)s%(seesaw)b%(addclass)s%(type)s%(effect)s')
     (count,dict) = parser.parse_parameters(args)
-    (section,toshow,tohide,show,bg,inline,image,speed,seesaw,addclass,type,effect) = (dict[x] for x in ('section','toshow','tohide','show','bg','inline','image','speed', 'seesaw','addclass','type','effect'))
+    (section,linktext,toshow,tohide,show,bg,inline,image,speed,seesaw,addclass,type,effect) = (dict[x] for x in ('section','linktext','toshow','tohide','show','bg','inline','image','speed', 'seesaw','addclass','type','effect'))
 
     if section is None:
         section = 'section'
 
     if speed is None:
-        speed = 0
+        speed = 100
     try:
         speed = int(speed)
     except:
@@ -269,13 +271,17 @@
     if show is None:
         show = False
 
-    if tohide is None and toshow is None:
-        if inline is None:
-            toshow = 'Show'; tohide = 'Hide'
-        else:
-            toshow = u'»»';  tohide = u'««'
-    elif tohide is None and toshow is not None:
-            tohide = toshow
+    if linktext is not None:
+        toshow = u'»%s' % linktext;
+        tohide = u'»%s' % linktext;
+    else:
+        if tohide is None and toshow is None:
+            if inline is None:
+                toshow = 'Show'; tohide = 'Hide'
+            else:
+                toshow = u'»»';  tohide = u'««'
+        elif tohide is None and toshow is not None:
+                tohide = toshow
     showpart = 'showpart'; showstyle = '''style="display:inline"'''
     hidepart = 'hidepart'; hidestyle = '''style="display:none"'''
     if show:
@@ -290,7 +296,7 @@
         openaction = closeaction = 'button'
 
     if effect is None or (effect != 'slide' and effect != 'fade'):
-        effect = 'show'
+        effect = 'slide'
     effect = "'%s'" % effect
 
     regex = re.compile(r'(.*)<<(.*)>>(.*)')
}}}