JarCasting
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.
Initially I developed plugin for NetBeans IDE but because in companies, where I work for, mainly Intellij IDEA in use, I developed plugin for Intellij IDEA too. Then a friend asked me to develop some standalone version which could be used by users who don't have any relations to Java and I developed SciaReto application.
Changelog
1.4.10 (SNAPSHOT)
- SR: added View-Zoom into the main menu toolbar
- ALL: added password protection for notes (AES-256)
- ALL: decreased topic dragging start sensitivity #77
- ALL: emoticons and images included into search scope by their names #76
- SR: fixed file rename #74
- SR: embedded JDK version updated to 11.0.9.1+1
- SR: embedded PlantUml updated to 1.2020.20
1.4.9 (28-jun-2020)
- IJ: fixed incompatibility in Scratch API processing for IntelliJ 2020.2 EAP #69
- ALL: improved XMind importer to support XMind 2020 format #67
- SR: improved rendering of Kafka Streams topology
- SR: embedded JDK version updated to 11.0.7+10
- SR: added DOT script editor
- SR: added check on save for external file change
- SR: improved positioning of text search panel
- SR: shortcut for
Savechanged toCtrl+Sand shortcutSave Allchanged toCtrl+Shift+S#65 - SR: embedded PlantUml updated to 1.2020.14
1.4.8 (19-mar-2020)
- ALL: Added extra emoticons:
caution_biohazard,hospital,emoticon_medic,emoticon_masketc. - SR: Fixed too high quality of PlantUML image render during scale #64
- IJ: Fixed mind map save after topic color change #63
- IJ: Added support of Scratch #61
- SR: Added auto-backup of last edit (turned off by default) #60
- SR: PlantUML updated to 1.2020.3
- SR: embedded JDK version updated to 11.0.6+10
1.4.7 (28-dec-2019)
- ALL: fixed loosing of focus for new edited topic under some JDK versions
- ALL: improved image plugin to open original file through thumbnail clicks
- SR: added support of KStreams topology rendering through PlantUML (kstpl file extenstion)
- SR: fixed application icon and title under some OS
- ALL: added recognition of text presented dragged URI link as URI link
- ALL: improved color chooser
- ALL: added support of "smart text paste" with splitting to topics (inactive by default)
- SR: embedded Java updated to 11.0.5+11
- SR: PlantUML updated to 1.2019.13
- SR: fixed autofocusing in topic edit dialogs #56
Implementation
All parts of the application are written in Java and it needs Java 1.8+ for work.
The editor has three implementations
- standalone application (including also PlantUML support)
- NetBeans plug-in
- Intellij IDEA plug-in
The standalone version is a Java application but it contains embedded JRE so that a user should not have pre-installed Java on computer. But Graphviz should be installed for use by PlantUML.
How to use?
Just after first release for NetBeans IDE, Geertjan Wielenga created nice screen-cast which a bit out of date but still look good to understand common idea. It is very easy editor and the main set of operations look very intuitive, main questions from users I had about keyboard shortcuts but if keep in mind that TAB creates new mind map node and ENTER creates new sibling mode then life becomes much easier. It is a pop-up menu centric software so that all operations accessible through pop-up menu.
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 plug-in.
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>
How to create new Mind map
SciaReto standalone application
In project tree just click mouse to activate pop-up menu for a folder and select in menu New->Mind map. 
NetBeans
Mind map type is added as one more file type and can be found among file types in the Other.
Intellij IDEA
Mind map type is registered as a file type which can be created through New pop-up menu for a folder. 
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).
Tune look of mind map editor
You can tune most of graphic parameters for mind map rendering through special panel Options. It can be activated through Options item of pop-up menu and through menu Edit->Preferences in the standalone version.
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.