How to add links to diagrams in XWiki

23 Apr 2024 5 min read

Written by

The XWiki Team

Diagrams are an easy yet effective means to break down complex ideas and to visually represent your thoughts or company processes in an organized manner. In XWiki, there are a myriad of formats allowing you to do just that with the intuitive Diagram Application (Pro), thanks to the diagrams.net integration: from wireframes, mockups, UML, charts, BPMN, mind maps, to tree and network diagrams.

If you are already an XWiki SAS client, 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.

While you might be familiar with creating and editing diagrams in XWiki, you've probably stumbled across this quick guide to find out how you can add links to diagrams. We are describing below the steps you need to go through for 2 different use cases.

💡 How to create links to wiki pages from Diagrams that open in a new tab

  • Select the shape or text in the diagram that you want to link.
  • Click the "Link" button in the toolbar or right-click and choose "Edit Link".
  • In the "Link" dialog window, choose "Browse" as the link type.
  • Search for your target wiki page and select it.
  • Confirm the link by clicking on "Apply."

diag1-wikipages-newtab.webp

Below, you can see how we've used the Diagram App to illustrate the steps described for creating links to wiki pages as an easy-to-follow alternative to a quick, small guide.

How to create links to wiki pages.drawio (1).webp

âš¡ How to create external links from Diagrams that open in a new tab

  • Select the shape or text in the diagram that you want to link.
  • Click the "Link" button in the toolbar or right-click and choose "Edit Link."
  • In the "Link" dialog window, choose "External" as the link type.
  • Enter the full URL of the external website (e.g., "https://www.example.com").
  • Confirm the link by clicking "Apply."

diag2-externalLinks-newtab.webp

Now take a look at the chart below created with the Diagram App, that goes through the same steps explained above.

How to add external links.webp

🎨 Looking for more things to do with the Diagram Application (Pro)?

If you're wondering how you can streamline your workflow using the Diagram App in XWiki, we have this video that can help you spark ideas. You can check out our YouTube channel for more useful tips on XWiki's apps and features, as well as on migrating from Confluence to an alternative open-source solution, so make sure to subscribe to be the first to learn about our updates through video tutorials.

You may also be interested in:

News

Introducing our new Confluence Migration Toolkit and 3 most requested bridge macros

XWiki SAS has launched 3 Confluence-equivalent bridge macros — Page Properties, Page Properties Report, and Content by Label. These macros can be found in the new Confluence Migration Toolkit, a bundle with all the macros, apps, and services that you need to transfer data but also benefit from long-term technical support from XWiki SAS. Read the full announcement here.

Best practices

Run your on-prem wiki instance like a pro with Admin Tools Application (Pro)

XWiki SAS has released the Admin Tools Application (Pro) v1.0, one of the many business-ready Pro Apps, available in the XWiki SAS store. Through this app, you can optimize your XWiki on-prem installation, maintenance, and resources allocation — all from one central dashboard. Read the full article here.