Changes between Version 2 and Version 3 of 0.12/WikiProcessors

Timestamp:

Jan 27, 2010, 3:17:00 PM (14 years ago)

Author:

Christian Boos

Comment:

minor fixes after review

0.12/WikiProcessors

@@ -3 +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''. 
 
-The Wiki engine uses processors for various different purposes, 
-and can be used in any Wiki text throughout Trac, for:
- - [#CodeHighlightingSupport syntax highlighting] or for rendering text verbatim
+Wiki processors can be used in any Wiki text throughout Trac,
+for various different purposes, like:
+ - [#CodeHighlightingSupport syntax highlighting] or for rendering text verbatim,
  - rendering [#HTMLrelated Wiki markup inside a context], 
-   like <div> blocks or <span>, or within <td> or <th> table cells
+   like inside <div> blocks or <span> or within <td> or <th> table cells,
  - using an alternative markup syntax, like [wiki:WikiHtml raw HTML] and
    [wiki:WikiRestructuredText Restructured Text],
@@ -42 +42 @@
 the style parameter, a quoted string can be used (`key="value with space"`).
 
-Note that some processors are meant to process Wiki markup,
-so in this case it's quite possible to ''nest'' processor blocks.
-You may indent the content of nested blocks for increased clarity,
-this extra indentation will be ignore when processing the content.
+As some processors are meant to process Wiki markup, it's quite possible to
+''nest'' processor blocks.
+You may want to indent the content of nested blocks for increased clarity,
+this extra indentation will be ignored when processing the content.
 
 
@@ -106 +106 @@
 }}}
 
-Note already at this point that HTML blocks have to be self-contained, 
-i.e. you can't start an HTML element in one block and close it later in a second block. Use [#element element] processors for achieving a similar effect. 
-More details on this in WikiHtml.
-
 
 == Available Processors ==
@@ -125 +121 @@
  `#!html`        :: Insert custom HTML in a wiki page.
  `#!htmlcomment` :: Insert an HTML comment in a wiki page (''since 0.12'').
+
+Note that `#!html` blocks have to be ''self-contained'',
+i.e. you can't start an HTML element in one block and close it later in a second block. Use the following processors for achieving a similar effect. 
 
   `#!div` :: Wrap an arbitrary Wiki content inside a <div> element
@@ -152 +151 @@
  `#!c` (C), `#!cpp` (C++), `#!python` (Python), `#!perl` (Perl), 
  `#!ruby` (Ruby), `#!php` (PHP), `#!asp` (ASP), `#!java` (Java), 
- `#!js` (Javascript), `#!sql (SQL)`, `#!xml` (XML or highlighted HTML),
+ `#!js` (Javascript), `#!sql (SQL)`, `#!xml` (XML or HTML),
  `#!sh` (Bourne/Bash shell), etc.