| 1 | [[PageOutline(2-5,Content)]] |
| 2 | |
| 3 | = Hack Procedures = |
| 4 | The TracHacks page contains more information, contact details, bug reports, enhancements, suggestions, etc. |
| 5 | |
| 6 | == How to Contribute == |
| 7 | |
| 8 | We've tried to make this as simple as possible: |
| 9 | |
| 10 | 1. [/register Register] a user name then [/login login] (requires cookies). |
| 11 | 1. Fill out the NewHack form. |
| 12 | 1. Verify all the details for your new page are correct. |
| 13 | 1. Commit your code to the provided Subversion URL[[BR]]''(alternatively you can simply attach your hack to your Wiki page, ala MacroBazaar, but remember that you can't delete or replace attachments)'' |
| 14 | 1. Consider subscribing to the [wiki:WikiStart#FeedbackandSuggestions trac-hacks mailing list]. |
| 15 | |
| 16 | === List Your Own Hack Hosted Elsewhere === |
| 17 | |
| 18 | Feel free to create a stub page here with a short description and links to your own hack. Please stick to the page naming convention, by appending the hack type (eg. '''Gantt''Plugin'''''). Therefore the !DoStuff macro should get a page named `DoStuffMacro`. |
| 19 | |
| 20 | Once you have created your page, tag it with the hack type and it will appear on the HackIndex. Tag it with your TracHacks [wiki:user] ID, if you want it to show up on your user page. |
| 21 | |
| 22 | === Adopt Unmaintained Hacks === |
| 23 | |
| 24 | See AdoptingHacks. |
| 25 | |
| 26 | == How to Use Tags == |
| 27 | |
| 28 | TracHacks uses TagsPlugin to add basic categorisation to its Trac content. |
| 29 | |
| 30 | === Meta-tags === |
| 31 | |
| 32 | Additionally, TracHacks uses a couple of [wiki:metatag metatags] when creating new hacks; [wiki:release release] and [wiki:type type]. |
| 33 | |
| 34 | '''''Please don't abuse this.''''' |
| 35 | |
| 36 | If a tag page (eg. [wiki:macro macro]) is itself tagged with one of the meta-tags, it will be included as an option in NewHack. That's quite a confusing sentence, so just take a look at [wiki:type type] for an example. |
| 37 | |
| 38 | == Site-specific TracLinks == |
| 39 | |
| 40 | We have defined some shortcuts for commonly used links, such as `download:hackname`, `google:search`, `trac:wikipage`, `trac-changeset:changeset` and `trac-ticket:ticket`. Use these TracLinks for your convenience (see [wiki:InterMapTxt] for a complete list). |
| 41 | |
| 42 | Examples: |
| 43 | * [wiki:user Registered users] of TracHacks |
| 44 | * Hacks for Trac [wiki:0.8], [wiki:0.9] and [wiki:0.10] |
| 45 | * [wiki:example Example] hacks |
| 46 | |
| 47 | ---- |
| 48 | See also: TracHacks, HacksQandMaintenance |