Meta Wiki: discussion about the Cloudy trac site
RSS feeds
The problem
The Timeline and New Tickets have RSS feeds available. However, the fact that they use https causes problems for some readers.
The solution
Will Henney has laundered the feeds by re-syndicating them through his Google Reader account. You can view them at this page, or use this Atom feed to subscribe to them in your favorite RSS reader. Since the laundered feed uses plain old http, it should work with any software. You can even use RSSfwd to have notifications sent to you email account.
Update
Google Reader seems to be very slow to update the feed. For instance, it is more than an hour since I last edited this page and the notification still hasn't showed up there.
How to improve the site navigation
Stage 1: ASCII mockups of what we want
See NewSiteNavigation.
Stage 2: implementation
Once Stage 1 is complete, we will need to code it up in html and stick it in templates/site_header.cs (requires root access to server).
Changing the look and feel
How to do this is described in TracInterfaceCustomization. At least the logo has now been changed, but Ryan implied that this needed root access, which was problematical. However, it seems that you can do a lot of customization using CSS, which can easily be prototyped by loading a personalised stylesheet into the browser, as I describe in CssPrototyping.
An example of a more extensive skinning of the interface is the Twisted site. A brief description of how to go about this is given here. Unfortunately, all these examples require the 0.11dev version of Trac, whereas we are still using 0.10.
Do we want to modify the use CamelCase links?
Will:
- I think activating the ignore_missing_pages option would be a good idea, so that camel case variable names won't get interpreted as wiki page links.
Plugins
What trac extensions do we want to have installed?
- Tags plugin
- latex math plugin (there were various options for this e.g. http://www.trac-hacks.org/wiki/LatexFormulaMacro, also might be useful to export to LaTeX)
- anything else?
Original Trac Wiki Intro (moved from the main page)
All aspects of Trac have been designed with the single goal to help developers write great software while staying out of the way and imposing as little as possible on a team's established process and culture.
As all Wiki pages, this page is editable, this means that you can modify the contents of this page simply by using your web-browser. Simply click on the "Edit this page" link at the bottom of the page. WikiFormatting will give you a detailed description of available Wiki formatting commands.
"trac-admin yourenvdir initenv" created a new Trac environment, containing a default set of wiki pages and some sample data. This newly created environment also contains documentation to help you get started with your project.
You can use trac-admin to configure Trac to better fit your project, especially in regard to components, versions and milestones.
TracGuide is a good place to start.
Enjoy!
The Trac Team
Starting Points
- TracGuide -- Built-in Documentation
- The Trac project -- Trac Open Source Project
- Trac FAQ -- Frequently Asked Questions
- TracSupport -- Trac Support
For a complete list of local wiki pages, see TitleIndex.
