| t | | t | |
| <table align="right"><tr><td><div class="toc"> | | |
| Contents: | | |
| <ul> | | |
| <li><a href="#Introduction">Introduction</a></li> | | |
| <li><a href="#Link_Syntax">Link Syntax</a></li> | | |
| <ul> | | |
| <li><a href="#Plain_links">Plain links</a></li> | | |
| <li><a href="#Links_with_cover_text">Links with cover text</a></li> | | |
| <li><a href="#Links_to_pages_on_this_site">Links to pages on this site</a></li> | | |
| <li><a href="#Links_to_page_sections_or_anchors">Links to page sections or anchors</a></li> | | |
| <ul> | | |
| <li><a href="#Define_an_anchor">Define an anchor</a></li> | | |
| <li><a href="#Link_to_an_anchor">Link to an anchor</a></li> | | |
| </ul> | | |
| <li><a href="#Links_to_non-html_files_on_this_site">Links to non-html files on this site</a></li> | | |
| <li><a href="#Inline_images">Inline images</a></li> | | |
| </ul> | | |
| <li><a href="#Examples">Examples</a></li> | | |
| <ul> | | |
| <li><a href="#Anchor_'foo'">Anchor 'foo'</a></li> | | |
| </ul> | | |
| </ul> | | |
| </div></td></tr></table> | | |
| <h1><a name="Introduction">Introduction</a> | | |
| <span align=right class="section_edit_link">[<a href="/tbwiki/DocLinks?action=edit§ion=Introduction">edit section</a>]</font></span> | | |
| </h1> | | |
| 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. | | |
| <p> | | |
| <h1><a name="Link_Syntax">Link Syntax</a> | | |
| <span align=right class="section_edit_link">[<a href="/tbwiki/DocLinks?action=edit§ion=Link_Syntax">edit section</a>]</font></span> | | |
| </h1> | | |
| <h2><a name="Plain_links">Plain links</a> | | |
| <span align=right class="section_edit_link">[<a href="/tbwiki/DocLinks?action=edit§ion=Plain_links">edit section</a>]</font></span> | | |
| </h2> | | |
| Here is the syntax for creating links: | | |
| <p> | | |
| 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: | | |
| <ul><li>http: | | |
| <li>https: | | |
| <li>mailto: | | |
| <li>ftp: | | |
| <li>media: or Media: | | |
| <li>image: or Image: | | |
| </ul> | | |
| <p> | | |
| Here's an example: | | |
| <ul><li>https<b>:</b>//www.google.com/ => <a href="https://www.google.com/">https://www.google.com/</a> - a plain external link | | |
| </ul> | | |
| <p> | | |
| Most other links are created using double-brackets. | | |
| <p> | | |
| <h2><a name="Links_with_cover_text">Links with cover text</a> | | |
| <span align=right class="section_edit_link">[<a href="/tbwiki/DocLinks?action=edit§ion=Links_with_cover_text">edit section</a>]</font></span> | | |
| </h2> | | |
| 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. | | |
| <p> | | |
| Here's an example: | | |
| <ul><li>[<b></b>[http<b></b>:<b></b>//www.python.org/ |python web site]] => <a href="http://www.python.org">python web site</a> - an external link with cover text | | |
| </ul> | | |
| <p> | | |
| <h2><a name="Links_to_pages_on_this_site">Links to pages on this site</a> | | |
| <span align=right class="section_edit_link">[<a href="/tbwiki/DocLinks?action=edit§ion=Links_to_pages_on_this_site">edit section</a>]</font></span> | | |
| </h2> | | |
| To reference a page on this site, just put the name of the page (with | | |
| or without spaces) inside double brackets: | | |
| <p> | | |
| <ul><li>[<b></b>[FrontPage]] => <a href="/tbwiki/FrontPage">FrontPage</a> a page name on this site | | |
| <li>[<b></b>[FrontPage|the TBWiki home page]] => <a href="/tbwiki/FrontPage">the TBWiki home page</a> - a page name with cover text | | |
| <li>[<b></b>[page with spaces]] => <a style="color:red;" href="/tbwiki/page_with_spaces">page with spaces</a> - a page name with spaces | | |
| </ul> | | |
| <p> | | |
| <h2><a name="Links_to_page_sections_or_anchors">Links to page sections or anchors</a> | | |
| <span align=right class="section_edit_link">[<a href="/tbwiki/DocLinks?action=edit§ion=Links_to_page_sections_or_anchors">edit section</a>]</font></span> | | |
| </h2> | | |
| 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' | | |
| <p> | | |
| <ul><li>[<b></b>[#Examples]] => <a href="#Examples">#Examples</a> - link to 'Examples' section on this page | | |
| <li>[<b></b>[#Examples|the example section]] => <a href="#Examples">the example section</a> - section link with cover text | | |
| <li>[<b></b>[FrontPage#Working_Areas]] => <a href="/tbwiki/FrontPage#Working_Areas">FrontPage#Working_Areas</a> - section link on another page | | |
| </ul> | | |
| <p> | | |
| <h3><a name="Define_an_anchor">Define an anchor</a> | | |
| <span align=right class="section_edit_link">[<a href="/tbwiki/DocLinks?action=edit§ion=Define_an_anchor">edit section</a>]</font></span> | | |
| </h3> | | |
| You can create an named anchor (called 'foo') on a page | | |
| with {<b></b>{HTML(<a name="foo"></a>)}} | | |
| <p> | | |
| <h3><a name="Link_to_an_anchor">Link to an anchor</a> | | |
| <span align=right class="section_edit_link">[<a href="/tbwiki/DocLinks?action=edit§ion=Link_to_an_anchor">edit section</a>]</font></span> | | |
| </h3> | | |
| <ul><li>[<b></b>[#foo]] => <a href="#foo">#foo</a> - link to anchor 'foo' on this page | | |
| <li>[<b></b>[FrontPage#foo]] => <a href="/tbwiki/FrontPage#foo">FrontPage#foo</a> - link to anchor foo on FrontPage | | |
| </ul> | | |
| <p> | | |
| <h2><a name="Links_to_non-html_files_on_this_site">Links to non-html files on this site</a> | | |
| <span align=right class="section_edit_link">[<a href="/tbwiki/DocLinks?action=edit§ion=Links_to_non-html_files_on_this_site">edit section</a>]</font></span> | | |
| </h2> | | |
| <ul><li>[ [media:bird-image.jpg]] => <a href="/tbw-files/bird-image.jpg">media:bird-image.jpg</a> a link to non-html content on this site | | |
| <li>[ [media:bird-image.jpg|a neat bird image]] => <a href="/tbw-files/bird-image.jpg">a neat bird image</a> - a link to non-html content, with cover text | | |
| </ul> | | |
| <p> | | |
| <h2><a name="Inline_images">Inline images</a> | | |
| <span align=right class="section_edit_link">[<a href="/tbwiki/DocLinks?action=edit§ion=Inline_images">edit section</a>]</font></span> | | |
| </h2> | | |
| <ul><li>[<b></b>[image:bird-image.jpg]] => <img src="/tbw-files/bird-image.jpg" > place an image inline on this page | | |
| </ul> | | |
| <p> | | |
| See <a href="/tbwiki/DocImages">DocImages</a> for different attributes you can use for to control | | |
| image output (e.g. size, alternate text). | | |
| <p> | | |
| <h1><a name="Examples">Examples</a> | | |
| <span align=right class="section_edit_link">[<a href="/tbwiki/DocLinks?action=edit§ion=Examples">edit section</a>]</font></span> | | |
| </h1> | | |
| See <a style="color:red;" href="/tbwiki/TestLinks?action=split">the TestLinks page in split mode</a> | | |
| <p> | | |
| <h2><a name="Anchor_'foo'">Anchor 'foo'</a> | | |
| <span align=right class="section_edit_link">[<a href="/tbwiki/DocLinks?action=edit§ion=Anchor_'foo'">edit section</a>]</font></span> | | |
| </h2> | | |
| Here is the actual definition of anchor <a name="foo"></a>'foo' | | |
| <p> | | |