2.2.6 Diagrams

m (1 revision imported)
No edit summary
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
<bookshelf src="Book:User manual" />
{{DISPLAYTITLE:Drawio}}
{{DISPLAYTITLE:Drawio}}


Line 9: Line 10:
#'''Choose''' ''drawio'' from the list of magic words.
#'''Choose''' ''drawio'' from the list of magic words.
#'''Click''' ''Done''. This opens a dialog box. Enter a name for your drawing.
#'''Click''' ''Done''. This opens a dialog box. Enter a name for your drawing.
#'''Click''' ''Insert.'' [[File:Manual:drawio-dialog.png|link=https://en.wiki.bluespice.com/wiki/File:Manual:drawio-dialog.png|alt=drawio dialog|center|450x450px]]This inserts the following tag in your source code <code><nowiki>{{#drawio:Name_of_the_flowchart}}</nowiki></code>
#'''Click''' ''Insert.'' [[File:drawio-dialog.png|link=https://en.wiki.bluespice.com/wiki/File:drawio-dialog.png|alt=drawio dialog|center|450x450px]]This inserts the following tag in your source code <code><nowiki>{{#drawio:Name_of_the_flowchart}}</nowiki></code>
#'''Save''' the page.
#'''Save''' the page.


==Editing the drawing==
== Editing the drawing==


#'''Click''' ''Edit''  on the saved page above the drawio placeholder to open the draw.io editor. For the best editing experience, set your wiki into full-screen mode using the toggle button in the main toolbar.You can now edit your drawing.[[File:Manual:fullscreen-icon.png|alt=full-screen icon|center|133x133px|link=https://en.wiki.bluespice.com/wiki/File:Manual:fullscreen-icon.png]]
#'''Click''' ''Edit''  on the saved page above the drawio placeholder to open the draw.io editor. For the best editing experience, set your wiki into full-screen mode using the toggle button in the main toolbar.You can now edit your drawing.[[File:fullscreen-icon.png|center|133x133px|link=https://en.wiki.bluespice.com/wiki/File:fullscreen-icon.png]]
#'''Click''' ''Save''  in the draw.io window to save your drawing.
#'''Click''' ''Save''  in the draw.io window to save your drawing.
#'''Click''' ''Exit'' next to the Save button in the draw.io window to close the draw.io editor.
#'''Click''' ''Exit'' next to the Save button in the draw.io window to close the draw.io editor.
 
