peter88213 / mm2nw

Create a novelWriter project from a FreeMind outline

mm2nw

Features

This Python script generates a novelWriter project from a FreeMind / Freeplane outline.

• Convert three levels of the novel structure: Parts, chapters, and scenes.
• Convert a set of main characters.
• Convert a set of minor characters.
• Convert a set of locations.
• Convert a set of items.
• Make the node label the title of the converted element.
• Make the node notes the description of the converted element.
• The chapter/scene types can be set by specified icons.

Requirements

• Python version 3.6+.

Download link

https://raw.githubusercontent.com/peter88213/mm2nw/main/mm2nw.py

Instructions for use

Command line usage

You can either

• launch the program on the command line passing the mindmap file as an argument, or
• launch the program via a batch file.

usage: mm2nw.py [-h] [--silent] Sourcefile

positional arguments:

Sourcefile

The path of the .mm file.

optional arguments:

-h, --help

show this help message and exit

--silent

suppress error messages and the request to confirm overwriting

Conversion rules

• Converts elements on three levels of the novel structure: Parts, chapters, and scenes.
• Scene status is Outline.
• Converts a set of main characters.
• Converts a set of minor characters.
• Converts a set of locations.
• Converts a set of items.
• Makes the node label the title of the converted element.
• Makes the node notes the description of the converted element.

The levels of the mindmap tree

• On the first level, a node represents either a part, or a collection of characters, locations, or items. The conversion of "Normal type parts" can be suppressed with a configuration file entry, if you just want chapters and scenes.
• On the second level, a node represents either a chapter, or a character/location/item.
• On the third level. a node represents a scene.

The use of special icons

The conversion is controlled by nodes decorated with special icons:

On the first level

This icon marks the Main characters branch:

This icon marks the Minor characters branch:

This icon marks the Locations branch:

This icon marks the Items branch:

On the first, second, or third level

This icon makes a node element and its children (if any) Note type:

This icon makes a node element and its children (if any) Note type:

Example mindmap

Credits

• Frederik Lundh published the xml pretty print algorithm.

License

mm2nw is distributed under the MIT License.

---

See also

nw_metadata

Create a cross reference table with novelWriter metadata.

nw_metadata

odt2nw

Generate a novelWriter project from a work in progress written with e.g. LibreOffice.

odt2nw

md2nw

Generate a novelWriter project from a work in progress written with any text editor or Markdown word processor.

md2nw

yw2nw

Converter between yWriter and novelWriter.