Wiki source code of Ways to Insert a Macro
Last modified by superadmin on 2026/10/14 18:26
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Every editor inserts a Macro for you: it lists the Macros installed on the wiki, asks you for the parameters, and writes the resulting [[Macro call>>doc:documentation.xs.user.rendering-macros.WebHome]] into the Page. Which route you take follows from the editor you are editing the Page with. | ||
| 2 | |||
| 3 | |=Editor|=How a Macro is inserted|=Procedure | ||
| 4 | |[[WYSIWYG editor>>documentation.xs.user.base.page.edit.edit-standalone-wysiwyg-editor.WebHome]], the default one, in place or standalone|Through a dialog listing the Macros and their parameters|[[Insert a Macro with the WYSIWYG Editor>>doc:documentation.xs.user.base.page.edit.edit-standalone-wysiwyg-editor.insert-macro.WebHome]] | ||
| 5 | |[[BlockNote editor>>doc:documentation.xs.user.base.page.edit.blocknote-editor.WebHome]], where an administrator has installed it|Through the same dialog, opened from the slash menu|[[Insert a Macro with the BlockNote Editor>>doc:documentation.xs.user.base.page.edit.blocknote-editor.insert-macro.WebHome]] | ||
| 6 | |[[Wiki editor>>documentation.xs.user.base.page.edit.edit-wiki-editor.WebHome]]|By typing the Macro call yourself, in the Page syntax|[[Edit a Page with the Wiki Editor>>doc:documentation.xs.user.base.page.edit.edit-wiki-editor.WebHome]], with the [[Syntax>>xwiki:Documentation.UserGuide.Features.XWikiSyntax]] reference | ||
| 7 | |||
| 8 | == The Route Is Not Stored == | ||
| 9 | |||
| 10 | A Page records the Macro call alone, not the editor that wrote it, so the routes above are interchangeable: a Macro typed by hand in the Wiki editor is displayed as a Macro by the WYSIWYG editor, and one inserted through a dialog is a plain Macro call again in the Wiki editor. | ||
| 11 | |||
| 12 | {{plantuml}} | ||
| 13 | @startuml | ||
| 14 | !theme bluegray | ||
| 15 | skinparam nodesep 30 | ||
| 16 | skinparam ranksep 45 | ||
| 17 | |||
| 18 | rectangle "WYSIWYG editor" as W | ||
| 19 | rectangle "BlockNote editor" as B | ||
| 20 | rectangle "Wiki editor" as K | ||
| 21 | file "The Macro call stored in the Page" as C | ||
| 22 | |||
| 23 | W --> C : dialog | ||
| 24 | B --> C : dialog | ||
| 25 | K --> C : typed | ||
| 26 | @enduml | ||
| 27 | {{/plantuml}} |
