xTxT Documentation

Hyperlinks

Link (/link)

The Link element generates a hyperlink, which can be used to navigate to a specified URL.

Example;

/link
Google
http://www.google.com

Generates;

<p><a href="http://www.google.com">Google</a></p>

Which renders as;

Google

Preferred Syntax

Use double-brackets on the linked text, like this;

[[http://www.google.com]]

To give the link an alternate name, insert that name between the first and second brackets;

[Google[http://www.google.com]]

To target that link to a specific window, specify the target between the ending brackets;

[[http://www.google.com]_blank]

Alternate Syntax

Hyperlinks are specified using the pipe symbol. The Hyperlink specification must be placed at the end of the line, as follows;

This is some hyperlinked text|http://www.yahoo.com

Targeted Hyperlinks

A second pipe delimiter can be used to specify an href target

This is some hyperlinked text|http://www.yahoo.com|_blank

Use a carriage return to separate the text you want hyperlinked from the rest of the paragraph.

This is some 
hyperlinked|http://www.yahoo.com|_blank
text

Important Notes

Using the Pipe character in regular text

Note; if you want to include a normal pipe character in your text content, you can use an HTML entity instead;

&#166;
&brvbar;

Host Notification and Link Changes

Before rendering a link, xTxT notifies its host of the event, and gives the host a chance to make modifications to the link.

This means that the host may choose to modify the link, text, target, or other factors.

See host integration