Edgewall Software

Changes between Version 21 and Version 22 of WikiMacros


Ignore:
Timestamp:
Dec 14, 2006, 6:07:10 PM (17 years ago)
Author:
Christian Boos
Comment:

Note about old-style macros being deprecated in 0.10 and not supported anymore in 0.11

Legend:

Unmodified
Added
Removed
Modified
  • WikiMacros

    v21 v22  
    3232
    3333== Developing Custom Macros ==
    34 Macros, like Trac itself, are written in the [http://www.python.org/ Python programming language]. They are very simple modules, identified by the filename and should contain a single `execute()` function. Trac will display the returned data inserted into the HTML representation of the Wiki page where the macro is called.
     34Macros, like Trac itself, are written in the [http://www.python.org/ Python programming language].
     35
     36Since version 0.9, wiki macros can also be written as TracPlugins. This gives them some capabilities that “classic” macros do not have, such as being able to directly access the HTTP request.
     37
     38For more information about developing macros, see the [http://projects.edgewall.com/trac/wiki/TracDev development resources] on the main project site.
     39
     40=== Old Style Macros ===
     41''Note: this is still supported in [trac:milestone:0.10], but deprecated.
     42Support for old style macros has been removed in [trac:milestone:0.11].''
     43
     44They are very simple modules, identified by the filename and should contain a single `execute()` function. Trac will display the returned data inserted into the HTML representation of the Wiki page where the macro is called.
    3545
    3646It's easiest to learn from an example:
     
    5060}}}
    5161
    52 Note that since version 0.9, wiki macros can also be written as TracPlugins. This gives them some capabilities that “classic” macros do not have, such as being able to directly access the HTTP request.
    53 
    54 For more information about developing macros, see the [http://projects.edgewall.com/trac/wiki/TracDev development resources] on the main project site.
    55 
    5662----
    5763See also:  WikiProcessors, WikiFormatting, TracGuide