Cards can include other cards inside them. Inclusion has many benefits:
- Edit inclusions in place, making them faster and easier than editing whole pages.
- Keep data current. a card's updates (e.g., an address or event info) appear everywhere it's included.
- Display the same card in different ways using inclusion views. Eg, closed view let you use space more efficiently.
- Specify content patterns with inclusion-based formats.
Examples
{{Wiki on Wheels}} looks like:
{{Wiki on Wheels|open}} looks like:
{{Wiki on Wheels|closed}} looks like:
{{nymph|open}} looks like:
{{nymph}} looks like:
{{nymph|name}} looks like:
nymph
{{nymph|link}} looks like:
How To
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}}.
The image to the right here uses float:right.
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 views of each card in the returned list using the "item" key. For example, {{sample user search | open; item:link}} will yield:
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}}
Tips
- You can edit included cards by double-clicking anywhere in them, or clicking on the Edit in the enclosing card's header.
Inclusions are inline, so you can use them in a sentence, for example "Ethan McCutchen's favorite fruit is {{Ethan McCutchen+favorite fruit}}." will render as:
Ethan McCutchen's favorite fruit is .For this to work, the included card's cardtype must be PlainText or Phrase (or if it's Basic, make sure to remove its enclosing p tags).
When you're including a card that doesn't exist yet, you can specify what type it should be with something like {{Phoebe Owens+favorite fruit|type:Phrase}}. Try clicking on this and you'll see it in action:
Add Phoebe Owens+favorite fruit
You can put comments in Wagn cards by making an inclusion and beginning with a hash symbol (#). Use two to make a comment that's completely invisible to web browsers:
{{## completely invisible comment}}
And one to have it show up as an HTML comment (i.e. <!-- # only visible in HTML -->):
{{# only visible in HTML}}
Add +discussion
