Author Topic: Nova Mind file format  (Read 3553 times)

Markus Böing

  • Newbie
  • *
  • Posts: 5
    • View Profile
Nova Mind file format
« on: April 30, 2010, 04:21:51 am »
Hello,

I am interested in the Nova Mind file format. Is the documentation available to the public?

Why do I want to know the file format?

I want to programmatically create mind maps. Currently my program creates OPML files but importing OPML into Nova Mind is somewhat limited. For example, I cannot attach images to branches, or set line properties.

I would like to have greater control over branch properties. Maybe generating native Nova Mind files would be an option. Which leads to the question: where can I find the file format documented?

Best regards,
/Markus.


Patrick

  • NovaMind
  • Sr. Member
  • *
  • Posts: 509
    • View Profile
    • NovaMind - the most innovative mind mapping software!
Re: Nova Mind file format
« Reply #1 on: April 30, 2010, 11:41:13 am »
Hi Markus,

Do you want to create a NovaMind 4 or NovaMind 5 file?

I would highly recommend creating a NovaMind 5 file as we have made the file format a lot simpler and the application is a lot more forgiving when opening files. (most elements are optional)

Quote from our plugin page:

Quote
Easy file format

A .nm5 file is a ZIP compressed archive containing separate XML documents for content and styles and contains images and attachments.

We tried to keep the file format as simple and intuitive as possible and most elements are optional which makes creating .nm5 files easy. If you want to parse .nm5 files you will see that the structure is simple and consistent.

There is no public file format specification available yet but it is really easy to create a document.

To get started you create a content.xml file that will look similar to this one:

Code: [Select]

<?xml version="1.0" encoding="utf-8"?>
<document>
  <topics>
    <topic id="ef79b32a-2479-422b-8830-f2c64527ac7b">
      <rich-text xml:space="preserve">
        <text-run>Start here...</text-run>
      </rich-text>
     </topic>
  </topics>
  <maps>
    <map id="82cffd5d-6c8c-4c63-a92b-260674c48a75">
      <topic-node id="66443e0f-ea12-4cb7-b9cb-3b666a97f015" topic-ref="ef79b32a-2479-422b-8830-f2c64527ac7b">
        <sub-topics />
      </topic-node>
    </map>
  </maps>
</document>


You then zip it and change the extension to .nm5.

Should be pretty self-explanatory. One important thing you should be aware of is that the id's should be unique and a topic-node needs to refer to a topic via the topic-ref attribute. The rich-text element should also specify the xml:space="preserve" attribute.

Images are a little more complex as you also will have to create a manifest.xml file. I suggest you create a mind map in NovaMind 5 that looks like the one you want to create and then look at the resulting files. (document.xml and manifest.xml). You can ignore the style-sheet.xml and the theme-ref on the maps. Also most of the 'styles' can be left out.


Hope this helps you to get started.
« Last Edit: April 30, 2010, 11:43:38 am by Patrick »

Markus Böing

  • Newbie
  • *
  • Posts: 5
    • View Profile
Re: Nova Mind file format
« Reply #2 on: May 01, 2010, 05:29:43 am »
Hello Patrick,

that gets me started a treat. :-)

I was looking to use NM5, because you simplified the file format, I want to use the radial mind map layout, and it is due pretty soon.

Thank you very much for your quick help.

Best regards,
/Markus.

PS: <topic id = ...> can be any string, as long as it is unique, correct?

Gideon

  • NovaMind
  • Sr. Member
  • *
  • Posts: 618
    • View Profile
Re: Nova Mind file format
« Reply #3 on: May 01, 2010, 06:37:25 am »
Correct.