= TracIStan =

== Description ==

Interface for using Nevow Stan templates in Trac Plugins

== Bugs/Feature Requests == 

Existing bugs and feature requests for TraciStanPlugin are 
[report:9?COMPONENT=TraciStanPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=TraciStanPlugin&owner=pacopablo new ticket].

== Download ==

Download the zipped source from [download:tracistanplugin here].

== Source ==

You can check out TraciStanPlugin from [http://trac-hacks.org/svn/tracistanplugin here] using Subversion, or [source:tracistanplugin browse the source] with Trac.

== Example ==
TracIStan exposes the {{{IStanRequestHandler}}} and {{{IStanRenderer}}} interfaces so that the [http://divmod.org/trac/wiki/DivmodNevow Nevow] Stan templating system can be used in Trac plugins.

To use it:
 * implement the {{{IStanRequestHandler}}} and/or the {{{IStanRenderer}}} interfaces
 * Set template data in {{{req.standata}}}. Attention should be paid to possible existing values in the req.standata dictionary.  Thus, {{{req.standata.update()}}} should be used if filling {{{req.standata}}} from an existing dict.

The {{{IStanRequestHandler}}} is intentionally similar to the {{{IRequestHandler}}} interface.  The only difference is that data that should be available in the Stan template must be stored in the {{{req.standata}}} dictionary.

For a more detailed example, see the [source:tracistanplugin/0.10/example/aftracistan aftracistan] example in the example directory of the source.

To see what the example looks like, simply install both TraciStanPlugin in the aftracistan plugin and then visit the /aftracistan url.  The original template looks better because:
 * There are no trac header and footer
 * I'm having some CSS issues where the CSS from the template and Trac's CSS are fighting each other.  If anyone wants to improve the CSS that would be wonderful :)
The template used in the aftracistan example was done by [http://andreasviklund.com/ Andreas Viklund].  He makes nice templates.  Props to him.

== Recent Changes ==

[[ChangeLog(tracistanplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:pacopablo] [[BR]]
'''Contributors:'''