[[PageOutline(2-5,Contents,pullout)]]
= Create new hack infrastructure =

== Description ==

The NewHackMacro creates the infrastructure for a new hack on the TracHacks site.

It creates Subversion paths along with write permissions, adds a new component for the hack, and finally creates a wiki page based on a template wiki page (NewHackTemplate on this installation). The variables in that page are expanded by NewHackMacro.

== Disclaimer ==

NewHackMacro is not meant to be used outside TracHacks. Paths are hard-coded into the Macro, it is not cleanly designed, etc. Modification will be required for it to work correctly on a different site.

== Requirements ==

  1. The [http://dev.muness.textdriven.com/trac.cgi/wiki/tags tags hack].
  1. Pages tagged with [wiki:type type] will be displayed as the list of types (eg. [wiki:macro macro])
  1. Pages tagged with [wiki:release release] will be displayed as the list of releases (eg. [wiki:stable stable])
  1. Other tags '''not''' tagged with [wiki:metatag metatag] will be displayed in the list of additional tags (eg. [wiki:user user] pages will not be displayed, as [wiki:user user] is a [wiki:metatag metatag])

== Bugs/Feature Requests == 

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

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

== Download ==

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

== Source ==

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

== Example ==

Usage is simple:

{{{
[[NewHack(NewHackTemplate)]]
}}}

The page should be locked.

== Recent Changes ==

[[ChangeLog(newhackmacro, 3)]]


== Author/Contributors ==

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