alexocculate / netbeans-mmd-plugin

Plugin for NetBeans to work with mind maps

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.3.1-SNAPSHOT (under development)

• ALL: added attribute in mind map templates to show jumps by default
• IDEA: added auto-positioning of root topic into center of view area just as document open
• SCIARETO: added text search in map

1.3.0 (01-sep-2016)

• added sorting of attributes in mind map model to keep their order
• added plugin to add an image into a topic
• changed Plugin API
• fixed casual d'n'd topic operations through click over its fold-unfold icon
• added export into SVG image format
• published standalone editor "Scia Reto"
• fixed issue #22, added key short-cut into options to tune "next line char" for topic text editor, by default SHIFT+ENTER

1.2.0 (05-jun-2016)

• IJ: Minimal supported API version changed to 143.2370
• fixed issue #16, Added default key board shortcut to open popup context menu, CTRL+ALT+SPACE
• Added loading of custom plugins from folder defined through nbmmd.plugin.folder property
• Added plugin "Emoticons"
• Added importer from text files written in style text2mindmap
• Added key board shortcuts to add focused items during focus move
• Added key board shortcuts for zooming in, out and resetting zoom.
• fixed issue #10 "In Select topic dialog; Fold All only closes the root node"
• fixed issue #9 "Cannot find configurable: com.igormaznitsa.ideamindmap.settings.MindMapSettingsComponent"
• fixed issue #11 "Can't create topic with hash char"
• reworked mind map format parser to make it compatible with PSI tree parser in IDEA
• code refactoring, inside API reworked to plugin based one

1.1.4 (21-feb-2015)

• improved PNG exporter to save images without background and with all unfolded topics
• added graphical print support into the IDEA plugin
• added tuning of key modifiers to activate scaling with mouse wheel
• fixed icons in color choosing buttons in IDEA version under Retina
• improved panel, now clicking on '+' of a topic with pressed CTRL will open only 1th level children
• improvements of stability in work with DnD operations
• refactoring of both plug-ins, improved stability of work

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.0`
---

# 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 Plugin supports several formats to export data:

• Plain text format - just plain UTF8 encoded format.
• Markdown format - UTF8 encoded specialized text format, it is compatible with Markdown used by GitHub.
• FreeMind map - XML based format for the FreeMind editor, a popular mind map editing tool, also the format is supported for export by X-Mind editor.
• Mindmup map - JSON based format for the Mindmup online editor.
• PNG image - just standard PNG image files.
• SVG image - vector SVG format image files.

Import data as Mind map

At Present there is only format supported for import. It is plain UTF-8 encoded TAB-formatted 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 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.