DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:diagramsnet

diagramsnet Plugin

Compatible with DokuWiki

  • 2020-07-29 "Hogfather" yes
  • 2018-04-22 "Greebo" yes
  • 2017-02-19 "Frusterick Manners" unknown
  • 2016-06-26 "Elenor Of Tsort" unknown

plugin

Last updated on
2020-08-12
Provides
Syntax, Action

The missing download url means that this extension cannot be installed via the Extension Manager. Please see Publishing a Plugin on dokuwiki.org. Recommended are public repository hosts like GitHub, GitLab or Bitbucket.

Similar to diagrams, drawio

Tagged with diagram, visio

By todag

Description

This plugin integrates diagrams.net into DokuWiki. The full diagrams.net app is included in the plugin (currently version 13.6.2), and this will be used by default. But there is a setting available to instead use the online version at embed.diagrams.net

The plugin works by hijacking the Dokuwiki image renderer. If the file extension matches *.drawio.png or *.diagram.png (These are the defaults and can be changed) it will add an on_click action that will launch the diagram.net app to allow editing of the file.

Installation

Use the Plugin Manager or follow the guide at Plugins to install manually.

Examples/Usage

To embed an existing diagram, or create a new one, use the toolbar button or enter the following code:

{{filename.diagram.png | Diagram Title}}

Namespaces are also supported

{{:NAMESPACE:filename.diagram.png|Diagram Title}}

The plugin uses DokuWikis image renderer, so you can use most options that are usable for embedded images, ie:

{{filename.diagram.png?100|Diagram Title}} << Changes size of image
{{ filename.diagram.png|Diagram Title}}    << Aligns image to the right

Configuration and Settings

The plugin can be configured using the DokuWiki configuration manager available in the admin menu.

app_source_type Use the included diagrams.net package (internal) or use the online version from external_url (external)
editor_parameters Parameters for diagrams.net editor
viewer_parameters Parameters for diagrams.net viewer
external_url URL to external diagrams.net application
file_match_suffix The plugin will grab and render any file containing this in its name
enable_attic Enable file revisions for diagram files

Change Log

Known Bugs and Issues

[this section might not be needed in case of external bug manager, or use RSS feed]

ToDo/Wish List

  • The diagrams.net app includes the hostname and user agent in the XML data. This should be removed or anonymized.
plugin/diagramsnet.txt · Last modified: 2020-08-12 23:52 by todag