This version is out of date, covering development from v9.5.0 to v9.7.3. 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 v9 Icon

$Name and text link anchor updating

From v9.7.0. The text link renamer is no longer active. This facility ran after a note was renamed; if the old name was identical to the source anchor of a text link, it changed the text to its new name. Unfortunately, this raised some performance and concurrency challenges that seem not to be merited by the modest benefit. (It might return.).

Below, legacy behaviour pre v9.7.0

When a note is renamed, Tinderbox scans other notes in the document for text links that refer to that note by name. If (a) the text link's destination is the renamed note, and (b) the text link's anchor text is the old name of the renamed note. This is often the desired behaviour, but may in some instances not be desirable. Indeed, be aware as even if you do not use the ziplinks method, there is currently no means to turn off this feature and renaming a note may thus destroy any user set anchors and replace it with the target note's $Name which may not be appropriate.

There is an option to disable automatic renaming is available in Document Settings: Text: Update after renaming. Automatic renaming may also be disabled on individual notes by setting the value of the new attribute $UpdateTextLinksAfterRename.

This is useful in the context of using the basic form of the ziplinks link method where a text link is based on the target note's $Name.