Difference between revisions of "Current Freeplane File Format"
From Freeplane - free mind mapping and knowledge management software
(→Mapping between old and new format: add edge format) |
m (Text replace - "Category:Program" to "Category:Coding") |
||
(15 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
+ | [[Category:Coding]] | ||
+ | |||
+ | This page tries to reflect changes of the Freeplane file format. | ||
+ | |||
= Original FreeMind File Format = | = Original FreeMind File Format = | ||
The original FreeMind format was never described completely formally, but there is some documentation: | The original FreeMind format was never described completely formally, but there is some documentation: | ||
− | * | + | * FreeMind's file format is described [http://freemind.sourceforge.net/wiki/index.php/File_format in the Wiki]. |
* There is a schema validation in [http://freemind.cvs.sourceforge.net/viewvc/freemind/freemind/freemind.xsd?view=log&pathrev=fm_060405_integration SVN (integration branch)], with a [http://freemind.cvs.sourceforge.net/viewvc/freemind/freemind/freemind.xsd?revision=1.1.2.4.4.2&view=markup&pathrev=fm_060405_integration latest revision]. | * There is a schema validation in [http://freemind.cvs.sourceforge.net/viewvc/freemind/freemind/freemind.xsd?view=log&pathrev=fm_060405_integration SVN (integration branch)], with a [http://freemind.cvs.sourceforge.net/viewvc/freemind/freemind/freemind.xsd?revision=1.1.2.4.4.2&view=markup&pathrev=fm_060405_integration latest revision]. | ||
Line 11: | Line 15: | ||
The following schema takes the schema pointed at in the previous chapter and completes it with Freeplane specific extensions (in '''bold''' for easy identification): | The following schema takes the schema pointed at in the previous chapter and completes it with Freeplane specific extensions (in '''bold''' for easy identification): | ||
+ | |||
+ | ; Attention<nowiki>:</nowiki> : The file format was accurate as per version 1.1.x, new features in 1.2.x have not (yet) been documented. | ||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | ||
Line 32: | Line 38: | ||
'''<xs:complexType>''' | '''<xs:complexType>''' | ||
'''<xs:attribute name='VALUE' type='xs:string' use='required'/>''' | '''<xs:attribute name='VALUE' type='xs:string' use='required'/>''' | ||
+ | '''<xs:attribute name='TYPE' type='xs:string' use='optional'/>''' | ||
'''</xs:complexType>''' | '''</xs:complexType>''' | ||
'''</xs:element>''' | '''</xs:element>''' | ||
Line 52: | Line 59: | ||
'''<xs:element ref='attribute_name'/>''' | '''<xs:element ref='attribute_name'/>''' | ||
'''</xs:choice>''' | '''</xs:choice>''' | ||
+ | '''<xs:attribute name='RESTRICTED' type='xs:boolean' use='optional' />''' | ||
'''<xs:attribute name='SHOW_ATTRIBUTES' use='optional'>''' | '''<xs:attribute name='SHOW_ATTRIBUTES' use='optional'>''' | ||
'''<xs:simpleType>''' | '''<xs:simpleType>''' | ||
Line 74: | Line 82: | ||
'''<xs:attribute name='NAME' type='xs:string' use='required'/>''' | '''<xs:attribute name='NAME' type='xs:string' use='required'/>''' | ||
'''<xs:attribute name='VALUE' type='xs:string' use='required'/>''' | '''<xs:attribute name='VALUE' type='xs:string' use='required'/>''' | ||
+ | '''<xs:attribute name='TYPE' type='xs:string' use='optional'/>''' | ||
'''</xs:complexType>''' | '''</xs:complexType>''' | ||
'''</xs:element>''' | '''</xs:element>''' | ||
Line 231: | Line 240: | ||
<xs:attribute name='STYLE' type='xs:string' use='optional'/> | <xs:attribute name='STYLE' type='xs:string' use='optional'/> | ||
<xs:attribute name='TEXT' type='xs:string' use='optional'/> | <xs:attribute name='TEXT' type='xs:string' use='optional'/> | ||
+ | <xs:attribute name='LOCALIZED_TEXT' type='xs:string' use='optional'/> | ||
+ | <xs:attribute name='TYPE' type='xs:string' use='optional'/> | ||
<xs:attribute name='CREATED' type='xs:integer' use='optional'/> | <xs:attribute name='CREATED' type='xs:integer' use='optional'/> | ||
<xs:attribute name='MODIFIED' type='xs:integer' use='optional'/> | <xs:attribute name='MODIFIED' type='xs:integer' use='optional'/> | ||
Line 243: | Line 254: | ||
= Mapping between old and new format = | = Mapping between old and new format = | ||
− | + | ; Attention<nowiki>:</nowiki> : This effort is on hold until further notice (perhaps after release of version 1.2/1.3). | |
{| border="1" cellpadding="20" cellspacing="0" | {| border="1" cellpadding="20" cellspacing="0" | ||
Line 250: | Line 261: | ||
| | | | ||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | ||
− | <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> | + | <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" |
+ | elementFormDefault="qualified"> | ||
| not relevant | | not relevant | ||
|- | |- | ||
Line 295: | Line 307: | ||
<xs:element ref='attribute_name'/> | <xs:element ref='attribute_name'/> | ||
</xs:choice> | </xs:choice> | ||
+ | <xs:attribute name='RESTRICTED' type='xs:boolean' use='optional' /> | ||
<xs:attribute name='SHOW_ATTRIBUTES' use='optional'> | <xs:attribute name='SHOW_ATTRIBUTES' use='optional'> | ||
<xs:simpleType> | <xs:simpleType> | ||
Line 321: | Line 334: | ||
<nowiki><!-- END ATTRIBUTES --></nowiki> | <nowiki><!-- END ATTRIBUTES --></nowiki> | ||
− | | | + | | The whole attribute will be replaced as follows. First define the sets of attributes at the map level: |
+ | <map:attributes attribute:restricted="false|true"> | ||
+ | <attribute:attribute meta:name="..." | ||
+ | attribute:restricted="false|true" | ||
+ | attribute:selected="false|true"> | ||
+ | <attribute:value>some value</attribute:value> | ||
+ | ... | ||
+ | </attribute:attribute> | ||
+ | ... | ||
+ | </map:attributes> | ||
+ | And then assign the attributes at the node level: | ||
+ | <node:attributes attribute:name-width="..." | ||
+ | attribute:value-width="..."> | ||
+ | <attribute:attribute | ||
+ | meta:name="...">some value</attribute:attribute> | ||
+ | ... | ||
+ | </node:attributes> | ||
|- | |- | ||
| | | | ||
Line 403: | Line 432: | ||
</xs:complexType> | </xs:complexType> | ||
</xs:element> | </xs:element> | ||
− | + | | Replaced by element <tt><style:text-properties ... /></tt> with attributes | |
+ | fo:color="#rrggbb" | ||
+ | fo:font-weight="normal<nowiki>|</nowiki>bold" | ||
+ | fo:font-style="normal<nowiki>|</nowiki>italic" | ||
+ | fo:font-family="name of the font" | ||
+ | fo:font-size="integer" | ||
+ | ;Note:<tt><style:font-name></tt> could be used instead of <tt>fo:font-family</tt> but, according to specs, this would mean a separate definition of a font through a <tt>style:font-face</tt> element and that makes the whole thing more complex. See [[Freeplane_File_Format#3.14_.3Coffice:font-face-decls.3E]]. | ||
+ | ;Note:this element should be moved to a <tt><style:style></tt> element that defines a style with the family value of text, and referenced by name through the <tt>text:style-name</tt> attribute. | ||
+ | |- | ||
+ | | | ||
<xs:element name='hook'> | <xs:element name='hook'> | ||
<xs:complexType> | <xs:complexType> | ||
Line 414: | Line 452: | ||
<xs:attribute name='URI' type='xs:anyURI' use='optional'/> | <xs:attribute name='URI' type='xs:anyURI' use='optional'/> | ||
<xs:attribute name='SIZE' type='xs:decimal' use='optional'/> | <xs:attribute name='SIZE' type='xs:decimal' use='optional'/> | ||
+ | | Replaced by the following element: | ||
+ | <draw:frame draw:transform="scale(sx [sy])"> | ||
+ | <draw:image xlink:href="URL"/> | ||
+ | </draw:frame> | ||
+ | ;Note: if wished, the <tt><draw:image></tt> element could also have an attribute <tt>draw:filter-name="ExternalObject"</tt> but I wouldn't see the point (rather the name of a plugin for image formats not supported by Freeplane). | ||
+ | |- | ||
+ | | | ||
<nowiki><!-- for map config info NAME="MapStyle" --></nowiki> | <nowiki><!-- for map config info NAME="MapStyle" --></nowiki> | ||
<xs:attribute name='max_node_width' type='xs:integer' use='optional'/> | <xs:attribute name='max_node_width' type='xs:integer' use='optional'/> | ||
<xs:attribute name='zoom' type='xs:decimal' use='optional'/> | <xs:attribute name='zoom' type='xs:decimal' use='optional'/> | ||
+ | | It actually depends if those settings shall be different from map to map (within a same file) or the same for the whole file. | ||
+ | In the first case, they would be attributes to the <tt><map:map></tt> element: | ||
+ | node:max-width="integer" | ||
+ | map:zoom="percentage" | ||
+ | And in the 2nd case, they would be [[Freeplane_File_Format#3.10_.3Coffice:settings.3E|office settings]]: | ||
+ | <config:config-item config:name="NodeMaxWidth" | ||
+ | config:type="int">40</config:config-item> | ||
+ | <config:config-item config:name="MapZoom" | ||
+ | config:type="int">150</config:config-item> | ||
+ | '''''TBD''''' | ||
+ | |- | ||
+ | | | ||
<nowiki><!-- for equations NAME="plugins/latex/LatexNodeHook.properties" --></nowiki> | <nowiki><!-- for equations NAME="plugins/latex/LatexNodeHook.properties" --></nowiki> | ||
<xs:attribute name='EQUATION' type='xs:string' use='optional'/> | <xs:attribute name='EQUATION' type='xs:string' use='optional'/> | ||
</xs:complexType> | </xs:complexType> | ||
</xs:element> | </xs:element> | ||
− | + | | Plugin hooks (like Latex) are replaced by an element <tt><node:content></tt> with a corresponding namespace definition, like in: | |
+ | <node:content | ||
+ | xmlns:latex="plugins/latex/LatexNodeHook.properties"> | ||
+ | <latex:equation> | ||
+ | <![CDATA[''some equation in Latex'']]> | ||
+ | </latex:equation> | ||
+ | </node:content> | ||
+ | As shown here, in the case of non-XML dialect, the use of a CDATA section is highly recommended. | ||
+ | |- | ||
+ | | | ||
<xs:element name='icon'> | <xs:element name='icon'> | ||
<xs:complexType> | <xs:complexType> | ||
Line 427: | Line 493: | ||
</xs:complexType> | </xs:complexType> | ||
</xs:element> | </xs:element> | ||
− | + | | Replaced by element <tt><node:icon ... /></tt> with attributes | |
+ | node:icon-name="..." (a string) | ||
+ | |- | ||
+ | | | ||
<xs:element name='html'> | <xs:element name='html'> | ||
<xs:complexType> | <xs:complexType> | ||
<xs:sequence> | <xs:sequence> | ||
− | <nowiki><!--Anything that is valid XML, but should be http://www.w3.org/1999/xhtml --></nowiki> | + | <nowiki><!--Anything that is valid XML, |
− | <xs:any namespace="##any" minOccurs="0" maxOccurs="unbounded" processContents="skip"/> | + | but should be http://www.w3.org/1999/xhtml --></nowiki> |
+ | <xs:any namespace="##any" minOccurs="0" maxOccurs="unbounded" | ||
+ | processContents="skip"/> | ||
</xs:sequence> | </xs:sequence> | ||
</xs:complexType> | </xs:complexType> | ||
</xs:element> | </xs:element> | ||
− | + | | Obsolete, as all nodes are rich content... | |
+ | |- | ||
+ | | | ||
<xs:element name='richcontent'> | <xs:element name='richcontent'> | ||
<xs:complexType> | <xs:complexType> | ||
Line 454: | Line 527: | ||
</xs:complexType> | </xs:complexType> | ||
</xs:element> | </xs:element> | ||
− | + | | Replaced by either | |
+ | <node:content xmlns:xhtml="http://www.w3.org/1999/xhtml"> | ||
+ | <xhtml:body> ... </xhtml:body> | ||
+ | or | ||
+ | <office:annotation xmlns:xhtml="http://www.w3.org/1999/xhtml"> | ||
+ | <xhtml:body> ... </xhtml:body> | ||
+ | :Note:the XHTML body is specific to Freeplane, ODF has actually its own markup, but that would be too much to implement. In the future, other type of elements could be implemented in a node or a note (Latex, etc...) instead of XHTML. | ||
+ | |- | ||
+ | | | ||
<xs:element name='map'> | <xs:element name='map'> | ||
<xs:complexType> | <xs:complexType> | ||
Line 464: | Line 545: | ||
</xs:complexType> | </xs:complexType> | ||
</xs:element> | </xs:element> | ||
− | + | | Replaced by element <tt><map:map></tt> | |
+ | |- | ||
+ | | | ||
<xs:element name='node'> | <xs:element name='node'> | ||
+ | | Replaced by element <tt><node:node></tt> | ||
+ | |- | ||
+ | | | ||
<xs:complexType> | <xs:complexType> | ||
<xs:choice minOccurs='0' maxOccurs='unbounded'> | <xs:choice minOccurs='0' maxOccurs='unbounded'> | ||
Line 475: | Line 561: | ||
<xs:element ref='icon'/> | <xs:element ref='icon'/> | ||
<xs:element ref='node'/> | <xs:element ref='node'/> | ||
− | <nowiki><!-- For nodes with extended formatting content or for notes | + | <nowiki><!-- For nodes with extended formatting content or for notes. --></nowiki> |
<xs:element ref='richcontent'/> | <xs:element ref='richcontent'/> | ||
<xs:element ref='attribute_layout'/> | <xs:element ref='attribute_layout'/> | ||
<xs:element ref='attribute'/> | <xs:element ref='attribute'/> | ||
</xs:choice> | </xs:choice> | ||
− | <xs:attribute name='BACKGROUND_COLOR' type='xs:string' use='optional'/> | + | | Mapped obviously as described above... |
+ | |- | ||
+ | | | ||
+ | <xs:attribute name='BACKGROUND_COLOR' | ||
+ | type='xs:string' use='optional'/> | ||
+ | | Replaced by attribute <tt>draw:fill-color="#rrggbb"</tt> | ||
+ | |- | ||
+ | | | ||
<xs:attribute name='COLOR' type='xs:string' use='optional'/> | <xs:attribute name='COLOR' type='xs:string' use='optional'/> | ||
+ | | It's actually the color of the font and has been moved to the corresponding element <tt><style:text-properties ... /></tt>. | ||
+ | |- | ||
+ | | | ||
<xs:attribute name='FOLDED' use='optional'> | <xs:attribute name='FOLDED' use='optional'> | ||
<xs:simpleType> | <xs:simpleType> | ||
Line 490: | Line 586: | ||
</xs:simpleType> | </xs:simpleType> | ||
</xs:attribute> | </xs:attribute> | ||
+ | | Replaced by attribute <tt>node:folded="false<nowiki>|</nowiki>true"</tt> | ||
+ | |- | ||
+ | | | ||
<xs:attribute name='ID' type='xs:ID' use='optional'/> | <xs:attribute name='ID' type='xs:ID' use='optional'/> | ||
+ | | Replaced by attribute <tt>xml:id="ID"</tt> | ||
+ | |- | ||
+ | | | ||
<xs:attribute name='LINK' type='xs:string' use='optional'/> | <xs:attribute name='LINK' type='xs:string' use='optional'/> | ||
+ | | Replaced by attribute <tt>xlink:href="URL"</tt> | ||
+ | |- | ||
+ | | | ||
<xs:attribute name='POSITION' use='optional'> | <xs:attribute name='POSITION' use='optional'> | ||
<xs:simpleType> | <xs:simpleType> | ||
Line 500: | Line 605: | ||
</xs:simpleType> | </xs:simpleType> | ||
</xs:attribute> | </xs:attribute> | ||
+ | | Replaced by attribute <tt>node:side="left<nowiki>|</nowiki>right"</tt> | ||
+ | |- | ||
+ | | | ||
<xs:attribute name='STYLE' type='xs:string' use='optional'/> | <xs:attribute name='STYLE' type='xs:string' use='optional'/> | ||
+ | | Replaced by attribute <tt>draw:style="fork<nowiki>|</nowiki>bubble"</tt> | ||
+ | |- | ||
+ | | | ||
<xs:attribute name='TEXT' type='xs:string' use='optional'/> | <xs:attribute name='TEXT' type='xs:string' use='optional'/> | ||
+ | | Obsolete. | ||
+ | |- | ||
+ | | | ||
<xs:attribute name='CREATED' type='xs:integer' use='optional'/> | <xs:attribute name='CREATED' type='xs:integer' use='optional'/> | ||
<xs:attribute name='MODIFIED' type='xs:integer' use='optional'/> | <xs:attribute name='MODIFIED' type='xs:integer' use='optional'/> | ||
+ | | Replaced respectively by attributes <tt>node:inserted="dateTime"</tt> and <tt>node:modified="dateTime"</tt> | ||
+ | ;Note:the 'dateTime' format is normally according to [http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#isoformats ISO8601] instead of the current UN*X-like number of seconds. '''''TBD''''' - To Be Discussed. | ||
+ | |- | ||
+ | | | ||
<xs:attribute name='HGAP' type='xs:integer' use='optional'/> | <xs:attribute name='HGAP' type='xs:integer' use='optional'/> | ||
<xs:attribute name='VGAP' type='xs:integer' use='optional'/> | <xs:attribute name='VGAP' type='xs:integer' use='optional'/> | ||
<xs:attribute name='VSHIFT' type='xs:integer' use='optional'/> | <xs:attribute name='VSHIFT' type='xs:integer' use='optional'/> | ||
− | <xs:attribute name='ENCRYPTED_CONTENT' type='xs:string' use='optional'/> | + | | Replaced respectively by attributes <tt>node:margin-horizontal="integer"</tt>, <tt>node:margin-vertical="integer"</tt> and <tt>node:shift-vertical="integer"</tt> |
+ | |- | ||
+ | | | ||
+ | <xs:attribute name='ENCRYPTED_CONTENT' | ||
+ | type='xs:string' use='optional'/> | ||
+ | | Replaced by attribute <tt>node:encrypted="false<nowiki>|</nowiki>true"</tt> | ||
+ | |- | ||
+ | | | ||
</xs:complexType> | </xs:complexType> | ||
</xs:element> | </xs:element> | ||
</xs:schema> | </xs:schema> | ||
− | | | + | | |
|} | |} | ||
− | |||
− |
Latest revision as of 19:26, 9 December 2011
This page tries to reflect changes of the Freeplane file format.
Original FreeMind File Format
The original FreeMind format was never described completely formally, but there is some documentation:
- FreeMind's file format is described in the Wiki.
- There is a schema validation in SVN (integration branch), with a latest revision.
- Note
- the above documentation is outdated in regard to elements introduced by Freeplane, like connector labels, attributes, scripts, user icons and (scalable) images embedded in the map.
Freeplane's version of it
The following schema takes the schema pointed at in the previous chapter and completes it with Freeplane specific extensions (in bold for easy identification):
- Attention:
- The file format was accurate as per version 1.1.x, new features in 1.2.x have not (yet) been documented.
<?xml version="1.0" encoding="UTF-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <xs:element name='Parameters'> <xs:complexType> <!--Is the time management plugin.--> <xs:attribute name='REMINDUSERAT' type='xs:integer' use='optional'/> </xs:complexType> </xs:element> <!--Used for node notes.--> <xs:element name='text'> <xs:complexType/> </xs:element> <!-- BEGIN ATTRIBUTES --> <xs:element name='attribute_value'> <xs:complexType> <xs:attribute name='VALUE' type='xs:string' use='required'/> <xs:attribute name='TYPE' type='xs:string' use='optional'/> </xs:complexType> </xs:element> <xs:element name='attribute_name'> <xs:complexType> <xs:choice minOccurs='0' maxOccurs='unbounded'> <xs:element ref='attribute_value'/> </xs:choice> <xs:attribute name='NAME' type='xs:string' use='required'/> <xs:attribute name='MANUAL' type='xs:boolean' use='optional' /> <xs:attribute name='RESTRICTED' type='xs:boolean' use='optional' /> <xs:attribute name='VISIBLE' type='xs:boolean' use='optional' /> </xs:complexType> </xs:element> <xs:element name='attribute_registry'> <xs:complexType> <xs:choice minOccurs='0' maxOccurs='unbounded'> <xs:element ref='attribute_name'/> </xs:choice> <xs:attribute name='RESTRICTED' type='xs:boolean' use='optional' /> <xs:attribute name='SHOW_ATTRIBUTES' use='optional'> <xs:simpleType> <xs:restriction base='xs:string'> <xs:enumeration value='selected'/> <xs:enumeration value='hide'/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:complexType> </xs:element> <xs:element name='attribute_layout'> <xs:complexType> <xs:attribute name='NAME_WIDTH' type='xs:integer' use='optional'/> <xs:attribute name='VALUE_WIDTH' type='xs:integer' use='optional'/> </xs:complexType> </xs:element> <xs:element name='attribute'> <xs:complexType> <xs:attribute name='NAME' type='xs:string' use='required'/> <xs:attribute name='VALUE' type='xs:string' use='required'/> <xs:attribute name='TYPE' type='xs:string' use='optional'/> </xs:complexType> </xs:element> <!-- END ATTRIBUTES --> <xs:element name='arrowlink'> <xs:complexType> <xs:attribute name='COLOR' type='xs:string' use='optional'/> <xs:attribute name='DESTINATION' type='xs:string' use='required'/> <xs:attribute name='ENDARROW' type='xs:string' use='optional'/> <xs:attribute name='ENDINCLINATION' type='xs:string' use='optional'/> <xs:attribute name='ID' type='xs:string' use='optional'/> <xs:attribute name='STARTARROW' type='xs:string' use='optional'/> <xs:attribute name='STARTINCLINATION' type='xs:string' use='optional'/> <xs:attribute name='SOURCE_LABEL' type='xs:string' use='optional'/> <xs:attribute name='MIDDLE_LABEL' type='xs:string' use='optional'/> <xs:attribute name='TARGET_LABEL' type='xs:string' use='optional'/> <xs:attribute name='EDGE_LIKE' type='xs:boolean' use='optional'/> </xs:complexType> </xs:element> <xs:element name='cloud'> <xs:complexType> <xs:attribute name='COLOR' type='xs:string' use='optional'/> <xs:attribute name='WIDTH' type='xs:integer' use='optional'/> </xs:complexType> </xs:element> <xs:element name='edge'> <xs:complexType> <xs:attribute name='COLOR' type='xs:string' use='optional'/> <xs:attribute name='STYLE' type='xs:string' use='optional'/> <xs:attribute name='WIDTH' type='xs:string' use='optional'/> </xs:complexType> </xs:element> <xs:element name='font'> <xs:complexType> <xs:attribute name='BOLD' use='optional'> <xs:simpleType> <xs:restriction base='xs:string'> <xs:enumeration value='true'/> <xs:enumeration value='false'/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name='ITALIC' use='optional'> <xs:simpleType> <xs:restriction base='xs:string'> <xs:enumeration value='true'/> <xs:enumeration value='false'/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name='NAME' type='xs:string' use='optional'/> <xs:attribute name='SIZE' type='xs:integer' use='optional'/> </xs:complexType> </xs:element> <xs:element name='hook'> <xs:complexType> <xs:sequence> <xs:element ref='Parameters' minOccurs='0' maxOccurs='1'/> <xs:element ref='text' minOccurs='0' maxOccurs='1'/> </xs:sequence> <xs:attribute name='NAME' type='xs:string' use='required'/> <!-- for embedded images NAME="ExternalObject" --> <xs:attribute name='URI' type='xs:anyURI' use='optional'/> <xs:attribute name='SIZE' type='xs:decimal' use='optional'/> <!-- for map config info NAME="MapStyle" --> <xs:attribute name='max_node_width' type='xs:integer' use='optional'/> <xs:attribute name='zoom' type='xs:decimal' use='optional'/> <!-- for equations NAME="plugins/latex/LatexNodeHook.properties" --> <xs:attribute name='EQUATION' type='xs:string' use='optional'/> </xs:complexType> </xs:element> <xs:element name='icon'> <xs:complexType> <xs:attribute name='BUILTIN' type='xs:string' use='required'/> </xs:complexType> </xs:element> <xs:element name='html'> <xs:complexType> <xs:sequence> <!--Anything that is valid XML, but should be http://www.w3.org/1999/xhtml --> <xs:any namespace="##any" minOccurs="0" maxOccurs="unbounded" processContents="skip"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name='richcontent'> <xs:complexType> <!-- And contains XHTML as unique child:--> <xs:sequence> <xs:element ref='html' minOccurs='1' maxOccurs='1'/> </xs:sequence> <!--Currently, only NODE or NOTE is allowed.--> <xs:attribute name='TYPE' use='required'> <xs:simpleType> <xs:restriction base='xs:string'> <xs:enumeration value='NODE'/> <xs:enumeration value='NOTE'/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:complexType> </xs:element> <xs:element name='map'> <xs:complexType> <xs:sequence> <xs:element ref='attribute_registry' minOccurs='0' maxOccurs='1'/> <xs:element ref='node' minOccurs='1' maxOccurs='1' /> </xs:sequence> <xs:attribute name='version' type='xs:string' use='required'/> </xs:complexType> </xs:element> <xs:element name='node'> <xs:complexType> <xs:choice minOccurs='0' maxOccurs='unbounded'> <xs:element ref='arrowlink'/> <xs:element ref='cloud'/> <xs:element ref='edge'/> <xs:element ref='font'/> <xs:element ref='hook'/> <xs:element ref='icon'/> <xs:element ref='node'/> <!-- For nodes with extended formatting content or for notes to nodes. --> <xs:element ref='richcontent'/> <xs:element ref='attribute_layout'/> <xs:element ref='attribute'/> </xs:choice> <xs:attribute name='BACKGROUND_COLOR' type='xs:string' use='optional'/> <xs:attribute name='COLOR' type='xs:string' use='optional'/> <xs:attribute name='FOLDED' use='optional'> <xs:simpleType> <xs:restriction base='xs:string'> <xs:enumeration value='true'/> <xs:enumeration value='false'/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name='ID' type='xs:ID' use='optional'/> <xs:attribute name='LINK' type='xs:string' use='optional'/> <xs:attribute name='POSITION' use='optional'> <xs:simpleType> <xs:restriction base='xs:string'> <xs:enumeration value='left'/> <xs:enumeration value='right'/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name='STYLE' type='xs:string' use='optional'/> <xs:attribute name='TEXT' type='xs:string' use='optional'/> <xs:attribute name='LOCALIZED_TEXT' type='xs:string' use='optional'/> <xs:attribute name='TYPE' type='xs:string' use='optional'/> <xs:attribute name='CREATED' type='xs:integer' use='optional'/> <xs:attribute name='MODIFIED' type='xs:integer' use='optional'/> <xs:attribute name='HGAP' type='xs:integer' use='optional'/> <xs:attribute name='VGAP' type='xs:integer' use='optional'/> <xs:attribute name='VSHIFT' type='xs:integer' use='optional'/> <xs:attribute name='ENCRYPTED_CONTENT' type='xs:string' use='optional'/> </xs:complexType> </xs:element> </xs:schema>
Mapping between old and new format
- Attention:
- This effort is on hold until further notice (perhaps after release of version 1.2/1.3).
<?xml version="1.0" encoding="UTF-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> |
not relevant |
<xs:element name='Parameters'> <xs:complexType> <!--Is the time management plugin.--> <xs:attribute name='REMINDUSERAT' type='xs:integer' use='optional'/> </xs:complexType> </xs:element> |
Replaced by parameter node:reminder="dateTime" to node:node (this limits the number of reminders to one per node but Freeplane can't anyway handle more than one). |
<!--Used for node notes.--> <xs:element name='text'> <xs:complexType/> </xs:element> |
Obsolete - all nodes are "rich" |
<!-- BEGIN ATTRIBUTES --> <xs:element name='attribute_value'> <xs:complexType> <xs:attribute name='VALUE' type='xs:string' use='required'/> </xs:complexType> </xs:element> <xs:element name='attribute_name'> <xs:complexType> <xs:choice minOccurs='0' maxOccurs='unbounded'> <xs:element ref='attribute_value'/> </xs:choice> <xs:attribute name='NAME' type='xs:string' use='required'/> <xs:attribute name='MANUAL' type='xs:boolean' use='optional' /> <xs:attribute name='RESTRICTED' type='xs:boolean' use='optional' /> <xs:attribute name='VISIBLE' type='xs:boolean' use='optional' /> </xs:complexType> </xs:element> <xs:element name='attribute_registry'> <xs:complexType> <xs:choice minOccurs='0' maxOccurs='unbounded'> <xs:element ref='attribute_name'/> </xs:choice> <xs:attribute name='RESTRICTED' type='xs:boolean' use='optional' /> <xs:attribute name='SHOW_ATTRIBUTES' use='optional'> <xs:simpleType> <xs:restriction base='xs:string'> <xs:enumeration value='selected'/> <xs:enumeration value='hide'/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:complexType> </xs:element> <xs:element name='attribute_layout'> <xs:complexType> <xs:attribute name='NAME_WIDTH' type='xs:integer' use='optional'/> <xs:attribute name='VALUE_WIDTH' type='xs:integer' use='optional'/> </xs:complexType> </xs:element> <xs:element name='attribute'> <xs:complexType> <xs:attribute name='NAME' type='xs:string' use='required'/> <xs:attribute name='VALUE' type='xs:string' use='required'/> </xs:complexType> </xs:element> <!-- END ATTRIBUTES --> |
The whole attribute will be replaced as follows. First define the sets of attributes at the map level:
<map:attributes attribute:restricted="false|true"> <attribute:attribute meta:name="..." attribute:restricted="false|true" attribute:selected="false|true"> <attribute:value>some value</attribute:value> ... </attribute:attribute> ... </map:attributes> And then assign the attributes at the node level: <node:attributes attribute:name-width="..." attribute:value-width="..."> <attribute:attribute meta:name="...">some value</attribute:attribute> ... </node:attributes> |
<xs:element name='arrowlink'> <xs:complexType> <xs:attribute name='COLOR' type='xs:string' use='optional'/> <xs:attribute name='DESTINATION' type='xs:string' use='required'/> <xs:attribute name='ENDARROW' type='xs:string' use='optional'/> <xs:attribute name='ENDINCLINATION' type='xs:string' use='optional'/> <xs:attribute name='ID' type='xs:string' use='optional'/> <xs:attribute name='STARTARROW' type='xs:string' use='optional'/> <xs:attribute name='STARTINCLINATION' type='xs:string' use='optional'/> <xs:attribute name='SOURCE_LABEL' type='xs:string' use='optional'/> <xs:attribute name='MIDDLE_LABEL' type='xs:string' use='optional'/> <xs:attribute name='TARGET_LABEL' type='xs:string' use='optional'/> <xs:attribute name='EDGE_LIKE' type='xs:boolean' use='optional'/> </xs:complexType> </xs:element> |
Replaced by element <draw:connector ... /> with attributes
draw:start-shape="ID" draw:color="#rrggbb" draw:end-shape="ID" map:start-arrow="true|false" map:end-arrow="true|false" xml:id="ID" map:start-inclination="int;int;" map:end-inclination="int;int;" draw:style="normal|edge-like" And with possible sub-nodes: <map:start-label>...</map:start-label> <svg:title>...</svg:title> (or svg:desc?!) <map:end-label>...</map:end-label> |
<xs:element name='cloud'> <xs:complexType> <xs:attribute name='COLOR' type='xs:string' use='optional'/> <xs:attribute name='WIDTH' type='xs:integer' use='optional'/> </xs:complexType> </xs:element> |
Replaced by element <node:cloud ... /> with attributes
draw:color="#rrggbb" (WIDTH parameter isn't used currently and is always 0) |
<xs:element name='edge'> <xs:complexType> <xs:attribute name='COLOR' type='xs:string' use='optional'/> <xs:attribute name='STYLE' type='xs:string' use='optional'/> <xs:attribute name='WIDTH' type='xs:string' use='optional'/> </xs:complexType> </xs:element> |
Replaced by element <node:edge ... /> with attributes
draw:color="#rrggbb" draw:style="linear|sharp-linear|bezier|sharp-bezier|horizontal" draw:stroke="solid|none" svg:stroke-width="length" (Freeplane uses only integers)
|
<xs:element name='font'> <xs:complexType> <xs:attribute name='BOLD' use='optional'> <xs:simpleType> <xs:restriction base='xs:string'> <xs:enumeration value='true'/> <xs:enumeration value='false'/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name='ITALIC' use='optional'> <xs:simpleType> <xs:restriction base='xs:string'> <xs:enumeration value='true'/> <xs:enumeration value='false'/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name='NAME' type='xs:string' use='optional'/> <xs:attribute name='SIZE' type='xs:integer' use='optional'/> </xs:complexType> </xs:element> |
Replaced by element <style:text-properties ... /> with attributes
fo:color="#rrggbb" fo:font-weight="normal|bold" fo:font-style="normal|italic" fo:font-family="name of the font" fo:font-size="integer"
|
<xs:element name='hook'> <xs:complexType> <xs:sequence> <xs:element ref='Parameters' minOccurs='0' maxOccurs='1'/> <xs:element ref='text' minOccurs='0' maxOccurs='1'/> </xs:sequence> <xs:attribute name='NAME' type='xs:string' use='required'/> <!-- for embedded images NAME="ExternalObject" --> <xs:attribute name='URI' type='xs:anyURI' use='optional'/> <xs:attribute name='SIZE' type='xs:decimal' use='optional'/> |
Replaced by the following element:
<draw:frame draw:transform="scale(sx [sy])"> <draw:image xlink:href="URL"/> </draw:frame>
|
<!-- for map config info NAME="MapStyle" --> <xs:attribute name='max_node_width' type='xs:integer' use='optional'/> <xs:attribute name='zoom' type='xs:decimal' use='optional'/> |
It actually depends if those settings shall be different from map to map (within a same file) or the same for the whole file.
In the first case, they would be attributes to the <map:map> element: node:max-width="integer" map:zoom="percentage" And in the 2nd case, they would be office settings: <config:config-item config:name="NodeMaxWidth" config:type="int">40</config:config-item> <config:config-item config:name="MapZoom" config:type="int">150</config:config-item> TBD |
<!-- for equations NAME="plugins/latex/LatexNodeHook.properties" --> <xs:attribute name='EQUATION' type='xs:string' use='optional'/> </xs:complexType> </xs:element> |
Plugin hooks (like Latex) are replaced by an element <node:content> with a corresponding namespace definition, like in:
<node:content xmlns:latex="plugins/latex/LatexNodeHook.properties"> <latex:equation> <![CDATA[some equation in Latex]]> </latex:equation> </node:content> As shown here, in the case of non-XML dialect, the use of a CDATA section is highly recommended. |
<xs:element name='icon'> <xs:complexType> <xs:attribute name='BUILTIN' type='xs:string' use='required'/> </xs:complexType> </xs:element> |
Replaced by element <node:icon ... /> with attributes
node:icon-name="..." (a string) |
<xs:element name='html'> <xs:complexType> <xs:sequence> <!--Anything that is valid XML, but should be http://www.w3.org/1999/xhtml --> <xs:any namespace="##any" minOccurs="0" maxOccurs="unbounded" processContents="skip"/> </xs:sequence> </xs:complexType> </xs:element> |
Obsolete, as all nodes are rich content... |
<xs:element name='richcontent'> <xs:complexType> <!-- And contains XHTML as unique child:--> <xs:sequence> <xs:element ref='html' minOccurs='1' maxOccurs='1'/> </xs:sequence> <!--Currently, only NODE or NOTE is allowed.--> <xs:attribute name='TYPE' use='required'> <xs:simpleType> <xs:restriction base='xs:string'> <xs:enumeration value='NODE'/> <xs:enumeration value='NOTE'/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:complexType> </xs:element> |
Replaced by either
<node:content xmlns:xhtml="http://www.w3.org/1999/xhtml"> <xhtml:body> ... </xhtml:body> or <office:annotation xmlns:xhtml="http://www.w3.org/1999/xhtml"> <xhtml:body> ... </xhtml:body>
|
<xs:element name='map'> <xs:complexType> <xs:sequence> <xs:element ref='attribute_registry' minOccurs='0' maxOccurs='1'/> <xs:element ref='node' minOccurs='1' maxOccurs='1' /> </xs:sequence> <xs:attribute name='version' type='xs:string' use='required'/> </xs:complexType> </xs:element> |
Replaced by element <map:map> |
<xs:element name='node'> |
Replaced by element <node:node> |
<xs:complexType> <xs:choice minOccurs='0' maxOccurs='unbounded'> <xs:element ref='arrowlink'/> <xs:element ref='cloud'/> <xs:element ref='edge'/> <xs:element ref='font'/> <xs:element ref='hook'/> <xs:element ref='icon'/> <xs:element ref='node'/> <!-- For nodes with extended formatting content or for notes. --> <xs:element ref='richcontent'/> <xs:element ref='attribute_layout'/> <xs:element ref='attribute'/> </xs:choice> |
Mapped obviously as described above... |
<xs:attribute name='BACKGROUND_COLOR' type='xs:string' use='optional'/> |
Replaced by attribute draw:fill-color="#rrggbb" |
<xs:attribute name='COLOR' type='xs:string' use='optional'/> |
It's actually the color of the font and has been moved to the corresponding element <style:text-properties ... />. |
<xs:attribute name='FOLDED' use='optional'> <xs:simpleType> <xs:restriction base='xs:string'> <xs:enumeration value='true'/> <xs:enumeration value='false'/> </xs:restriction> </xs:simpleType> </xs:attribute> |
Replaced by attribute node:folded="false|true" |
<xs:attribute name='ID' type='xs:ID' use='optional'/> |
Replaced by attribute xml:id="ID" |
<xs:attribute name='LINK' type='xs:string' use='optional'/> |
Replaced by attribute xlink:href="URL" |
<xs:attribute name='POSITION' use='optional'> <xs:simpleType> <xs:restriction base='xs:string'> <xs:enumeration value='left'/> <xs:enumeration value='right'/> </xs:restriction> </xs:simpleType> </xs:attribute> |
Replaced by attribute node:side="left|right" |
<xs:attribute name='STYLE' type='xs:string' use='optional'/> |
Replaced by attribute draw:style="fork|bubble" |
<xs:attribute name='TEXT' type='xs:string' use='optional'/> |
Obsolete. |
<xs:attribute name='CREATED' type='xs:integer' use='optional'/> <xs:attribute name='MODIFIED' type='xs:integer' use='optional'/> |
Replaced respectively by attributes node:inserted="dateTime" and node:modified="dateTime"
|
<xs:attribute name='HGAP' type='xs:integer' use='optional'/> <xs:attribute name='VGAP' type='xs:integer' use='optional'/> <xs:attribute name='VSHIFT' type='xs:integer' use='optional'/> |
Replaced respectively by attributes node:margin-horizontal="integer", node:margin-vertical="integer" and node:shift-vertical="integer" |
<xs:attribute name='ENCRYPTED_CONTENT' type='xs:string' use='optional'/> |
Replaced by attribute node:encrypted="false|true" |
</xs:complexType> </xs:element> </xs:schema> |