|Version 153 (modified by rjollos, 23 months ago) (diff)|
trac-hacks.org has the foremost aims of facilitating collaboration among the community of Trac plugin developers and easing the process of locating plugins for Trac. As GitHub has become more popular for hosting open source projects a greater number of plugins for Trac can be found on that site. Some of those plugins also have a page on trac-hacks.org, but many do not1.
In order to make it easier to locate Trac plugins on GitHub, a trac-hacks organization has been created. Several users have already moved their plugins to the organization and invites are being sent to authors of original plugins hosted on GitHub.
Users that move their repositories to the trac-hacks.org organization retain full administrative control over their repositories. Besides greater visibility to your project, the primary advantage to moving your project to the organization is that the trac-hacks administrators team can help your project find a new maintainer if you should choose to no longer continue developing the project.
All interested GitHub users may join the organization, regardless of whether you are currently developing a plugin. It isn't obvious how an invite can be requested from the organization page2, so if you'd like to join please reply here or send a message to firstname.lastname@example.org.
If there's something trac-hacks.org can do better, please let the community know by commenting here, or in the discussion on the trac-dev mailing list.
In the coming months trac-hacks.org will be moved to a new server, which should provide better availability and performance than the existing hosting. At the moment we continue to experience intermittent but brief downtime, and slow site performance, which we are aiming to resolve with this move.
Edgewall, which created and continues to host Trac, Genshi and Babel has generously offered to provide the hosting for trac-hacks.org. From a user standpoint, nothing will change except for an improved experience in accessing the site. Hosting by Edgewall should ensure that trac-hacks.org remains available with free hosting for Trac plugins for a long time to come.
Following the site move, the trac-hacks.org admin team can start focusing on more improvements to the site, so stay tuned! Please don't hesitate to comment if you have any questions or concerns.
The NewHack tab is once again available to logged-in users, allowing new hacks to be published to the site. This feature has been unavailable since the site upgrade in June 2013. Sorry for its long absence!
If you spot any issues, please let us know by opening a ticket.
Welcome to Trac Hacks
How to Contribute
I've tried to make this as simple as possible:
- Register a user name then login (requires cookies).
- Fill out the NewHack form.
- Verify all the details for your new page are correct.
- Commit your code to the provided Subversion URL
(alternatively you can simply attach your hack to your Wiki page, ala MacroBazaar, but remember that you can't delete or replace attachments)
- Have a look at TracHackDevelopment.
- Consider subscribing to the trac-hacks mailing list.
The TracHacks page contains more information, contact details, bug reports, enhancements, suggestions, etc.
I host my own hack elsewhere
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. GanttPlugin)
eg. The DoStuff macro would become the page DoStuffMacro.
How to Adopt Unmaintained Hacks
How do I install these things?
Refer to the Trac plugin documentation and the MacroBazaar for details on how to build and install plugins and macros, respectively. For other types please refer to the page of the hack you are installing for instructions.
Have a look at the RequestaHack page for features that people request.
Macros are simple enhancements to Trac's Wiki engine. Examples include SubWiki, TOC, FootNote, etc.
Modifications to the Trac source in the form of patches. This can include simple changes to Clear Silver templates, patches to the Python code,etc.
As part of the move to a component architecture, Trac 0.9 is now extensible via plugins. Plugins can be used to add functionality to Trac that was not previously possible without extensive modification to the source. This could include anything from extended milestone facilities, multi-project functionality, integration of automated build systems, other link types, to simple macros.
Refer to the Trac documentation for installation instructions and more information.
Scripts that enhance the functionality of Trac. This could include things like wrappers around creation of Subversion and Trac projects, post-commit hooks, etc.
Themes are modifications to the visual layout and style of Trac. They can be anything from just CSS changes, to full templates with additional images and styles.
Trac 0.11 introduces the customizable TracWorkflow. Here are some you might find useful:
Feedback and Suggestions
Please consider subscribing to the th-users mailing list.
The list is meant for discussion about trac-hacks.org, i.e. the services that are provided here for the Trac community. Use it to suggest new features, discuss ways to improve the website, report issues that you come across, stuff like this. Any feedback is highly appreciated.
Please note however that th-users is not meant for support requests for any of the plugins provided on trac-hacks.org by their authors. These should still be directed to the trac-users mailing list instead.
We have defined some shortcuts for commonly used links, such as download:hackname, google:search, trac:wikipage, trac-changeset:changeset and trac-ticket:ticket. See InterMapTxt for a complete list.
Adhering to the principle that one should
eat one's own dog food,
the following hacks are used on TracHacks:
AccountManagerPlugin, AcronymsPlugin, AutoWikifyPlugin, ChangeLogMacro, EmailProcessorMacro, FootNoteMacro, FullBlogPlugin, IncludeMacro, IniAdminPlugin, NewHackMacro, NewsFlashMacro, PollMacro, SpamFilterPlugin, SvnAuthzAdminPlugin, TagsPlugin, TocMacro, TracHacksPlugin, TracRedirect, VotePlugin, and XmlRpcPlugin.