close open_in_new

cards can include other cards inside them.  nesting helps you:

  • edit chunks of content in place - 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 information in different ways using views.  Eg, closed view let you use space more efficiently.
  • specify content patterns with inclusion-based formats.
 

Example

help edit

The following (relevant) video is in a card named +howto video and is included here with the following syntax:

{{_l+howto video}}

 

 

 

 

How To

help edit

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 }}

 The complete Nest Syntax is documented here:

Nest Syntax

help edit

To demonstrate, here's a simple sample card:

simple sample

help edit

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, core, 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:

 

simple sample

help edit

 

set item views


When you include Search and Pointer cards, you can also specify the views of each card in the returned list by adding another pipe. For example, {{sample user search | open | link}} will yield:

sample user search

help edit
Lewis Hoffman
Ethan McCutchen
John Abbe
BrandonCsSanders
Decko Bot 1
gideonro
Raymond King
hunabku
Sara Winge
Imaginify
David Duncan
Aaron Nelson
Franklin Pierce
Mark "Junctionbox" Hadfield
CuongTran
Nick Dynice
wilkart
Marcus Derencius
Ted Ernst
Gary Hurley
  • «
  • 1
  • 2
  • 3
  • ...
  • 59
  • »
1 - 20 of 1178

That syntax basically means "show me the search card in open view and each of its items in link view".

 

escape 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

help edit
  • Nest Syntax describes more, such as showing & hiding individual elements such as a card's menu, or customizing its title.
  • You can edit included cards by double-clicking anywhere in them, or by clicking "edit" in the menus in the card's header.
  • Inclusions are not inline, but you can make them inline by using "display:inline" (and if the enclosing card is Basic, editing it's HTML so that instead of having a p tag around the inclusion it has a div tag), so for example "Ethan McCutchen's favorite fruit is {{Ethan McCutchen+favorite fruit|display:inline}}." will render as:

    Ethan McCutchen's favorite fruit is
    kiwi
    .
  • 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:

  • 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}}

 

Discussion

 
Tickets relevant to nesting