[[File:800px-drawio-processchart.png|alt=draw.io chart|center|thumb|432x432px|draw.io chart]]
[[File:Manual:drawio-processchart.png|alt=draw.io chart|center|thumb|550x550px|draw.io chart|link=https://en.wiki.bluespice.com/wiki/File:Manual:drawio-processchart.png]]<br />
<br />
==About PNG and SVG files==
==About PNG and SVG files==
In BlueSpice, draw.io diagrams are always saved in PNG format. It is currently not possible to save diagrams in SVG formats. If you have installed your wiki in-house (i.e., you are not working in the cloud), you can [[mediawikiwiki:Extension:DrawioEditor|activate SVG support via an additional extension]].
In BlueSpice, draw.io diagrams are always saved in PNG format. It is currently not possible to save diagrams in SVG formats. If you have installed your wiki in-house (i.e., you are not working in the cloud), you can [[mediawikiwiki:Extension:DrawioEditor|activate SVG support via an additional extension]].
==Import of existing diagrams==
== Import of existing diagrams ==
===Visio diagrams===
===Visio diagrams===
[[File:750px-drawio-import_vsdx.png|alt=Importing a .vsdx file|center|thumb|565x565px|Importing a .vsdx file]]
You can import files with the extension .vsdx directly into draw.io and edit them further. To do this, create an empty draw.io diagram on a wiki page. Save the empty diagram and then switch to draw.io's edit mode. From there, choose ''File> Import From> Device''. You can then edit the imported diagram in draw.io.
You can import files with the extension .vsdx directly into draw.io and edit them further. To do this, create an empty draw.io diagram on a wiki page. Save the empty diagram and then switch to draw.io's edit mode. From there, choose ''File> Import From> Device''. You can then edit the imported diagram in draw.io.
<br />
<br />
[[File:Manual:drawio-import vsdx.png|alt=Importing a .vsdx file|center|thumb|750x750px|Importing a .vsdx file]]


===SVG files===
=== SVG files===
When you import an SVG file into the BlueSpice draw.io editor, it is automatically converted into PNG format and can, therefore, no longer be edited. It is also not saved as an SVG file in the wiki. As an alternative to importing it into draw.io, you should upload the SVG file to the wiki and embed it on a wiki page. The versioning of the file cannot be done directly in the wiki. The updated version of the SVG file would then have to be updated accordingly via the file page by uploading it again.
When you import an SVG file into the BlueSpice draw.io editor, it is automatically converted into PNG format and can, therefore, no longer be edited. It is also not saved as an SVG file in the wiki. As an alternative to importing it into draw.io, you should upload the SVG file to the wiki and embed it on a wiki page. The versioning of the file cannot be done directly in the wiki. The updated version of the SVG file would then have to be updated accordingly via the file page by uploading it again.
==Using draw.io with image maps==
==Using draw.io with image maps==
Draw.io creates a versioned png-file in the ''File'' namespace. This means that every change of the flowchart creates a new, updated version of this png-file. You can integrate this file on another page in your wiki or create an [[Reference:ImageMap|image map]].
Draw.io creates a versioned png-file in the ''File'' namespace. This means that every change of the flowchart creates a new, updated version of this png-file. You can integrate this file on another page in your wiki or create an [[Reference:ImageMap|image map]].


{{Box Note|boxtype=note|Note text=It is not possible to use an image map on the same page as a drawio-diagram.}}
{{Messagebox|boxtype=note|Note text=It is not possible to use an image map on the same page as a drawio-diagram.}}


{{Box Links-en
{{Box Links-en

Revision as of 19:19, 18 March 2022


Draw.io offers extensive drawing possibilities for process flowcharts, infographics and other visualizations on a wiki page. Descriptive graphics like process chains or decision trees can be constructed directly on a wiki page.

Inserting a chart

To insert a drawing with VisualEditor:

  1. Create or choose a page where you want to insert a drawing.
  2. Select Insert > Magic word from the editor toolbar.
  3. Choose drawio from the list of magic words.
  4. Click Done. This opens a dialog box. Enter a name for your drawing.
  5. Click Insert.
    drawio dialog
    This inserts the following tag in your source code {{#drawio:Name_of_the_flowchart}}
  6. Save the page.

Editing the drawing

  1. Click Edit on the saved page above the drawio placeholder to open the draw.io editor. For the best editing experience, set your wiki into full-screen mode using the toggle button in the main toolbar.You can now edit your drawing.
    fullscreen-icon.png
  2. Click Save in the draw.io window to save your drawing.
  3. Click Exit next to the Save button in the draw.io window to close the draw.io editor.
draw.io chart
draw.io chart


About PNG and SVG files

In BlueSpice, draw.io diagrams are always saved in PNG format. It is currently not possible to save diagrams in SVG formats. If you have installed your wiki in-house (i.e., you are not working in the cloud), you can activate SVG support via an additional extension.

Import of existing diagrams

Visio diagrams

Importing a .vsdx file
Importing a .vsdx file

You can import files with the extension .vsdx directly into draw.io and edit them further. To do this, create an empty draw.io diagram on a wiki page. Save the empty diagram and then switch to draw.io's edit mode. From there, choose File> Import From> Device. You can then edit the imported diagram in draw.io.

SVG files

When you import an SVG file into the BlueSpice draw.io editor, it is automatically converted into PNG format and can, therefore, no longer be edited. It is also not saved as an SVG file in the wiki. As an alternative to importing it into draw.io, you should upload the SVG file to the wiki and embed it on a wiki page. The versioning of the file cannot be done directly in the wiki. The updated version of the SVG file would then have to be updated accordingly via the file page by uploading it again.

Using draw.io with image maps

Draw.io creates a versioned png-file in the File namespace. This means that every change of the flowchart creates a new, updated version of this png-file. You can integrate this file on another page in your wiki or create an image map.

Note:It is not possible to use an image map on the same page as a drawio-diagram.


Related info



To submit feedback about this documentation, visit our community forum.

Discussions