Christopher Lenz wrote:
Note that if you remove the default wiki pages you'll have quite a number of broken links in Trac due to the help links pointing nowhere.

Cheers,
Chris
--

This problem of the default wiki is one I noticed when I first installed Trac back at about 0.7. I don't think the wiki is really the correct place for the Trac help files as they should not be editable. Also it becomes even more strange when you have multiple projects. Every upgrade of the Trac code (which has one install for all projects) requires you to individually update each of the projects with the latest default wiki pages to get the latest help. If someone has unwisely edited one of the help pages then their changes will be lost in the update.

I can understand how this situation arose as it is natural for the Trac guide etc to reside in a wiki on the Edgewall site. It is not natural for the Trac guide to reside on the wiki on any other Trac site.

I propose that the Trac guide and associated "default" wiki pages are converted to static HTML that is served out alongside the other static Trac content (ie the templates). The conversion should be an automatic part of the build process and the converter should be built into the Trac code itself, perhaps as part of trac-admin. A manual conversion would of course also be possible from the web interface too with a ui allowing the selection of a subset of pages to convert.

A side effect of this of course would be to add a feature to Trac to allow HTML documentation generation from the wiki! What a great feature.

Has anyone got any thoughts on this? Shall I lodge a feature request? Should I post this to the dev group too?

Regards,
Felix
_______________________________________________
Trac mailing list
[email protected]
http://lists.edgewall.com/mailman/listinfo/trac

Reply via email to