- Timestamp:
-
Oct 22, 2006, 2:09:07 PM (17 years ago)
- Author:
-
trac
- Comment:
-
--
Legend:
- Unmodified
- Added
- Removed
- Modified
-
v1
|
v2
|
|
1 | 1 | = Wiki Processors = |
2 | | Processors are WikiMacros designed to provide alternative markup formats for the Trac Wiki engine. Processors can be thought of as ''macro functions to process user-edited text''. |
3 | 2 | |
4 | | The wiki engine uses processors to allow using [wiki:WikiRestructuredText Restructured Text] and [wiki:WikiHtml raw HTML] in any wiki text throughout Trac. |
| 3 | Processors are WikiMacros designed to provide alternative markup formats for the [TracWiki Wiki engine]. Processors can be thought of as ''macro functions to process user-edited text''. |
| 4 | |
| 5 | The Wiki engine uses processors to allow using [wiki:WikiRestructuredText Restructured Text], [wiki:WikiHtml raw HTML] and [http://www.textism.com/tools/textile/ textile] in any Wiki text throughout Trac. |
| 6 | |
5 | 7 | |
6 | 8 | == Using Processors == |
7 | | To use a processor on a block of text, use a wiki blockquote, selecting a processor by name using ''shebang notation'' (#!), familiar to most UNIX users from scripts. |
| 9 | |
| 10 | To use a processor on a block of text, use a Wiki code block, selecting a processor by name using ''shebang notation'' (#!), familiar to most UNIX users from scripts. |
8 | 11 | |
9 | 12 | '''Example 1''' (''inserting raw HTML in a wiki text''): |
… |
… |
|
79 | 82 | * '''html''' -- Insert custom HTML in a wiki page. See WikiHtml. |
80 | 83 | * '''rst''' -- Trac support for Restructured Text. See WikiRestructuredText. |
81 | | * '''textile''' -- Supported if [http://dealmeida.net/projects/textile/ Textile] is installed. |
| 84 | * '''textile''' -- Supported if [http://dealmeida.net/projects/textile/ Textile] is installed. See [http://hobix.com/textile/ a Textile reference]. |
| 85 | |
| 86 | Textile link above is rotten. [http://www.textism.com/tools/textile/ this one] works, allows to test example. |
82 | 87 | |
83 | 88 | === Code Highlighting Support === |
… |
… |
|
111 | 116 | |
112 | 117 | == Advanced Topics: Developing Processor Macros == |
113 | | Developing processors is no different than WikiMacros. In fact they work the same way, only the usage syntax differs. See WikiMacros for more information. |
| 118 | Developing processors is no different from WikiMacros. In fact they work the same way, only the usage syntax differs. See WikiMacros for more information. |
114 | 119 | |
115 | 120 | '''Example:''' (''Restructured Text Processor''): |
116 | 121 | {{{ |
| 122 | #!python |
117 | 123 | from docutils.core import publish_string |
118 | 124 | |
|