/PlantUmlViewer

A Notepad++ plugin to generate view and export PlantUML diagrams

Primary LanguageC#MIT LicenseMIT

PlantUML Viewer

License Downloads Release Build status Donate

A Notepad++ plugin to generate, view and export PlantUML diagrams.

Features

  • Official and full PlantUML syntax
  • Multiple diagrams and pages per document supported
  • Dockable panel to show the generated PlantUML diagrams
  • Zoomable diagrams
  • Export of diagrams as PNG or SVG
  • Dark mode support

Latest changes

You can find the latest and all other changes in the changelog.

Installation

Download a release version and copy the folder PlantUmlViewer with its content to the plugins subfolder of your Notepad++ installation directory.

Plugin Manager

If you have the Plugin Manager installed you can search for PlantUML Viewer and install it.

Compatibility

This plugin requires at least

  • Notepad++ 32-bit or 64-bit
  • .NET Framework 4.6.2 or above
  • Java

Usage

PlantUML Viewer can be opened

  • by clicking the toolbar icon UML icon
  • via the Notepad++ Plugins submenu (Plugins --> PlantUML Viewer --> Preview PlantUML)

PlantUML Viewer PlantUML Viewer dark

By clicking the Refresh () button the diagram(s) are generated out of the current opened document. The file extension doesn't matter. The diagram can be

  • moved by dragging it,
  • zoomed by Ctrl + mouse wheel or clicking the buttons ( / / )
  • or scrolled vertically and horizontally by (Shift +) mouse wheel.

The currently showed diagram can be exported or copied to clipboard as PNG or SVG image by clicking the Export () button or using the right click context menu. If your document contains multiple diagrams and or pages, you can use the navigation buttons to show the next () or previous () diagram and next () or previous () page.

Make sure JAVA_PATH is set in your system or set the right path to your Java installation. It can be set together with other options in the plugins options window.

PlantUML Viewer menu PlantUML Viewer options

Usability hints

  • You may also want use this plugin in combination with PlantUML_Notepad-_UDL, which enables the PlantUML language syntax for Notepad++.
  • Using the Shortcut Mapper, which is accessible via the Settings submenu of Notepad++, you can define a shortcut to generate the diagrams.

License and credits

PlantUML Viewer is released under the MIT License. This means, you can do with it whatever you want as long as you include the original copyright and license notice in any copy of the software.

This Notepad++ plugin integrates multiple other libraries and sources. Credits and thanks to all the developers working on these great projects:

  • The plugin is based on the Notepad++ PluginPack.net by Kasper B. Graversen provided under the Apache 2.0 license.
  • The plugin uses PlantUml.Net by KevReed provided under the MIT License.
  • The plugin uses SVG.NET provided under the Microsoft Public License which depends on
    • Fizzler by Atif Aziz provided under the GNU Lesser General Public License and
    • ExCSS by Tyler Brinks provided under the Microsoft Public License.
  • The plugin uses the ImageBox Control by Richard Moss provided under the MIT License.
  • The plugin uses the LoadingCircle by Martin Gagne provided under the Code Project Open License.
  • The plugin uses Json.NET by James Newton-King provided under the MIT License.
  • The plugin uses Material Design Icons provided under the Pictogrammers Free License.
  • The plugin is packed using ILMerge provided under the MIT License.
  • The plugin release includes the binaries of PlantUML which are free to use and released under the GNU General Public License.
  • The plugin release includes the binaries of JLaTeXMath which are free to use, released under the GNU General Public License and depend on

Feedback, issues and contribution

Resonable feedback, issues and contributions are always very welcome. Feel free to bring in your points!

Disclaimer

This source and the whole package comes without warranty. It may or may not harm your computer. Please use with care. Any damage cannot be related back to the author. The source has been tested on a virtual environment and scanned for viruses and has passed all tests.

Personal Note

I've created this software in my leasure time since I found no comparable solution to preview PlantUML diagrams seamlessly in Notepad++. This software (with all its bugs) is not aiming to be an enterprise solution. It surely will not fulfill the needs of everybody. But it maybe is a nice little helper for some of you. I am always open for your reasonable feedback, issues and contributions. Feel free to contact me and have fun with it.