Changes between Version 25 and Version 26 of TracWiki

Timestamp:

Mar 1, 2011, 7:45:23 PM (13 years ago)

Author:

Christian Boos

Comment:

note that not all wikis are editable by anyone, plus minor rephrasing

TracWiki

@@ -1 +1 @@
 ** Note: this page documents the 0.12 version of Trac, see [[0.11/TracWiki]] if you need the previous version **
 
-= The Trac Wiki Engine =
+= The Trac Wiki System =
 [[TracGuideToc]]
 [[TranslatedPages]]
 
-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.
+Trac has a built-in wiki system which you can use for organizing knowledge and information in a very flexible way by [WikiNewPage creating pages] containing an intuitive and easy to learn textual markup. This text markup is also used in all other parts of the system, not only in [wiki:TitleIndex wiki pages], but also in [wiki:TracTickets ticket] description and comments, [wiki:TracChangeset check-in log messages], [wiki:TracRoadmap milestone] descriptions and [wiki:TracReports report] descriptions, even in third-party extensions.
+It allows for formatted text and hyperlinks in and between all Trac modules.
 
-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.
+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, which can eventually be used in parts of a page (so called wiki “blocks”).
 
 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.
@@ -19 +20 @@
 
 Learn more about:
- * WikiNewPage creation, which can be configured to start from a [PageTemplates page template]
  * WikiFormatting rules, including advanced topics like WikiMacros and WikiProcessors
  * How to use WikiPageNames and other forms of TracLinks which are used to refer in a precise way to any resource within Trac
 
-If you want to practice editing, please use the SandBox.
+If you want to practice editing, please use the SandBox. Note that not all Trac wikis are editable by anyone, this depends on the local policy; check with your Trac administrators.
 
 Before saving your changes, you can ''Preview'' the page or ''Review the Changes'' you've made.
@@ -29 +29 @@
 
 Some more information about wikis on the web:
- * A definition of [http://wikipedia.org/wiki/Wiki Wiki], in a famous  wiki encyclopedia
+ * A definition of [http://wikipedia.org/wiki/Wiki Wiki], in a famous wiki encyclopedia
  * The [http://c2.com/cgi/wiki?WikiHistory History] of the original wiki
  * A wiki page explaining [http://www.usemod.com/cgi-bin/mb.pl?WhyWikiWorks why wiki works]