Version 3 (modified by 14 years ago) ( diff ) | ,
---|
This page documents the 0.12 release. Documentation for other releases can be found here.
The Trac Wiki Engine
Table of Contents
Trac has a built-in wiki engine, used for text and documentation throughout the system. WikiFormatting is used in wiki pages, tickets and check-in log messages. This allows for formatted text and hyperlinks in and between all Trac modules.
Editing wiki text is easy, using any web browser and a simple formatting system, rather than more complex markup languages like HTML. The reasoning behind its design is that HTML, with its large collection of nestable tags, is too complicated to allow fast-paced editing, and distracts from the actual content of the pages. Note though that Trac also supports HTML, reStructuredText and Textile as alternative markup formats.
The main goal of the wiki is to make editing text easier and encourage people to contribute and annotate text content for a project.
The wiki itself does not enforce any structure, but rather resembles a stack of empty sheets of paper, where you can organize information and documentation as you see fit, and later reorganize if necessary. As contributing to a wiki is essentially building an hypertext, general advices regarding HTML authoring apply here as well. For example, the Style Guide for online hypertext explains how to think about the Overall structure of a work and how to organize information Within each document. One of the most important advice is “make your HTML page such that you can read it even if you don't follow any links.”
Learn more about:
- WikiNewPage creation, eventually starting from PageTemplates
- WikiFormatting rules, including advanced topics like WikiMacros and WikiProcessors
- How to write WikiPageNames and other forms of TracLinks which can be used to refer in a precise way to any resource within Trac
If you want to practice editing, please use the SandBox.
Some more information about wikis on the web:
- A definition of Wiki, in a famous wiki encyclopedia
- The History of the original wiki
- A wiki page explaining why wiki works
See also: TracGuide