[[PageOutline(2-5,Contents,pullout)]]

= Genshi Macro =

== Description ==

== Genshi processor for wiki pages ==

=== Description ===

The GenshiMacro allows you to write and render Genshi templates directly
in wiki pages with a new ``Genshi`` processor.

Your templates will have access to the request as ``req``, which can be
useful for tasks like URL generation, rendering form tokens for POST
requests, and checking for a logged-in user.

'''Note: no security considerations whatsoever went into the making of
this plugin.  It might be a terrible idea.  If you happen to know that
it is, please let me know.'''

=== Configuration and Usage ===

To use the plugin, install it in your Trac environment and enable its 
components in ``trac.ini``::

{{{
  [components]
  genshimacro.* = enabled
}}}

You can then write Genshi templates directly in wiki pages.


== Bugs/Feature Requests == 

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

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

== Download ==

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

== Source ==

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

== Example ==

{{{
#!html
  
  {{{
  #!Genshi
  <div xmlns:py="http://genshi.edgewall.org/">
   <py:choose>
    <py:when test="req.session.authenticated">
     <form method="POST" action="${req.href.newticket()}">
      <input type="text" name="field_summary" placeholder="My new ticket"
             id="field-summary" />
      <input type="hidden" name="__FORM_TOKEN" value="${req.form_token}" />
      <input type="submit" />
     </form>
    </py:when>
    <py:otherwise>
     <b>To file a new ticket, you'll need to
        <a href="${req.href.login()}">log in</a> or
        <a href="${req.href.register()}">create an account</a>
        first.</b>
    </py:otherwise>
   </py:choose>
  </div>  
  }}}

}}}

== Recent Changes ==

[[ChangeLog(genshimacro, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:ejucovy] [[BR]]
'''Maintainer:''' [wiki:ejucovy] [[BR]]
'''Contributors:'''