This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon

^inboundLinks( start, list-item-prefix, list-item-suffix, end )^

Code Type: 

Code Scope of Action: 

Code First Added: 

Code Altered: 

 Creation of Links   [other codes of this type]

 item   [codes with similar scope]

 Already in v5.0.0


^inboundLinks( "start", "list-item-prefix", "list-item-suffix", "end" )^

returns all of the notes that have basic links to the current note, formatted as an unordered list, except prototype links. The logical counterpart of this code is ^basicLinks^. This code does not include inbound text links; unlike the case with ^basicLinks^ (where such links are in the body text and arguable already 'listed'), there is no method to include inbound text links in the overall inbound link list. There is no single code to list all inbound links.

This allows you to format the group of links as an HTML list or table in the exact format you want, where "start" is quoted 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.

Mark-up elements embedded in ^inboundLinks^ are evaluated.

Exported links use the CSS class and target based on their underlying Tinderbox link values, if one is specified; the link type value is not picked up as a class name.

Note that unlike other link in/outbound link codes this code and ^basicLinks^ do not offer an option link type filter.

Item objects source and destination may be used in expressions to indicate from where data used within the expression's arguments is drawn.

Originals and aliases export their own basic links (i.e. aliases can differ), but from v5.9.1 if an alias has no in/outbound basic links it will export those of the original.

Also see ^inboundBasicLinks^, ^inboundTextLinks^.

Possible relevant notes (via "Similar Notes" feature):

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