Firstly, some important contextual points re this technique:<\/p>\n
This method is particularly useful for adding references to glossary terms, frequently-used sources, or oft-mentioned people and places; in fact anything where the destination note name makes logical anchor text for the link.<\/p>\n
Creating a new link (and possibly note) using the ziplinks method<\/b><\/p>\n
To use this method to make a named note, precede the name of the note with two square brackets and follow its name with two square brackets like this Notes created via this method observe document settings to expand vertically or horizontally if additional space is required for the name. In addition, such notes are positioned to avoid adornments as well as other notes.<\/p>\n The new note\\'s $CreatedFrom<\/a> attribute contains the path to the note that created the note (i.e. the source of the creating text link).<\/p>\n Option-clicking in the note name popup menu autocompletes the chosen target but leaves the creation process open for further editing. For example, after typing The menu Format ▸ Text<\/a> ▸ Ziplinks toggles whether the selected note(s) allow link creation via the ziplinking method ($Ziplinks<\/a>).<\/p>\n From v10.2.0, new Zip-method links that create a new target note apply the ONADD action of the new note\\'s container.<\/p>\n Keystrokes and syntax for text link creation via the Ziplinking method<\/b><\/p>\n Once links creation is invoked the following logic applies:<\/p>\n\t In documents with many notes it makes sense to type a few characters to avoid excessive numbers of possible matches being listed.<\/p>\n When typing link input, Tinderbox will show a pop-up list of related note names to the left of the text pane; the list displays all notes that contain the input string, not just those that begin with the string. Choose any of these listed notes to make the link (without further typing); or, press the up-arrow or down-arrow keys to select the preferred target note then press the Return key (↩) to complete the link. In more detail:<\/p>\n Linking to a note in a specified container<\/b><\/p>\n If wishing to use the method make a link to a note in a different container, type the container path in the link input:<\/p>\n\t Additional logical syntax applies when typing paths:<\/p>\n\t Locale-based sorting of target option listings<\/b>. When typing link input on an English locale system, diacritics are ignored when looking for matches. However, the match popup menu takes into account the user\\'s locale, so \\'étude\\' will sort appropriately for French users and \\'Ångstrom\\' will sort correctly in Norway. Bear in mind the process works off the OS locale so if working under one locale and using accented characters from a different language\/locale sorting is still locale based.<\/p>\n Link type<\/b>. A link created via this method always has no link type assigned, or rather the type \\\"*untitled\\\" (i.e. no link type<\/a>). If needed, use the Browse Links<\/a> or Roadmap<\/a> dialogs to set a different link type.<\/p>\n Adding anchor text for the new link<\/b><\/p>\n The method syntax allows for specifying link anchor text, using a pipe (\\'|\\') symbol delimiter. The following will replace the brackets with the anchor text and link it to the designated note.:<\/p>\n\t If also needing to specify additional $Text for the note (see below), it goes after the optional anchor text:<\/p>\n\t Adding text to the target note<\/b><\/p>\n To aid rapid note-taking, it is possible to also set or add to the $Text of a the link\\'s target note:<\/p>\n\t If the note already exists, the new text is appended to the note\\'s existing $Text. Otherwise, the supplied text forms the entire $Text of the new note; where no text is supplied, new notes generated by this method have no $Text.<\/p>\n There is no limit on the size of the link input string. Previously it was limited to 50 chars. If needing to add more target text than is currently supported, there is a simple alternative. Use the link method to create a link without adding any text. Then click the link. This navigates to the link target. Now add the desired $Text. Then use shortcut ⌘+\\' to navigate back to the original note. These navigation controls are also accessible from the Note<\/a> menu.<\/p>\n Target note name and anchor text<\/b><\/p>\n WARNING: even if not using the ziplinking link-creation feature<\/i>, changing a note name will affect link anchors pointing to that note, as described here<\/a>.<\/p><\/p>\n Making a backlink from the link target<\/b><\/p>\n The method can create backlinks from the destination note. [[<that note>]] will create a link to \\\"that note\\\", and then will append the name of this note to the text of \\\"that note\\\" and link the name back to this note. The mark-up needed is used as a wrapper around the entire input string. Thus:<\/p>\n\t …will create a new note called \\'New Idea\\' and link to it. If this method is mixed with other syntax variations, like so:<\/p>\n\t …will create a new note called \\'New Idea\\' and link to it via anchor text \\'great idea\\' and add a backlink with the anchor text \\'Recent innovation\\'.<\/p>\n IMPORTANT: note how the closing \\'>\\' comes at the end<\/i>, immediately before the closing \\']]\\' and not before the \\'|\\' as might be assumed if all the different parts of syntax were just chained.<\/p>\n Stamps and use of the Ziplinking method<\/b><\/p>\n If a stamp<\/a> changes the text, Tinderbox will immediately expand any ziplinking-style mark-up found in the revised text; i.e. it will parse the syntax and use the ziplinks method to create new text link(s).<\/p>\n Suppressing the Ziplinking feature<\/b><\/p>\n It can be useful to disable this feature in notes using code examples or square brackets, and the system attribute $Ziplinks<\/a> supports this behaviour. Built-in prototypes, such as \\'HTML<\/a>\\' and \\'Code<\/a>\\' have $Ziplinks set to Quick links behaviour, in older versions<\/b><\/p>\n The previous \\'Quick links<\/a>\\' behaviour using a \\\"[[\\\" trigger is described separately.<\/p>\n Presetting prototypes and locations<\/p>\n<\/b> These features can also be used when naming new notes<\/a>.<\/p>\n Prototypes<\/b>. The zip syntax \\'[[bridge#pStructure]]\\' makes a link to note \\'bridge\\' and sets its prototype to \\'pStructure\\'. If no such prototype exists, a new prototype is made in the default, i.e. Addresses<\/b>. The zip syntax \\'[[bridge@Brooklyn]]\\' makes a link to note \\'bridge\\'. If a note named \\'Brooklyn\\' exists, \\'bridge\\' takes its $Address from \\'Brooklyn\\'. If no such note exists, the $Address of \\'bridge\\' address is set to that of \\'Brooklyn\\'. Specify a note’s location by adding its address, or the name of a note that represents the location, after the @ sign. For example, “Eastgate@134 Main St., Watertown MA USA” would create a note named Eastgate and set its address, and a note named \\\"John@Boston Office\\\" would make a note named \\\"John\\\" and assign the Address of that note from the address of the note named \\\"Boston Office\\\".<\/p>",
"date_published": "2020-02-26T08:48:40+01:00",
"date_modified": "2025-06-12T08:07:56+01:00"
},
{
"id": "1749728409",
"url": "https://atbref.com/atbref10/index/Change_Log/v10_2_0b717_9_Jun_2025.html",
"title": "v10.2.0b717 (9 Jun 2025)",
"content_html": " Released 9 Jun 2025. Build number is 717.<\/p>\n Minor changes not necessarily warranting explicit mention in an aTbRef note:<\/p>\n This version is cited in the following notes:<\/p>\n Since first publishing, up to and including the current baseline Tinderbox has had 165 public releases up to the current baseline v10.0.0 released 9 June 2025. Below are their dates, where known.<\/p>\n Note that v8.2.1 superseded v8.2.0 pre-release and so v8.2.0 was never publicly released.<\/p>\n For the 6 releases since the baseline, see the Change Log<\/a>. Details of changes since the current baseline can be researched via the Change Log and the app\\'s Release Notes<\/a>.<\/p>\n Previous Tinderbox releases prior to current baseline:<\/p>\n[[like this]]<\/code>. If there is no note with this name in the document, Tinderbox will create one as the sibling<\/i> of the note being editing creating a text link with the new note\\'s $Name as the anchor text. Otherwise, if that note exists, a text link is created to the matched note.<\/p>\n[[tar<\/code> and then choosing \\\"target\\\" from the popup while pressing the option key, the text will read [[target<\/code> and wait for you to complete the link.<\/p>\n[[<\/code> shows a list of all notes in the current document.<\/blockquote>\n\t[[D<\/code> shows a list of all notes with names that contain a \\\"d\\\" (case-insensitive match).<\/blockquote>\n[[A<\/code>, Tinderbox shows all notes in the document starting with A. Typing [[\/container\/A<\/code>, Tinderbox shows only notes in the specified container. To see a list of just those notes that are siblings of this note, type [[.\/A<\/code> (note the full stop before the slash character). For more see section \\'Linking to a note in a specified container\\', below.<\/li>\n[[\/container\/note]]<\/code> <\/blockquote>\n[[\/<\/code> shows a list of all top-level containers.<\/blockquote>\n\t[[\/D<\/code> shows a list of all top-level notes that begin with a \\\"d\\\" (case-insensitive match).<\/blockquote>\n\t[[\/Dog\/<\/code> shows a list of all notes in \/Dog.<\/blockquote>\n\t[[\/Dog\/R<\/code> shows a list of all notes in \/Dog that begin with \\\"r\\\".<\/blockquote>\n\t[[.\/<\/code> shows a list of all siblings of this note.<\/blockquote>\n\t[[..\/<\/code> shows the parent of this note and all the parent\\'s siblings.<\/blockquote>\n[[note name|anchor text]]<\/code> <\/blockquote>\n[[note name|anchor::text]]<\/code> <\/blockquote>\n[[note::some new text]]<\/code> <\/blockquote>\n[[<New Idea>]]<\/code> <\/blockquote>\n[[<New Idea|great idea::Recent innovation>]]<\/code> <\/blockquote>\nfalse<\/code> for just such a reason.<\/p>\n\/Prototypes<\/code>, Prototypes container. Specify a note’s prototype by adding the prototype name after the # sign. For example, naming a note “Henderson#Person” will name the note \\\"Henderson\\\" and assign it a prototype of \\\"Person\\\". If no such prototype exists, one will be created in \/Prototypes. If the prototype container \/Prototypes does not exist, it will be created.<\/p>\n;{(\\'\/<\/code>. The straight double quote \\\"<\/code> is not yet handled correctly.<\/li>\n;{(\\'\/<\/code> (semi-colon, left curly bracket, left parenthesis, single straight quote, forward slash). The straight double quote (\\\"<\/code>) is not yet handled correctly.<\/li>\n
NOTE: for v6+ Tinderbox\\'s codebase was re-written and development ported to Xcode.
<\/li>\n