| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
Description
With release 4.0 of of CVP, Confluence administrators have the ability to enable SVG image conversion support so that the visio Visio macro can render images on browsers not capable of rendering the Internet Explorer (IE) Visio viewer control. This support requires the installation of a SVG conversion program on the Confluence server. The conversion program is not perfect, but can provide a reasonable image in many cases. The rendering is likely to improve over time as the program is developed further. The conversion program installation on the Confluence server should must be updated as updates of the program become available.
| Tip | ||
|---|---|---|
| ||
The installation must be done on the Confluence server. |
Limitations
- The conversion library may not convert some Visio diagrams or convert them with significant corruption of the image shown.
- If you have specific issues, file bug reports - How to Report Bugs in LibreOffice
- For instance, the following has been filed based on testing - https://bugs.freedesktop.org/show_bug.cgi?id=59266
- The conversion routine adds additional processing when rendering visio Visio diagrams when best or svg options are used in the app configuration. The processing has been observed to be sub-second on example sample Visio diagrams and modern CPU, your mileage may vary
. The The Cache Macro together with the attachment support can be used to improve performance and reduce server load if necessary. - Modern browser versions are required to support inline svg SVG - see see http://caniuse.com/svg-html5
Support
Users will need are required to open issues with the 3rd party library directly and upgrade their installation as appropriate to improve the rendering. Related request/issues on the add-on will not be app is not supported unless there are changes to the library requiring parameter changes to the add-on app calls.
Steps for installation
The program is OS specific. The primary difference being Windows. The base library is is libvisio provided by the LibreOffice group (GPL licensed). A command line version is required for Visio for Visio for Confluence and is available as a free (GPL licensed) program - see vsd2svg.
Download and install following the OS specific instructions:
| Panel | ||
|---|---|---|
| ||
http://sourceforge.net/projects/vsd2svg/files/vsd2svg/ - vsd2svg.exe and dlls DLLs (includes libvisio)
|
| Panel | ||
|---|---|---|
| ||
These libraries may also have dependencies that need to be installed as well. This depends on what is already available on your installation. libvisio - https://wiki.documentfoundation.org/DLP/Libraries/libvisio vsd2svg - http://sourceforge.net/projects/vsd2svg/ |
Steps after installation
- Conversion support must be on the path used to start the Confluence server.
- First, check to see if the installer set your path already: Open a new a new command prompt, type vsd2svg, and make sure it is found.
- If not found, either add the path to the conversion executable to your server PATH server PATH environment variable or modify your Confluence startup script (for example: bin/start-confluence.bat or bin/start-confluence.sh) to append the path to the conversion executable to the PATH the PATH environment variable.
- Restart the Confluence server (consider the optional the Optional step instructions before doing the restart).
- Go to UPM and find the , find Visio for Confluence, and press click the Configure button.
- Change the default output to best (recommended) so that all existing visio Visio macro usage will take takes advantage of the support.
Optional
...
step
While not required, this step will make makes it easier for your users to use SVG images on your site.
...