close
Warning:
BrowserModule failed with ConfigurationError: Look in the Trac log for more information.
- Timestamp:
-
Feb 24, 2024, 4:07:16 PM (9 months ago)
- Author:
-
trac
- Comment:
-
--
Legend:
- Unmodified
- Added
- Removed
- Modified
-
v5
|
v6
|
|
1 | 1 | = Wiki Processors |
2 | 2 | |
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''. |
| 3 | Processors are WikiMacros that provide alternative markup formats for the [TracWiki Wiki engine]. Processors can be thought of as ''macro functions to process user-edited text''. |
4 | 4 | |
5 | 5 | Wiki processors can be used in any Wiki text throughout Trac, such as: |
6 | 6 | - [#CodeHighlightingSupport syntax highlighting] or for rendering text verbatim |
7 | | - rendering [#HTMLrelated Wiki markup inside a context], like inside <div> blocks or <span> or within <td> or <th> table cells |
8 | | - using an alternative markup syntax, like [WikiHtml raw HTML] and [WikiRestructuredText Restructured Text] or [http://www.textism.com/tools/textile/ textile] |
| 7 | - rendering [#HTMLrelated Wiki markup inside a context] such as <div> or <span> blocks or within <td> or <th> table cells |
| 8 | - using an alternative markup syntax, like [WikiHtml raw HTML] and [WikiRestructuredText Restructured Text] or [https://www.booked.net/textism.html textile] |
9 | 9 | |
10 | 10 | == Using Processors |
… |
… |
|
40 | 40 | {{{#!td colspan=2 align=center style="border: none" |
41 | 41 | |
42 | | __Example 1__: Inserting raw HTML |
| 42 | '''Example 1''': Inserting raw HTML |
43 | 43 | }}} |
44 | 44 | |----------------------------------------------------------------- |
… |
… |
|
60 | 60 | {{{#!td colspan=2 align=center style="border: none" |
61 | 61 | |
62 | | __Example 2__: Highlighted Python code in a <div> block with custom style |
| 62 | '''Example 2''': Highlighted Python code in a <div> block with custom style |
63 | 63 | }}} |
64 | 64 | |----------------------------------------------------------------- |
… |
… |
|
94 | 94 | {{{#!td colspan=2 align=center style="border: none" |
95 | 95 | |
96 | | __Example 3__: Searching tickets from a wiki page, by keywords. |
| 96 | '''Example 3''': Searching tickets from a wiki page, by keywords. |
97 | 97 | }}} |
98 | 98 | |----------------------------------------------------------------- |
… |
… |
|
155 | 155 | || '''`#!th`''' || Wrap wiki content inside a <th> element. (''since 0.12'') || |
156 | 156 | || '''`#!tr`''' || Can optionally be used for wrapping `#!td` and `#!th` blocks, either for specifying row attributes or better visual grouping. (''since 0.12'') || |
157 | | || '''`#!table`''' || Can optionally be used for wrapping `#!tr`, `#!td` and `#!th` blocks, for specifying table attributes. One current limitation however is that tables cannot be nested. (''since 0.12'') || |
| 157 | || '''`#!table`''' || Can optionally be used for wrapping `#!tr`, `#!td` and `#!th` blocks, for specifying table attributes. One current limitation however is that tables cannot be nested. (''since 0.12'') || |
158 | 158 | || || See WikiHtml for example usage and more details about these processors. || |
159 | 159 | |||| || |
160 | 160 | ||||= '''Other Markups''' =|| |
161 | 161 | || '''`#!rst`''' || Trac support for Restructured Text. See WikiRestructuredText. || |
162 | | || '''`#!textile`''' || Supported if [http://cheeseshop.python.org/pypi/textile Textile] is installed. See [http://www.textism.com/tools/textile/ a Textile reference]. || |
| 162 | || '''`#!textile`''' || Supported if [https://pypi.org/project/textile Textile] is installed. See [https://www.booked.net/textism.html a Textile reference]. || |
163 | 163 | |||| || |
164 | 164 | ||||= '''[=#CodeHighlightingSupport Code Highlighting Support]''' =|| |
165 | | || '''`#!c`''' [[BR]] '''`#!cpp`''' (C++) [[BR]] '''`#!python`''' [[BR]] '''`#!perl`''' [[BR]] '''`#!ruby`''' [[BR]] '''`#!php`''' [[BR]] '''`#!asp`''' [[BR]] '''`#!java`''' [[BR]] '''`#!js`''' (Javascript) [[BR]] '''`#!sql`''' [[BR]] '''`#!xml`''' (XML or HTML) [[BR]] '''`#!sh`''' (!Bourne/Bash shell) [[BR]] '''etc.''' [[BR]] || Trac includes processors to provide inline syntax highlighting for source code in various languages. [[BR]] [[BR]] Trac relies on [http://pygments.org Pygments] for syntax coloring. [[BR]] [[BR]] See TracSyntaxColoring for information about which languages are supported and how to enable support for more languages. || |
| 165 | || '''`#!c`''' [[BR]] '''`#!cpp`''' (C++) [[BR]] '''`#!python`''' [[BR]] '''`#!perl`''' [[BR]] '''`#!ruby`''' [[BR]] '''`#!php`''' [[BR]] '''`#!asp`''' [[BR]] '''`#!java`''' [[BR]] '''`#!js`''' (Javascript) [[BR]] '''`#!sql`''' [[BR]] '''`#!xml`''' (XML or HTML) [[BR]] '''`#!sh`''' (!Bourne/Bash shell) [[BR]] || Trac includes processors to provide inline syntax highlighting for source code in various languages. [[BR]] [[BR]] Trac relies on [http://pygments.org Pygments] for syntax coloring. [[BR]] [[BR]] See TracSyntaxColoring for information about which languages are supported and how to enable support for more languages. || |
166 | 166 | |||| || |
167 | 167 | |
… |
… |
|
271 | 271 | For more processor macros developed and/or contributed by users, visit the [https://trac-hacks.org Trac Hacks] community site. |
272 | 272 | |
273 | | Developing processors is no different from Wiki macros. In fact, they work the same way, only the usage syntax differs. See WikiMacros#DevelopingCustomMacros for more information. |
| 273 | Processors are implemented using the same interfaces as Wiki macros, only the usage syntax differs. To develop a processor, see WikiMacros#DevelopingCustomMacros. |
274 | 274 | |
275 | 275 | ---- |