iThoughts hyperlinking enables you to create hyperlinks to maps and specific topics within maps. A good use for this is to have an 'overview' map with various topics that link off to more detailed maps. Hyperlinks can also work from within other apps.

 

iOS - linking to a map.

Click to expand the images below:

  • Long press on the target map name in the map picker then choose 'Copy Link'.
  • Tap on the source topic and choose 'Paste'
  • To open the link, tap on small arrow symbol at the edge of the topic (or long press it to open automatically)

NB: The link is a 'relative path' which means that so long as the source and target map stay in the same location relative to each other, the the link will continue to work. If the target map is moved or renamed the link will be broken. If the source map is moved (relative to the target) then the link will be broken. Basically, they need to be moved around as a pair if the link is to continue to function.

 

iOS - linking to a specific topic within a map.

Click to expand the images below:

  • Tap on the target target topic then choose 'Copy' and then 'Link'
  • Tap on the source topic and choose 'Paste'
  • To open the link, tap on small arrow symbol at the edge of the topic (or long press it to open automatically)

NB: The link now has a long textual string appended to it. This is called a UUID - which is basically a unique ID representing a topic.


Go Back

If a link (from another map) is opened then the map picker toolbar button turns into a 'back button' - enabling you to return to the original map. If you don't want to go back but open a new map entirely, long press the back button.

 
 

 

OSX - linking to a map

Drag/drop an ITMZ (or any other) file from Finder onto a map or topic to create a link to that document.

NB: The link will be a relative path (as in the iOS version.)

NB2: The source map (where you've dragged the link to) will need to have been saved (it can't be 'untitled') This is because I can't figure out a relative path unless I know where both maps are located and an untitled/saved map doesn't yet have a location.

 

OSX - linking to a specific topic within a map

Right click on the target topic and choose 'Copy As' -> 'Link'. This will place a link to that topic within that map on the clipboard. This can then be pasted ONTO a topic or the canvas. DO NOT paste it INTO the text of a topic or note or into the Topic Hyperlink field itself (read the 'Gotchas' below)

 
 

NB: If you follow a link to another map you can hit ESC to return to the original map - so long as you haven't interacted with the target map (i.e. changed the selection)

 

 

iOS and OS X link 'compatibility'

This is where things get 'interesting'. Because the links (above) are all 'relative paths' then the links should work just fine on iOS and OS X (so long as the same folder structure is in place on both devices.) This is generally the case if you are syncing using Dropbox. However, if you link to a map that is not present on the other device then the link will be broken. This happens most often when you link to a non ITMZ document on your Mac - that document will not be on your iOS device and so the link will not work. Even if you link to a document that is on Dropbox, the link will not work on iOS. This is because iThoughts on iOS will only download mind map documents from Dropbox.

 

Those gotchas I mentioned.

When you copy a link to a topic onto the clipboard, the link will be an absolute link - for example:

[iOS] thoughts://Maps/MyDetailMaps/MyDetailMap1#20062C45-763E-43F9-A819-CC898FDCB84A

[OSX] ithoughts:/Users/craigscott/Dropbox/linking/MyDetailMaps/MyDetailMap1?topic=20062C45-763E-43F9-A819-CC898FDCB84A

 

The advantage of the links above is that they can then be pasted into other apps and they'll work. The disadvantage is that they will not really work on different devices. For example, iOS has no concept of /Users/craigscott/Dropbox. For this reason, when a link is pasted ONTO a topic or map it is converted to be a 'relative path' (without the ithoughts: stuff at the start.) This means it will work on both iOS and OS X. However, if you edit a topic's text and paste the link INTO it then it will be inserted in its entirety (meaning it will work on iOS - but not on OS X.) The same is true if the link is pasted INTO the notes field - and even INTO the hyperlink field.

ADVICE: Always paste links ONTO topics or the canvas and never INTO topic text, notes or hyperlink fields.

 

iOS - linking TO iThoughts FROM another app.

The following example show how you can paste a link into the notes field in the calendar app.

  • Copy the link as described above
  • Switch into the Calendar app, create a new entry then paste the link into the notes.

NB: The link will open on iOS - but not on OS X for the reasons outlined in gotchas above.

 

One more cool trick - linking to emails

On OSX, drag and drop an email message ONTO a topic or the canvas. It will create a link to that message which will then open when clicked. Best bit - this will work on iOS too (so long as you've got the same email message on your iOS device then it'll open.) Unfortunately, you can't create links to messages on iOS (Apple say NO.)