{{TableOfContents}}
= Introduction =
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 =
== Plain links ==
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 ==
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]] => [[http://www.python.org|python web site]] -  an external link with cover text


== Links to pages on this site ==
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]] => [[FrontPage|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 ==
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]] => [[#Examples|the example section]] - section link with cover text
 * [''''''[FrontPage#Working_Areas]] => [[FrontPage#Working_Areas]] - section link on another page

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

=== Link to an anchor ===
 * [''''''[#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 ==
 * [ [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]] => [[media:bird-image.jpg|a neat bird image]] - a link to non-html content, with cover text

== Inline images ==
 * [''''''[image:bird-image.jpg]] => [[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 =
See [[TestLinks?action=split|the TestLinks page in split mode]]

== Anchor 'foo' ==
Here is the actual definition of anchor {{HTML(<a name="foo"></a>)}}'foo'