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

^inboundTextLinks( [start, list-item-prefix, list-item-suffix, end, type] )^


Code Type: 

Code Scope of Action: 

Code First Added: 

Code Altered: 

 Creation of Links   [other codes of this type]

 item   [codes with similar scope]

 Baseline

 format"


^inboundTextLinks( ["start", "list-item-prefix", "list-item-suffix", "end", "type"] )^

returns all of the notes that have a text link (a link anchored in body text) to the current note, formatted as an unordered list, excluding prototype links.

The optional parameters allow you to format the group of links as an HTML list or table in the exact format you want, where start is text that will be inserted before all of the links, end is text that will be inserted after all of the links, list-item-prefix is text that will be inserted before each link, and list-item-suffix is text that will be inserted after each link. The type parameter restricts the scope of link inclusion and is discussed separately below. See more on altering list type or other HTML output.

If the optional start, list-item-prefix, list-item-suffix, end parameters are omitted then the default values of <ul>, <li>, </li>, </ul> are used.

The optional fifth argument, type, lets you restrict exported lists to specific link types, as in the named types seen in the TBX's Link Types palette. type my be omitted but if you do wish to use it, the preceding 4 parameters must all be specified. For example:

^inboundTextLinks("<ul>","<li>","</li>","</ul>","example")^ 

will list only inbound links of type "example". As the type argument is a regular expression, besides specifying a particular link type name, you can specify wildcard characters or lists of eligible link types, etc.

^inboundTextLinks("<ul>","<li>","</li>","</ul>","(example|untitled)")^ 

will list links of the types "untitled" and "example".

Also see ^inboundLinks^, ^inboundBasicLinks^. The logical opposite of this code is ^outboundTextLinks^.

This code exports CSS class and target based on their underlying Tinderbox link values, assuming these are actually completed; the link type value is not picked up as a class name.

If there is more than one inbound link from the same source, said link is only listed once.

New item objects source and destination may be used to indicate from where data used within the arguments is drawn.

From v.8.7.1, the export is relative to current rather than this, facilitating work with included files.



A Tinderbox Reference File : Export Codes : Export Codes - Full Listing : ^inboundTextLinks( [start, list-item-prefix, list-item-suffix, end, type] )^