Home Recent Sign up Sign in
  • View
  • Changes
  • Options
  • Related
  • Edit
  • Cards can include other cards inside them, which opens up many possibilities:

    • Display content of a card (like an address or an event notice) from many spots on the site. When anyone updates the card's content, the new version appears everywhere.
    • Include a card in a "closed" view, to save space but allow for a more dynamic read — people can open the card and read it (and close it again) without loading a new page.
    • Organizing more granular data that can be referred to in multiple contexts.
    • Formats let you specify a layout that will be used by many cards. Formats are created by including cards (which can be rearranged) within a format card.
    • 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.

    Also see relative inclusion.

     

    Examples

    {{Wiki on Wheels|closed}} looks like this:


    Documentation Community Hosting and Consulting Download   Request an account on Wagn.org

     

    {{Wiki on Wheels|link}} looks like this:


    Wiki on Wheels

     

    {{Wiki on Wheels}} looks like this:


    Documentation

    Community

    Hosting and Consulting


    Download

     

    Request an account on Wagn.org

     

    {{nymph}} looks like this:


     

    {{nymph|open}} looks like this:

     

  • View
  • Changes
  • Options
  • Related
  • Edit
  •  

    {{nymph|name}} looks like this:

     

    nymph

     

    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:

     

  • View
  • Changes
  • Options
  • Related
  • 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, 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 view of each card in the returned list using the "item" key.  For example, {{sample user search | open; item:link}} will yield:

  • View
  • Changes
  • Options
  • Related
  • Edit
  • 1 to 20 of 463 Next-page 1 to 20 of 463 Next-page

     

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

     

  • View
  • Changes
  • Options
  • Related
  • Edit
    • 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 Kiwi.

      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

     

    Add +discussion

    Tickets relevant to inclusion