Markup is used in Wagn only for creating links and inclusions.
Links
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:
Wagn
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:
Wagn 0.13+blog
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:
IT hero
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:
http://grasscommons.org/
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:
Grass Commons
Escaping links
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]].
Inclusion
Including text cards
Including cards is achieved through a simple syntax, which consists of the name of the card inside double braces, with a couple of optional modifiers.
{{ cardname | key1:value; key2:value }}
To demonstrate, here's a simple sample card:
Well, hello. I'm the content of simple sample card.
We included the card above using this syntax: {{simple sample | view:open }}. The "view:open" part means we want to see the whole card, with its green header and everything. There are many other views: closed, content, titled, link, name, change, naked, etc.
The default view is "content", which means you only see the content of the card -- no header or footer. So if you don't specify a view, and just type {{simple sample}}, you'll just get the card's content:
Well, hello. I'm the content of simple sample card.
You would get the very same thing with {{simple sample | view:content}}, which is just a bit more explicit. Actually, because "view" is such a common key, you can just leave it out, like so: {{simple sample | closed}}, which gives us this:
Well, hello. I'm the content of simple sample card.
Including image cards
Including an image is like including any other card — just put the name of the image card you want to include in double-curly-brackets: {{cardname}}.
For example, there is already an image card named "nymph". If I want to include it here, I just type {{nymph}}, and I get:
Sizing and location
By default images will appear medium size, but you can change this with a size instruction after the name of the card, such as {{nymph|size:small}}:
There are several sizes available, restricting the maximum height and width of the image. They will always keep the original image's relative height and width.
- icon (16 pixels)
- small (75 pixels)
- medium (200 pixels) - default if no size is specified
- large (500 pixels)
- full (size as uploaded, only works on some file types, including .png and .jpg)
By default images will appear exactly where you include them, and text does not wrap around them. If you want an image aligned at the right or left edge, and to have associated text wrap around it, you can do that by adding something like {{nymph|float:right}} or {{nymph|float:left}}.
Geeky Aside: You can actually add any CSS you want to cards this way. For example you could add padding around an image card with something like {{nymph|float:left; padding: 10px 20px 15px 0px}}.
Images as links
You can even make an image a clickable link. Just create a link, but after the name of the card you want to link to, add a vertical bar and then include the image. For example, [[Grass Commons|{{Grass Commons+logo}}]] renders as:
Specifying view of cards in lists
When you include Search and Pointer cards, you can also specify the view of each card in the returned list using the "item" key. For example, {{sample user search | open; item:link}} will yield:
1 to 20 of 627
1 to 20 of 627
Escaping inclusions
If you want to use double curly brackets without creating an inclusion (for example in documentation), put a backslash just before the brackets. For example, \{{nymph}} appears as:
{{nymph}}
