Skip to content

Separate Confluence bridges from XWiki SAS's own Pro macros #277

@snazare

Description

@snazare

Currently in the pro macros package we have 19 macros that are supposed to be bridges, used only in the context of the migration. 4 of these are prefixed by "confluence_" and 15 are not. This is an issue due to the following reasons:

  • it clutters / takes away from XWiki's own macro namespace
  • it is confusing for end users as the separation between macros that should be used only in the context of a migration and macros that are generic is not clear

Proposal: we could split the pro macros into two sub modules, one "confluence bridges" and one "generic editing macros".

Generic macros that can be used in any context:

  1. column
  2. content report table
  3. contributors
  4. excerpt
  5. excerpt include
  6. expand
  7. microsoftstream
  8. profile-picture
  9. recently-updated
  10. section
  11. userlister
  12. view-file

Confluence bridge macros that should be prefixed with 'confluence_' and not used as standalone macros after the migration:

  1. anchor - existing xwiki native "id" macro, we already convert it to id during conversions but we also have an unprefixed bridge
  2. [already prefixed] attachments - same content available in default attachments tab
  3. balsamiq - old xwiki integration existed. We should improve that one if requested.
  4. [already prefixed] children - existing xwiki native macro
  5. [already prefixed] gallery - existing xwiki native macro
  6. drawio - existing xwiki native diagram app
  7. gliffy - existing xwiki native diagram app
  8. layout
  9. mathblock - existing mathjax macro
  10. mathblock reference - existing mathjax macro
  11. mathinline - existing mathjax macro
  12. mockup - existing xwiki native diagram app
  13. multimedia - existing xwiki native functionality
  14. note - existing xwiki native functionality
  15. pagetree - existing xwiki native documenttree macro
  16. paste code - existing xwiki native code macros
  17. time - existing xwiki native date macro
  18. tip - existing xwiki native success macro

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions