Wiki source code of Writing XWiki Rendering Macros
Last modified by Vincent Massol on 2021/11/03
Hide last authors
author | version | line-number | content |
---|---|---|---|
11.5 | 1 | These tutorials explain how to implement XWiki Macros using XWiki's [[Rendering Architecture>>extensions:Extension.Rendering Module]]. | |
10.1 | 2 | ||
17.2 | 3 | = Implementation Options = | |
4 | |||
16.1 | 5 | XWiki Rendering macros can be written either in Java or directly in wiki pages: | |
2.1 | 6 | ||
13.4 | 7 | * [[XWiki Rendering Macro in Java Tutorial>>Documentation.DevGuide.RenderingMacroTutorial]] | |
14.1 | 8 | * [[XWiki Rendering Macro in Wiki page Tutorial>>Documentation.DevGuide.Tutorials.WritingMacros.WikiMacroTutorial.WebHome]] | |
17.1 | 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) | ||
17.4 | 16 | |Easy to write an automated test for|(/)|(x) | |
17.8 | 17 | |Optimized for performance|(/)|(x) | |
18.2 | 18 | |Advanced parameter metadata support (advanced, deprecated, grouping)|(/)|(x) | |
17.6 | 19 | |Doesn't require development skills|(x)|(/) | |
17.1 | 20 | |Easy for a user to customize|(x)|(/) | |
17.9 | 21 | |Fast to write and manually test|(x)|(/) | |
17.1 | 22 |