How to create diagrams in XWiki

02 Sep 2019 5 min read
Written by Silvia Macovei, Head of Cloud Business

Article updated on 28 August, 2024. 💡

Diagrams are great for easily conveying ideas visually.

They’re useful for both...

  • communicating the big picture with ease 🖼
  • breaking down complex concepts 🔎

With the right tool, diagramming becomes easy.

The XWiki Pro Diagram app provides a clean user interface, based on the jgraph/draw.io integration. Draw.io is a web-based open source diagramming software for creating wireframes, mockups, UML, charts, BPMN, mind maps, network diagrams and much more.

Features 💫

  • Simple interface so that new users can quickly jump in and start using the app.
  • Edit and view diagrams straight in your wiki.
  • Each diagram is stored in a wiki page.
  • The revisions of the diagrams are synced in XWiki.
  • Quickly import already existent diagrams.
  • Create diagram links to wiki pages and external links. 
  • Include diagrams in other wiki pages with ease.


Detailed diagram made in XWiki's Diagram app


Update 

Starting with the v1.20.5 release of the Diagram Pro Application you get to enable the multiple pages diagram feature.

How to try it

To try the app you can install it directly from your instance using the Extension Manager.

You only need a few minutes to master the basics.

You may already have access to it 🎁

Already an XWiki SAS customer?

The good news is that with XWiki Cloud or XWiki Pro on premises, starting with the Silver level, you benefit from support for all the Pro Apps and the XWiki core product. This includes the Diagram App.

The same benefit applies for the Confluence Migrator Pro starting from the Gold level.

Please get in touch with our support team and they will send you a free license.

We kept our promise and starting v1.8 we implemented:

  • support for XWiki links inside diagrams exported to PDF
  • zoom buttons in view mode.

Get a taste of the app (a short video)

FAQ (Frequently Asked Questions)

Q: Does the Diagram Pro Application support Gliffy diagrams?

Yep, the Diagram Pro Application supports  Gliffy starting with the version v1.14

Q: How to print a diagram?

#1 Use the menu from the edit mode of the Diagram page to print (option available from File).

#2 You will notice a pop-up with print options.

#3 At this step you can choose to:

  • preview in browser how the printed diagram would look
  • select the diagram for print

You have the option to print using a connected printer or to save the file as a PDF. ✅

Q: How to export diagrams as PDF or as images?

From the File menu section, click on Export as and then select the desired option. ✅

With the Advanced option you can customize the look of the exported diagram in terms of:

  • background,
  • width and height,
  • name,
  • format,
  • zoom,
  • dots per inch (DPI)
  • border width.

You may also be interested in:

Best practices

How Santa's elves manage Christmas operations with XWiki

Santa may get all the glory, but it’s the elves, backed by XWiki, who ensure all operations run smoothly like butter biscuits and Christmas magic happens on time. Learn what features are of great help for the elves in supporting Santa Claus to deliver Christmas.