```## tabid=examples titletext='SimpleWiki examples' subjecttext='SimpleWiki Examples' navigationmarkup=examplesnav menuid=links <> == Links == |:p div float:right:|%s smaller%//[[Local:display/article/linksexamples|view source markup]]// |:p posting:|posted November 21, 2009, updated February 12, 2012 Links are inline markup. The general format for links is {{{[[target|caption|title]]}}} where the target is the actual url link, caption is the text the user sees, and title (optional) is text that pops up if the user floats the mouse over the caption. The caption can be an image. {{{[[http://cityrinks.ca | City Rinks Website]]}}} looks like this: [[http://cityrinks.ca | City Rinks Website]]. Note the double square brackets, and the vertical bar separating the address from the text (called the //caption//). ==== Open in new window ==== You can make the link **open in a new window** by putting a link decorator in front of it like this:\\ {{{%l newwin%[[http://cityrinks.ca | City Rinks Website]]}}}, which looks the same - %l newwin%[[http://cityrinks.ca | City Rinks Website]] - but now opens in a new window. Try it! Inline decorators like this are marked with percent signs ({{{%}}}). The "l" (lower case "L") after the first percent sign tells the markup engine that it's a link decorator. ==== Markup in the caption ==== You can put **markup in the caption** portion of a link: ``{{{%l newwin%[[http://cityrinks.ca | //City Rinks// Website]]}}} ``looks like this: ``%l newwin%[[http://cityrinks.ca | //City Rinks// Website]] ==== Jumps within current page ==== (:blockquote border:'1px dashed green' margin-bottom:8px:) You can also write links that **jump** to a different part of the page. So {{{[[#start | Go to top of page]]}}} will take you to the top of this page. [[#target | Go to top of page]]. If you click on it, you'll be taken to the top. There's an //anchor// at the top of the page that is written like this: {{{[[#target]]}}} to correspond to the link, and act as a target for it. (:blockquoteend:) ==== Symbolic links ==== (:blockquote border:'1px dashed blue' margin-top:8px margin-bottom:8px:) Then finally there are **symbolic links** like this: {{{[[Issues:somecode | Here's a link to the Issues table]]}}}, which looks the same. [[Issues:somecode | Here's a link to the Issues table]] (:blockquoteend:) ==== Popup description ==== You can get a **popup description** of a link by adding a //title// to the link markup. A title is a second vertical bar followed by some text. Titles can //not// be marked up. So you can write {{{%l newwin%[[http://cityrinks.ca | //City Rinks// Website | cityrinks.ca is a project of CELOS]]}}}, which looks like this: %l newwin%[[http://cityrinks.ca | //City Rinks// Website | cityrinks.ca is a project of CELOS]]. Let your mouse float over the caption, and you'll see a description pop up. ==== Use a picture for a link ==== (:div sidebar-right width:440px:) You can also **use a picture** as the clickable object for the link, by putting image markup in the caption, like this: {{{ %l newwin%[[http://celos.ca | {{http://celos.ca/wiki/uploads/CELOS/rinkbookletcover2_sm.jpg | | This is a booklet from CELOS}}]] }}} Note that I've left the caption for the image blank, but I've put some text in the image title, so that there is popup text when the user floats the mouse over the picture. Below we'll see a way of presenting a picture that is a link, with a caption under it that has its own link. (:divend:) %l newwin%[[http://celos.ca ``|{{http://celos.ca/wiki/uploads/CELOS/rinkbookletcover2_sm.jpg ``| ``|This is a booklet from CELOS}}]]