The Link shortcode will insert a text link to the mirror into your blog.

[[my_link mirror=???; url=???; {alias=???;} {list=???; } {pri=???; } {sec=???; } {ter=???; }]] Some user supplied text [[/my_link]]

—  —or—  —

[[my_link mirror=???;  id=???; {alias=???;} {list=???; } {pri=???; } {sec=???; } {ter=???; }]] Some user supplied text [[/my_link]]

—  —or—  —

[[my_link mirror=???; url=???; {alias=???;} {list=???; } {pri=???; } {sec=???; } {ter=???; } {prefix=”some user text”; } {link=”more user text”; } {postfix=”final user text”; }]] 

—  —or—  —

[[my_link mirror=???;  id=???; {alias=???;} {list=???; } {pri=???; } {sec=???; } {ter=???; } {prefix=”some user text”; } {link=”more user text”; } {postfix=”final user text”; }]] 

Mandatory:

• mirror – The Mirror number or Mirror name.  For example, either “3” or “mirror‑3”.

• Either or both of –
  • id    – The Resource ID. If the Resource ID does not exist, an error is generated.  For the second etc. mirror in one blog, “@resource_id” may be used to specify the most recent Resource ID in the same post or page.
  • url  – The Nominal URL.  Will be resolved to a Resource ID in accordance with the Filex associated with this mirror.  If the Resource ID does not exist, it will be created. If there is no entry for this Resource ID at this Mirror, an entry will be created associating this Resource ID with the Resource Name using the Resource Name Filex for this Mirror.
• Either of –
  • link    – The text which will appear in the link.  No following text and closing shortcode allowed.
  • After the shortcode, the text which will appear in the link, followed by a closing shortcode. The prefix, link, and postfix options are not allowed.

Optional:

• Any or all or none of –
  • alias – Resource Name.  If present, this overrides any Resource Name association elsewhere, such as in an Alias List associated with the Mirror.
  • list    – An Alias List.  If present, this overrides any Alias List association elsewhere, such as an Alias List associated with the Mirror.
  • add   – An Alias List.  Add the association of Resource ID with Resource Name to the specified Alias List, if no such entry is on the list.
• Any or all or none of –
  • pri – A Primary Branch name or a slash-terminated Primary Branch string.  If present, this overrides any Primary Branch association elsewhere, such as a Primary Branch associated with the Mirror.
  • sec – A Secondary Branch name or a slash-terminated Secondary Branch string.  If present, this overrides any Secondary Branch association elsewhere, such as a Secondary Branch associated with the Mirror.
  • ter – A Tertiary Branch name or a slash-terminated Tertiary Branch string.  If present, this overrides any Tertiary Branch association elsewhere, such as a Tertiary Branch associated with the Mirror.
  • Only if link is present,  either or neither of –
    • prefix   – Text which will appear before the link, in the same line.
    • postfix  – Text which will appear after the link, in the same line.