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

= Plugin to render Genshi templates directly in wiki pages

{{{#!box warn 
**Notice:** This plugin has not been developed with security considerations in mind.
}}} 

== 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. If you happen to know how it can be improved, please let me know.'''

== 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 [https://github.com/ejucovy/trac-GenshiMacro/tags here].

== Source

You can clone GenshiMacro from [git://github.com/ejucovy/trac-GenshiMacro.git here] using Git, or [https://github.com/ejucovy/trac-GenshiMacro browse the source] with Github.

== 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.

== Example

{{{
  
  {{{
  #!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:''' [[Maintainer]] [[BR]]
'''Contributors:'''