This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon

linkTypes.xml

This file describes/defines the default set of link types for use in Tinderbox files. A colour may also be defined - default is black (#000000). Visibility of individual types in map views may not be set here but should be done via the Link Types pane of the Attributes dialog.

Don't forget you can save your customised files outside the application, rather than overwriting the application's default file inside the package.

The application should be re-started after editing these files to ensure changes are detected.

Hierarchy of inheritance

The link types included in a new TBX file are defined by the 'linkTypes.xml' file. This file resides inside the Tinderbox application package (i.e. most users will never see it). To assist the user Tinderbox also checks this location:

~Library/Application Support/Tinderbox/ 

…and if a copy of the file is found there, then it takes precedence over the application's default version of the file. Note: if the folder doesn't exist, just make one of the appropriate name. As Tinderbox offers is this 'external' location, more safely accessible to the user, you are advised to use the latter for customisation of link types. This avoids the possibility of a mistaken edit inside the application package that might upset Tinderbox as a whole.

File syntax

This is the default set of link types:

<linkTypes version="1">
   <link name="*untitled" label="" color="#000000" required="true" />
   <link name="prototype" color="#993333" required="true" />
   <link name="note" color="#666666" required="true" />
   <link name="note+" color="#444444" required="true" />
   <link name="response" color="#000000" />
   <link name="agree" color="#000000" />
   <link name="disagree" color="#000000" />
   <link name="clarify" color="#000000" />
   <link name="update" color="#000000" />
   <link name="example" color="#000000" />
   <link name="exception" color="#000000" />
   <link name="response" color="#000000" />
</linkTypes>

 

Note that 'response' is listed twice - this is doubtless an oversight, not harmful to function and not required when drafting custom versions of this file.

The full allowable <link> syntax is this:

<linkType name="*untitled" label="" visible="1" showLabel="0" color="#000000" style="0" required="true" /> 

The 'showLabel' and 'style' parameters were added after the original configuration. so, although the application defaults (above) don't use these additions you may safely use them in custom link files.

Note that 'internal' links such as basic links and text links can have target, title and class info set via the create/browse links dialogs just you would with an 'external' (web) link. This is pertinent if the data is to be exported as HTML.

Syntax for linkTypes.xml file:


Possible relevant notes (via "Similar Notes" feature):


A Tinderbox Reference File : Tinderbox File Types : Configuration Files : linkTypes.xml