[CAUSEWAY-2522] Tooling: for system-overview diagrams use SVG rather than PNG

• Type: Improvement
• Status: Resolved
• Priority: Minor
• Resolution: Resolved
• Fix Version/s: 2.0.0-M5
• Component/s: Docs & Website
• Assignee: Andi Huber
• Reporter: Andi Huber
• Created: 03/Feb/21 08:33
• Updated: 17/Feb/21 14:17
• Resolved: 17/Feb/21 14:17

Description

SVG is the only one that supports embedding of links (not used currently but could with future extensions)
also involves less traffic over the wire
looks better when rendered (unlimited scaling)

However, at the moment we use PNG.  That's because the lightbox support that is currently enabled only works for PNG files.  (You can see this if you navigate on https://apache-isis-committers.github.io/isis-nightly/system/latest/generated/system-overview.html and then click on the diagram).

Also, there is CSS styling to limit the width of diagrams, see for example the "Core" diagram (at https://apache-isis-committers.github.io/isis-nightly/system/latest/generated/system-overview.html#core ).  Again, if SVG is used then the CSS doesn't apply and the width of the diagram overflows into the margins.

So, basically we need to:

• revert the tooling so that it generates SVG rather than PNG diagrams (a one liner), but also
• fix up the current lightbox integration so that clicking on an SVG diagram shows in a popup, and
• fix up the CSS so that SVG diagrams do not overflow into the margins.