The Roadmap pop-over is called from the View menu or from the note's main view icon's pop-up menu. The Roadmap lets you see all of the internal links leading to or from a selected space—the local area of a complex hypertext (web links out of the document are not included. Aliases have their own Roadmap, not that of their original. The Roadmap not only gives and overview of inbound and outbound links but also allows exploration of the local hypertext (i.e. the TBX's content). Links out of the current document, e.g. web links, are not visualised in the Roadmap. RTF-based 'Smart' links are also omitted from the listing.
The left column lists all notes that link into the current note note; the column header lists a count of the inbound links. The right column lists all the note's outbound links, again with a count in the column header. To change the focus of a Roadmap, double-click any item in either column. The Roadmap will change to focus on the selected note, with links leading in and out of it in the two columns. The current window's main view will update to the selected note, if it is in scope; note that if the pop-up is torn off the text pane stops following focus of the view.
From v8.2.1, Roadmap allows editing of the properties of the selected link. At the top of the Roadmap, Tinderbox additionally shows the display name of the note for which inbound and outbound links are currently being shown. The tooltip of this label is the full path of that note (which will include the name of the note.
Note: if the main view is a map, selection/focus can move to other items on the current map but not to notes on other maps. In the latter case, only the Roadmap updates.
The Roadmap title shows the $DisplayName of the notes whose data is being displayed. Each listed link item shows:
- Line one. The $DisplayName of the linked note (in $Color) and at right its $Badge (if one is set).
- Line two. The link type of the link and, for text links only, that link's anchor text.
- Roll-over tooltip for either line: the full path of the linked note.
If the Outline Document Settings for 'Darker colors' is ticked, the item is rendered in a darker tint of their $Color.
Include Prototype Links. A tick-box (ticked by default) at bottom left allows prototype-type links to be filtered out. Prototype assignments are stored, in the TBX, as links but are not normally used in maps and excluded from link count attributes. However, leaving such links in the last can help tracing prototype-based relationships in a document.
Button focus of [title of calling note] pop-over. Located at middle-bottom of the pop-over, this refocuses the pop-over on the note from which the pop-over was opened.
If double-clicking to follow a link and if the destination is not visible in the current view, Tinderbox will refocus the view so as to make it visible. This makes it easier to follow link-based trails around a document.
The Roadmap pop-up can be torn off into a stand-alone window. Such windows last until the end of the current session but cannot be saved to last across sessions. Tear-off Roadmaps can be useful triaging links: when torn-off, the Roadmap dialog has a button to allow you to refocus the roadmap on the selected note and the ability to see link comments.