SeeSaw Macro

Note that this stuff is currently experimental

( hide Contents)

Contents

SeeSaw is a MoinMoin macro written by Jim Wight.

Overview

In case that a particular topic is very complex, you might have to provide quite a large amount of information. On the Web, chances are that a user will stop reading any information at all if she gets flooded with too many pieces of information.

A common technique to deal with this problem is to provide only essential information but to allow the user to "show" more information usually represented by a short description.

That's what the MoinMoin macro SeeSaw is designed to do.

Applications

There are three main applications for this purpose:

The first application works "Inline", the other two on a "Section".

These three applications are demonstrated underneath.

Inline Usage

This line contains some »» text. Click on the link to show it.

Section Usage

Reveal Text

Show the details

This paragraph might contain a large amount of details only geeks might be interested in. This paragraph might contain a large amount of details only geeks might be interested in. This paragraph might contain a large amount of details only geeks might be interested in. This paragraph might contain a large amount of details only geeks might be interested in.

This paragraph might contain a large amount of details only geeks might be interested in. This paragraph might contain a large amount of details only geeks might be interested in. This paragraph might contain a large amount of details only geeks might be interested in. This paragraph might contain a large amount of details only geeks might be interested in. This paragraph might contain a large amount of details only geeks might be interested in. This paragraph might contain a large amount of details only geeks might be interested in. This paragraph might contain a large amount of details only geeks might be interested in.

  • Might contain all sorts of elements
  • Including lists

Reveal Code

Note that for including code, the SeeSaw code must be embraced not by three but by 4 curlies (={}). Only then APL code, which needs to be embraced by three curlies as well, will get recognized as such properly.

Show the code 

Prim←{{⍵/⍨2=+⌿0=⍵∘.|⍵}⍳⍵}

Toggle Text

Dyalog Section (show APLX section)

Some details related to Dyalog APL.
This is shown initially. It is hidden and the "APLX" section is displayed when "Show APLX section" is clicked.

APLX Section (Show Dyalog section)

Some details related to APLX.
This is hidden initially.

Conclusion

To hide complex parts of information is possible in two ways:

The former technique has it's merits, of course, but it comes with drawbacks as well: If the sub-pieces are relatively small but their total number is high, it might increase the number of pages dramatically. Not helpful at all when searching pages.

In those cases the hide/show technique represented here is certainly an alternative. The "Reveal" method would be appropriate for that.

The other techniques, however, are less usefull, but still...

Only it needs JavaScript: if the user has disabled it, the whole damn mechanism doesn't work.