Wagn cards can include other cards inside them, which opens up several possibilities:
- referring to one card (like an address or an event notice) from many spots on the site. That way, when its contents get updated, it's updated everywhere
- including "closed" cards to save space and allow for a more dynamic read
- organizing more granular data that can be referred to in multiple contexts
- you create and edit standard formats by including cards within cards (that can be rearranged)
- images in Wagn work by by creating an image card and uploading an image to it, then including the image card where you want it to appear
You can edit included cards by double-clicking anywhere in them, or clicking on the Edit tab (if it's view:open, or view:closed but has been opened).
Also see relative inclusion.
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. It looks like this:
{{Wagn Wheels}} — include the Wagn Wheels card, but without the card interface around it
You can add a view modifier after a vertical bar to affect exactly what gets included:
{{Wagn Wheels|view:content}} — explicit way of saying the same thing as above
Actually, the "view:" is optional:
{{Wagn Wheels|content}}
Some more views:
{{Wagn Wheels|open}} — include Wagn Wheels with its card interface around it, and open (this used to be "card")
{{Wagn Wheels|closed}} — include Wagn Wheels with its card interface, but closed (this used to be "line")
{{Wagn Wheels|link}} — include just a link to Wagn Wheels
{{Wagn Wheels|name}} — include just the plain card name, "Wagn Wheels"
{{Wagn Wheels|raw}} — raw is the same as content, but does not include any of the surrounding HTML that happens with content. This means you won't be able to double-click on it to edit it, and is useful for embedding, say, in HTML cards.
Image cards
When you're including an image, by default it will appear exactly where you include it. You can instead have it align left or right. If it's included in a paragraph, then the text will wrap around it.
{{nymph|float:right}}
{{nymph|float:left}}
{{nymph|float:none}} (the default)
Lists of cards
When you're including Search or Pointer cards — both of which return lists of cards — you can also specify how the returned cards appear, by adding a semicolon and item:content, item:raw, item:open, item:closed (this is the default), item:link, item:name. So {{High priority tickets|line;item:link}} looks like:
{{Wiki on Wheels|closed}} looks like this:
{{Wiki on Wheels|link}} looks like this:
{{Wiki on Wheels}} looks like this:
{{nymph}} looks like this:
There's a {{nymph|float:right}} at the beginning of this paragraph:
Keeping things on one line
Sometimes you want to include cards in the middle of a line of text, and want everything to stay on one line. To do this there are a few things that have to be in place:
- When including text cards, instead of cardtype Basic, make sure that they are PlainText or Phrase. (Images, numbers, etc. will be fine as is.)
- Include them with view raw - { {inclusion one|raw} }
- Put them all on one line, e.g.: { {inclusion one|raw} } { {inclusion two|raw} } { {inclusion three|raw} }
Example
Forgot to include them raw:
We like our favicon
so much thatwe use it in examples.
Almost — just forgot to make inclusion four a Phrase or Plaintext:
We like our favicon
so much that
we use it in examples.
Tickets relevant to inclusion:
Issue
If a card includes another card twice, then if you edit inclusions you get the edit interface for the included card twice. No horrid results ... Tags:User stories
Issue
+issue +solution Tags: paging views inclusion Process ArtsUser stories
Issue
We have two ways to title sections — headers and inclusions. Would be nice to have more harmonization in the graphic design and functionality (e.g. ... Tags:User stories
Issue
addresses many image/file issues: leave uploaded file names as given - Right now Wagn modifies the names of images (lightly) and files (heavily). Suggest ... Tags:User stories
Issue
Instead of light gray "Add cardname", have inclusions to nonexistent cards be red, ust like links to nonexistent cards. +solution Tags:User stories
Issue
+issue +solution Tags: inclusion linkingUser stories
Issue
+issue _main+taglist would be interpreted as add syntax for main card of page+taglist on this page. This would make it possible to put tagging ... Tags:User stories
Issue
+issue +solution Tags: inclusion The left side should be the name of this ticket: _left+foobarUser stories
Issue
+issue e.g. something like: { {User+*type cards|title:User Cards} } Tags: inclusion Process ArtsUser stories
Issue
This would allow, e.g.: sidebar with _main+taglist for tagging cards. Something like _main in inclusions (and WQL?) to refer to the main card of the page. Tags:User stories
Issue
Many of these cards take a while to save, and stay on "connecting to server..." long after they have actually saved. Also, they often show ... Tags:User stories
Issue
update these much in the same way as links -- again with the rename confirmation. Tags: inclusion renaming Wagn 1.0 fortnightUser stories
Issue
+issue Ideal solution might be to enable cards to have more than one name, but this has horrible performance implications. Another possibility: Create an alias ... Tags:User stories
Issue
Wagn currently raises an error if you have an invalid card view on an inclusion. Should just ignore invalid views, and use the default - ... Tags:User stories
Issue
+issue +solution Tags: comments editing cards inclusion fortnightUser stories
Issue
For cards that are included in content or raw view: A way - besides double-clicking - to edit them. (Comes up when the included ... Tags:User stories
Issue
+issue What we really want is for it to simply be red, like any link to a card that doesn't exist yet, and for permissions to ... Tags:User stories
Issue
Double-click triggering edit mode when already in edit mode. +solution Tags:User stories
Issue
Need a way to reference current card and it's parts in inclusions, also, these bugs are related: _self|view:name breaks multi-edit. It offers you to edit the named ... Tags:User stories
Issue
+issue When a card is edited, touch cards that it's included on, so that they appear in Recent Changes. May have unintended consequences, so please code reversibly. ... Tags:User stories
Add +discussion
inclusion
High Priority Tickets