This version is out of date, covering development from v8.0.0 to v8.x.x. It is maintained here only for inbound reference links from elsewhere. It is no longer actively updated.

Jump to the current version of aTbRef

Tinderbox v8 Icon

linkTypes.xml

This file describes/defines the default set of link types for use in Tinderbox files. A colour may also be defined: the 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.

Do not 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 does not 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="agree" color="#000000" />
   <link name="disagree" color="#000000" />
   <link name="clarify" color="#000000" />
   <
   <
   <link name="exception" color="#000000" />
   <link name="response" color="#000000" />
</linkTypes>

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) do not 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: