wiki:WikiStart

Version 149 (modified by rjollos, 21 months ago) (diff)

Migrated from TracBlogPlugin to FullBlogPlugin.

trac-hacks organization on GitHub

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 th-users@lists.trac-hacks.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.


  1. 1. If you've not yet created a page on trac-hacks.org for your plugin hosted on GitHub, you can do so now through the NewHack page. The external tag should be added to plugins hosted outside of trac-hacks.
  2. 2. An inquiry has been sent to GitHub and this post will be updated when a reply is received

trac-hacks.org is moving

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.

Uptime Report for trac-hacks.org: Last 30 days

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.

XML-RPC interface is back

The XML-RPC interface to trac-hacks.org, made possible by the XmlRpcPlugin, is available once again. Anonymous users can access through http://trac-hacks.org/rpc, and authenticated requests can be made through https://trac-hacks.org/login/rpc.

NewHack is back!

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!

Thanks to Michael Renzmann (otaku42) for creating the new version of the TracHacksPlugin, and to Jun Omae (jun66j5) for fixing many issues and making it compatible with Trac 1.0.

If you spot any issues, please let us know by opening a ticket.

We're proudly announcing the arrival of Trac 1.0.1 (current stable) at this site. Bear with us for a number of rough edges. Most will be gone by next week. Hope to see you continuing to unleash the power of your Trac plugin development enthusiasm.

-- osimons, otaku42, rjollos, hasienda from the current Trac-Hacks.org admin group

Welcome to Trac Hacks

The purpose of TracHacks is to provide free Subversion hosting for community created Trac hacks.

TracHacks uses the excellent TagsPlugin, which adds basic categorisation to Trac. All hacks are tagged with one or more of the available tags?.

How to Contribute

I've tried to make this as simple as possible:

  1. Register? a user name then login? (requires cookies).
  2. Fill out the NewHack form.
  3. Verify all the details for your new page are correct.
  4. 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)
  5. Have a look at TracHackDevelopment.
  6. 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.

Once you have created your page, tag it with the hack type and it will appear on the front page. Tag it with your TracHacks user id if you want it to show up on your user page.

How to Adopt Unmaintained Hacks

See AdoptingHacks.

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.

Request-a-Hack

Have a look at the RequestaHack page for features that people request.

Hacks

integration
macro

Macros are simple enhancements to Trac's Wiki engine. Examples include SubWiki, TOC, FootNote, etc.

patch

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.

plugin

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.

script

Scripts that enhance the functionality of Trac. This could include things like wrappers around creation of Subversion and Trac projects, post-commit hooks, etc.

theme

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.

translation

Translations of Trac into other languages.

workflow

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.

Miscellany

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.

Registered users of TracHacks.

Hacks for Trac 0.8, 0.9 and 0.10.

Example hacks.

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, IncludeMacro, IniAdminPlugin, NewHackMacro, NewsFlashMacro, PollMacro, RefMacro, SpamFilterPlugin, SvnAuthzAdminPlugin, TagsPlugin, TicketChangePlugin, TicketDeletePlugin, TocMacro, TracBlogPlugin, TracHacksPlugin, TracPygmentsPlugin, TracRedirect, WebAdminPlugin and XmlRpcPlugin.

Tag Cloud

The tag cloud is a visual representation of tag frequency, similar to a histogram.

I'm linking to the tag index? to reduce system load.