Edgewall Software

Changes between Version 31 and Version 32 of TracWiki


Ignore:
Timestamp:
Dec 8, 2015, 10:45:15 AM (8 years ago)
Author:
figaro
Comment:

Cosmetic changes

Legend:

Unmodified
Added
Removed
Modified

  • TracWiki

    v31 v32  
    33[[TranslatedPages]]
    44
    5 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.
     5Trac 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, so 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.
    66It allows for formatted text and hyperlinks in and between all Trac modules.
    77
    8 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”).
     8Editing 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 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.
    99
    1010The 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.
    1111
    1212The 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.
    13 As contributing to a wiki is essentially building hypertext,
    14 general advice regarding HTML authoring apply here as well.
    15 For example, the ''[http://www.w3.org/Provider/Style Style Guide for online hypertext]'' explains how to think about the
    16 [http://www.w3.org/Provider/Style/Structure.html overall structure of a work]
    17 and how to organize information [http://www.w3.org/Provider/Style/WithinDocument.html within each document]. One of the most important tips is “make your HTML page such that you can read it even if you don't follow any links.”
     13As contributing to a wiki is essentially building hypertext, general advice regarding HTML authoring apply here as well.
     14For example, the ''[http://www.w3.org/Provider/Style Style Guide for online hypertext]'' explains how to think about the [http://www.w3.org/Provider/Style/Structure.html overall structure of a work] and how to organize information [http://www.w3.org/Provider/Style/WithinDocument.html within each document]. One of the most important tips is to "make your HTML page such that you can read it, even if you don't follow any links".
    1815
    1916Learn more about:
    20  * WikiFormatting rules, including advanced topics like WikiMacros and WikiProcessors
    21  * How to use WikiPageNames and other forms of TracLinks which are used to refer in a precise way to any resource within Trac
     17 * WikiFormatting rules, including advanced topics like WikiMacros and WikiProcessors.
     18 * How to use WikiPageNames and other forms of TracLinks which are used to refer in a precise way to any resource within Trac.
    2219
    23 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.
     20If you want to practice editing, please use the SandBox. Note that not all Trac wiki pages are editable by anyone, this depends on the local policy; check with your Trac administrators.
    2421
    25 Before saving your changes, you can ''Preview'' the page or ''Review the Changes'' you've made.
    26 You can get an automatic preview of the formatting as you type when you activate the ''Edit Side-by-side'' mode (you have to Preview the page for the setting to take effect). '' There is a [wiki:/TracIni#trac-section configurable delay] between when you make your edit and when the automatic preview will update.''
     22Before saving your changes, you can ''Preview'' the page or ''Review the Changes'' you have made.
     23You can get an automatic preview of the formatting as you type when you activate the ''Edit Side-by-side'' mode (you have to Preview the page for the setting to take effect). There is a [wiki:/TracIni#trac-section configurable delay] between when you make your edit and when the automatic preview will update.
    2724
    2825Some more information about wikis on the web:
    29  * A definition of [http://wikipedia.org/wiki/Wiki Wiki], in a famous wiki encyclopedia
    30  * The [http://c2.com/cgi/wiki?WikiHistory History] of the original wiki
    31  * A wiki page explaining [http://www.usemod.com/cgi-bin/mb.pl?WhyWikiWorks why wiki works]
     26 * A definition of [http://wikipedia.org/wiki/Wiki Wiki] according to Wikipedia.
     27 * The [http://c2.com/cgi/wiki?WikiHistory history] behind the original wiki.
     28 * A wiki page explaining [http://www.usemod.com/cgi-bin/mb.pl?WhyWikiWorks why wiki works].
    3229
    3330----