Wiki source code of Writing XWiki Rendering Macros
Last modified by Vincent Massol on 2021/11/03 16:20
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | These tutorials explain how to implement XWiki Macros using XWiki's [[Rendering Architecture>>extensions:Extension.Rendering Module]]. | ||
| 2 | |||
| 3 | = Implementation Options = | ||
| 4 | |||
| 5 | XWiki Rendering macros can be written either in Java or directly in wiki pages: | ||
| 6 | |||
| 7 | * [[XWiki Rendering Macro in Java Tutorial>>Documentation.DevGuide.RenderingMacroTutorial]] | ||
| 8 | * [[XWiki Rendering Macro in Wiki page Tutorial>>Documentation.DevGuide.Tutorials.WritingMacros.WikiMacroTutorial.WebHome]] | ||
| 9 | |||
| 10 | = Comparison = | ||
| 11 | |||
| 12 | If you're wondering whether to write your Rendering Macro in Java or in a wiki page, the following table provides some comparison between both options. | ||
| 13 | |||
| 14 | |=Characteristics|=Java Macro|=Wiki Macro | ||
| 15 | |Easy to debug|(/)|(x) | ||
| 16 | |Easy to write an automated test for|(/)|(x) | ||
| 17 | |Optimized for performance|(/)|(x) | ||
| 18 | |Advanced parameter metadata support (advanced, deprecated, grouping)|(/)|(x) | ||
| 19 | |Doesn't require development skills|(x)|(/) | ||
| 20 | |Easy for a user to customize|(x)|(/) | ||
| 21 | |Fast to write and manually test|(x)|(/) |
