Wagn makes it very easy for you to link to other cards in Wagn, or to other websites. These links are tracked as references and can be queried using the Wagn Query Language (CQL).
[[Wagn News]] --> Wagn News
[[No Such Card]] --> No Such Card
[[Installation | How To Install a Wagn]] --> How To Install a Wagn
[[/recent | Recent Changes]] --> Recent Changes
[[http://www.grasscommons.org | Grass Commons]] --> Grass Commons
[[cardname | text]]
[[http://website.com | text ]]
[[/account/signup | text ]]
- Leading and trailing whitespace is optional, so [[link|name]] is the same as [[ link | name ]].
- To actually show double brackets (for example in documentation), start with a backslash. So \[[Wagn News]] shows up as [[Wagn News]].
- Card links can use contextual names.
- You can also use nesting inside links to create contextual web addresses or to set contextual form content. However, it can cause problems to put inclusions inside the left side of named links. Inclusions on the right side of the pipe (|) generally don't cause problems. You can even put images there, doing things like [[ Philipp | ]].
- See links for examples.
Links within Wagn
To make a link to another card in Wagn, just put the link between double brackets. For example, [[Wagn]] gives you this link:
You can even link to a card that doesn't exist yet. The link will show up red, and anyone can just click on it to create the card. So [[I don't exist]] results in:
I don't exist
Links to plus cards work the same way. [[Wagn 0.13+blog]] gets:
If you want the text of the link to be different from the name of the card it's linking to, you use a vertical pipe after the link, followed by the text. So [[Aaron Nelson|IT hero]] shows up as:
There is a great deal more power possible with Wagn's internal links. See web address for everything and setting default content with links.
Links outside Wagn (or to another Wagn)
Any web address you enter will automatically become a link:
Again, if you want the text of the link to be different, you use double brackets and put a vertical pipe after the link, followed by the text. [[http://www.grasscommons.org|Grass Commons]] results in:
If you want to use double brackets without creating a link (for example in documentation), put a backslash just before the double brackets. For example, \[[this isn't a link]] appears as:
[[this isn't a link]]
- Are you linking to a card with a name that's long or that you're not sure of the wording/spelling? Just start typing the name of the card in the navbox. Then use the arrow keys to select the card from the auto-complete menu, select all, and copy.
I would be interested in knowing whether there are ways to automatically link some text expressions. For instance each time I write "Grass Commons" then the link is automatically generated, be it to another wiki page or an external link. This function exists in many wikis...
What we have ticketed in this regard is optional WikiCase auto-linking. Then you could write GrassCommons and it would automatically link to Grass Commons.
--John Abbe.....Thu Sep 24 16:51:04 -0700 2009
Ah, and the tickets link below doesn't find anything, 'cause we're tagging with "linking", so see linking+tickets for item
--John Abbe.....Thu Sep 24 16:52:35 -0700 2009
--TrishSprings.....Mon Jun 18 06:41:09 +0000 2012