Contents: Introduction Link Syntax Plain links Links with cover text Links to pages on this site Links to page sections or anchors Define an anchor Link to an anchor Links to non-html files on this site Inline images Examples Anchor 'foo'

Introduction [edit section]

One of the strengths of TBWiki is the ability to add links to other pages or external sites very easily. Also, it is easy to refer to downloadable content and to place images inline on a page as well.

Link Syntax [edit section]

Plain links [edit section]

Here is the syntax for creating links:

A URL which is placed "in the open" on a page will be converted into a link to the referenced site. The following URL types are recognized:

• http:
• mailto:
• ftp:
• media: or Media:
• image: or Image:

Here's an example:

• http://www.google.com/ => http://www.google.com/ - a plain external link

Most other links are created using double-brackets.

Links with cover text [edit section]

If you want to display different text for a link, in place of the URL, place the reference in double-brackets, followed by a vertical bar, then the cover text.

Here's an example:

• [[http://www.python.org/ |python web site]] => python web site - an external link with cover text

Links to pages on this site [edit section]

To reference a page on this site, just put the name of the page (with or without spaces) inside double brackets:

• [[FrontPage]] => FrontPage a page name on this site
• [[FrontPage|the TBWiki home page]] => the TBWiki home page - a page name with cover text
• [[page with spaces]] => page with spaces - a page name with spaces

Links to page sections or anchors [edit section]

Every header on a page creates a section (in HTML terms, an anchor) You can refer to a section or anchor on the same page using '#<section name>' or '#<anchor name'

• [[#Examples]] => #Examples - link to 'Examples' section on this page
• [[#Examples|the example section]] => the example section - section link with cover text
• [[FrontPage#Working_Areas]] => FrontPage#Working_Areas - section link on another page

Define an anchor [edit section]

You can create an named anchor (called 'foo') on a page with {{HTML(<a name="foo"></a>)}}

Link to an anchor [edit section]

• [[#foo]] => #foo - link to anchor 'foo' on this page
• [[FrontPage#foo]] => FrontPage#foo - link to anchor foo on FrontPage

Links to non-html files on this site [edit section]

• [ [media:bird-image.jpg]] => media:bird-image.jpg a link to non-html content on this site
• [ [media:bird-image.jpg|a neat bird image]] => a neat bird image - a link to non-html content, with cover text

Inline images [edit section]

• [[image:bird-image.jpg]] => place an image inline on this page

See DocImages for different attributes you can use for to control image output (e.g. size, alternate text).

Examples [edit section]

See the TestLinks page in split mode

Anchor 'foo' [edit section]

Here is the actual definition of anchor 'foo'