|
close
Warning:
Can't synchronize with repository "(default)" (/hepforge/svn/tglaubermc does not appear to be a Subversion repository.). Look in the Trac log for more information.
- Timestamp:
-
Feb 27, 2012, 1:45:22 PM (13 years ago)
- Author:
-
trac
- Comment:
-
--
Legend:
- Unmodified
- Added
- Removed
- Modified
-
v1
|
v2
|
|
2 | 2 | [[TracGuideToc]] |
3 | 3 | |
4 | | Trac has a built-in wiki engine, used for text and documentation throughout the system. WikiFormatting is used in [wiki:TitleIndex wiki pages], [wiki:TracTickets tickets] and [wiki:TracChangeset check-in log messages]. This allows for formatted text and hyperlinks in and between all Trac modules. |
| 4 | Trac has a built-in wiki engine, used for text and documentation throughout the system. WikiFormatting is used in [wiki:TitleIndex wiki pages], [wiki:TracTickets tickets], [wiki:TracChangeset check-in log messages], [wiki:TracRoadmap milestone] and [wiki:TracReports report] descriptions. It allows for formatted text and hyperlinks in and between all Trac modules. |
5 | 5 | |
6 | | Editing wiki text is easy, using any web browser and a simple [WikiFormatting 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 [wiki:WikiHtml HTML], [wiki:WikiRestructuredText reStructuredText] and [http://www.textism.com/tools/textile/ Textile] as alternative markup formats. |
| 6 | Editing wiki text is easy, using any web browser and a simple [WikiFormatting 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 [WikiHtml HTML], [WikiRestructuredText reStructuredText] and [http://www.textism.com/tools/textile/ Textile] as alternative markup formats. |
7 | 7 | |
8 | | The main goal of the wiki is to make editing text easier and ''encourage'' people to contribute and annotate text content for a project. |
| 8 | The main goal of the wiki is to make editing text easier and ''encourage'' people to contribute and annotate text content for a project. Trac also provides a simple toolbar to make formatting text even easier, and supports the [http://universaleditbutton.org/Universal_Edit_Button universal edit button] of your browser. |
9 | 9 | |
10 | | 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. |
| 10 | 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. |
| 11 | As contributing to a wiki is essentially building an hypertext, |
| 12 | general advice regarding HTML authoring apply here as well. |
| 13 | For example, the ''[http://www.w3.org/Provider/Style Style Guide for online hypertext]'' explains how to think about the |
| 14 | [http://www.w3.org/Provider/Style/Structure.html overall structure of a work] |
| 15 | and how to organize information [http://www.w3.org/Provider/Style/WithinDocument.html within each document]. One of the most important tip is “make your HTML page such that you can read it even if you don't follow any links.” |
11 | 16 | |
12 | | For more help on editing wiki text, see these pages: |
13 | | * WikiFormatting |
14 | | * WikiPageNames |
15 | | * WikiNewPage |
16 | | * TracLinks |
17 | | * WikiMacros |
18 | | * WikiProcessors |
| 17 | Learn more about: |
| 18 | * WikiNewPage creation, which can be configured to start from a [PageTemplates page template] |
| 19 | * WikiFormatting rules, including advanced topics like WikiMacros and WikiProcessors |
| 20 | * How to use WikiPageNames and other forms of TracLinks which are used to refer in a precise way to any resource within Trac |
19 | 21 | |
20 | 22 | If you want to practice editing, please use the SandBox. |
21 | 23 | |
22 | | Some more information about wiki on the web: |
23 | | * http://wikipedia.org/wiki/Wiki |
24 | | * http://c2.com/cgi/wiki?WikiHistory |
25 | | * http://www.usemod.com/cgi-bin/mb.pl?WhyWikiWorks |
| 24 | Before saving your changes, you can ''Preview'' the page or ''Review the Changes'' you've made. |
| 25 | You can get an automatic preview of the formatting as you type when you activate the ''Edit Side-by-side'' mode. '' There is a [wiki:/TracIni#trac-section configurable delay] between when you make your edit and when the automatic preview will update.'' |
| 26 | |
| 27 | Some more information about wikis on the web: |
| 28 | * A definition of [http://wikipedia.org/wiki/Wiki Wiki], in a famous wiki encyclopedia |
| 29 | * The [http://c2.com/cgi/wiki?WikiHistory History] of the original wiki |
| 30 | * A wiki page explaining [http://www.usemod.com/cgi-bin/mb.pl?WhyWikiWorks why wiki works] |
26 | 31 | |
27 | 32 | ---- |
|