## Summary
This contrib packages in a convenient way the Javascript library and the CSS file needed to implement TWisty Sections.
See the [attached file](http://www.dementia.org/twiki//view/toggle-optm-jsoff-sep.html) for a demo and an example of usage.
To use the libraries, you must place the following scriplet either in the head section of the page (by modifying the [[TWikiSkins]]) or putting it somewhere in the topic:
It's recommended to use the TWiki:Plugins.TwistyPlugin, as it eases the deployment and use of this contrib.
%RED%Caution: If the previous scriplet is put in the HEAD section of the page or the TWiki:Plugins.TwistyPlugin is used, it won't work if the `` manager is set by the skin. Check the [twist.js](http://www.dementia.org/twiki//view/twist.js) file for an idea on how to register an eventmanager for the onload event without overwriting the previous one.%ENDCOLOR%
This Contrib should work in all versions of TWiki. It has been tested against TWiki:Codev.CairoRelease and TWiki:Codev.DakarRelease.
## Customization
Skins can customize the color of the twisty placeholder by modifiying the `.twistyPlaceholder` style.
## Settings
- Set SHORTDESCRIPTION = Twisty section javascript library to open/close content dynamically
- Set STUB = TWiki::Contrib::TwistyContrib
## Installation Instructions
- Download the ZIP file from the Plugin web (see below)
- Unzip **%TOPIC%.zip** in your ($TWIKI\_ROOT) directory. Content:
- Optionally, run **%TOPIC%\_installer** to automatically check and install other TWiki modules that this module depends on. You can also do this step manually.
- Alternatively, manually make sure the dependencies listed in the table below are resolved. None
## Demo & Text
If the contrib is properly installed (and Javascript is enabled in your browser!), then you should see some folding sections below. Look at [[http://www.dementia.org/twiki/view/%WEB%.%TOPIC%?raw=on|%WEB%.%TOPIC%?raw=on]] to see how it's done.
Click on the button above to fold this section.
[Expand...](#) Hamlet is without question the most famous play in the English language... [Collapse...](#)
Hamlet is without question the most famous play in the English language. Probably written in 1601 or 1602, the tragedy is a milestone in Shakespeare's dramatic development; the playwright achieved artistic maturity in this work through his brilliant depiction of the hero's struggle with two opposing forces: moral integrity and the need to avenge his father's murder.