Details
-
Improvement
-
Resolution: Unresolved
-
Major
-
None
-
17.10.14, 18.8.0
-
None
-
Unknown
-
Description
Users look for a macro with the word they have in mind, which is often not its name: "callout" or "note" for a message box, "formula" or "latex" for MathJax, "columns" for Container, "subpages" for Children, "carousel" for Gallery. Quick Actions and the Insert Macro dialog only match the identifier, the name and the description of a macro, so these words give no result, and the user can conclude that XWiki has no such macro.
Steps to reproduce
- Edit a page with the WYSIWYG editor.
- Type /latex, then /equation, then /callout.
Expected
/latex and /equation list the MathJax macro first, and /callout lists the message macros.
Actual
/latex lists Template, and /equation and /callout list nothing.
The WYSIWYG usability audit of the macros found this on 51 of the 67 macros reviewed, nearly always for a common synonym.
Proposal
- Let a macro declare search keywords, translated like its name and description, for example with a rendering.macro.<id>.keywords translation key holding a comma separated list. Each language then gets its own words, and wiki macros can declare them the same way.
- Return the keywords with the name and description in the macro list of XWiki.WYSIWYG.MacroService, and match them in Quick Actions and in the filter of the Insert Macro dialog.
- The keywords of each macro of XWiki Standard are filled in separate issues, starting from the synonyms recorded by the audit.
Notes
- The Insert Macro dialog keeps the macros whose name or description contains the typed text, see filterMacros in macroSelector.js. Quick Actions runs a fuzzy search on the identifier, the name, the words of the description and the group, see the search configuration of the xwiki-slash plugin.
- Adding the synonyms to the descriptions would make them match, but it would make the descriptions longer and less useful as a summary of what the macro does.
Attachments
Issue Links
- is related to
-
XWIKI-25445 The message macros can't be found by their name in Quick Actions
-
- Open
-
- relates to
-
XWIKI-23119 Quick action doesn't find "Page tree" macro by typing pagetree
-
- Closed
-