zyoussef / netbeans-mmd-plugin

Mind Map editor + plugin for NetBeans and Intellij

Introduction

The Main part of a software project is not code but knowledge generated during the project. I guess knowledge is the main part of every business today and it is very important to move the generated knowledge from non-formal level to formal level to avoid its loss. There are many approaches to save knowledge and a mind map diagram is one of them. Also it is very important to keep the "distance" between project and its knowledge as short as possible and the ideal variant is to keep knowledge just within the project as a document set. If you use any external knowledge engineering tool then the distance already is not so short and for the cause I had decided to develop some plugin which would allow to form mind maps and keep knowledge graph just within projects and allow to work with the graphs just with the IDE.

Changelog

1.4.3 (01-may-2018)

• SR: license changed to LGPL 2.1
• ALL: increased step of scroll and decreased step of scale in panel
• ALL: added special icon for mailto scheme in URI
• ALL: fixed processing of drag'n'drop URL files from browsers under Windows
• IJ: #42 Fixed processing of project root in maven multi-project workspace
• ALL: #44 Improved emoticon panel to increase slected icon visibility
• ALL: #43 Fixed non-processed exception "Clipboard is busy"
• IJ: #40 Fixed exception if turn off option disable .projectKnowledge folder autocreation in proect facet
• SR: added support for PlantUML script rendering (files .pu,.puml and .plantuml)

1.4.2 (25-feb-2018)

• SR: #38 added option to not show hidden files and folders in proect tree
• ALL: Added paper render quality option
• ALL: #36 fixed line break processing in topic title editor under Mac OS
• SR: #37 fixed start of SciaReto under Oracle JDK-9 in MacOS
• IJ: #35 added Use Project base folder as relative path root option to facet (by default it uses Module folder)
• ALL: #34 added logic to interpret zero-length MMD file as an empty mind map file with root.
• ALL: #33 added configuration flag to trim entered topic text, Trim topic text before set
• ALL: added exporter for AsciiDoc
• ALL: #31 Imrpoved FreeMind compatibility to support 1.0.1 FreeMind format
• ALL: #30 Remember setting in "add file"
• ALL: #29 Remember per session last used directory for files
• ALL: Added standard text pop-up menu into text fields of both File dialog and URI dialog.
• ALL: added select mode with pressed SHIFT

Full changelog

Implementation

Because my main programming tool is NetBeans IDE, I have developed plugin for the IDE. It is compatible with Java 1.7+ and NetBeans 7.4+.

You can take a look at the nice screencast made by Geertjan Wielenga about the plugin
Also there is standalone version of the Mind Map plagin called "Scia Reto" editor. It can be loaded from the latest release page. Just select archive for your OS (EXE version is for Windows, DMG version is for Mac OS.)

Key features

Data format

The Plugin keeps all mind map information in single UTF8 encoded plain text file formed in markdown compatible format, so the file can be easily read and interpret and without the plugin.

Mind Map generated by NB MindMap plugin   
> __version__=`1.1`
---

# Root <br/>topic
> topicLinkUID=`14F9D4CD31DA`


## First level
- LINK
<pre>http://www.google.com</pre>

### Item 1\.1
- NOTE
<pre>Some note for item 1.1</pre>

### Item 1\.2
- TOPIC
<pre>14F9D4CD31DA</pre>

New mind map creation

The Plugin creates new mind map just within project folders through the standard NetBeans new file wizard, just start the New File wizard and select the Other category and you will see the NB Mind-map record in the File Types: list. Select the NB Mind-map and press Next> in the wizard.

Work with mind maps

Mind maps are opened in IDE as documents with graphic interface and the plugin doesn't add any new actions into IDE menu so all operations over mind maps you can make through the document pop-up menu. The Pop-up menu is formed for the current document state and context.

Move topics

All manipulations over topic order and its position in the map hierarchy can be made only through mouse Drag&Drop operations (keep in mind that only one topic can be moved in the same time).

Change look and feel of mind maps

You can tune most of graphic parameters for mind map rendering through the IDE Options (or just click Options in the pop-up menu).

Export mind map data

Today it is very important to have way to export data to another formats to use the knowledge in another tools. The Plug-in supports several formats to export data:

• Plain text format
• Markdown format
• Freemind format
• Mindmup format
• PNG image
• SVG image
• ORG format

Import data as Mind map

At present the editor allows to import main maps from many well-known mind map formats

• Mindmup format
• Freemind format
• XMind format
• Coggle format
• Novamind format also it can import mind map from tabbed text files.

Content alowed in mind maps

Mainly you can keep short texts in your mind maps as topic names but sometime it is useful to keep and another information, the plugin allows to keep below listed information assets:

• Short text - short text in one or two lines as topic name, mainly used as id for the topic.
• Long text - long text information which can be opened and edited in special editor.
• URL link - just URL link to be opened in system browser
• File link - link to a file, youc can add them through special dialog or just drag and drop file from NetBeans project tree to a topic, the file will be opened within IDE as a document
• Transition - link to another topic in the same mind map, it allows to make some navigation in very big mind maps

You can add and edit new topic content through the mind map pop-up menu and if you want remove some content then just open editor for the content and remove all text information.