Contextual (or "relative") names are abbreviated card names that can be interpreted differently based on context. These short-cut names are translated into "absolute" names when used in links, inclusions, and searches.
Examples
Here is the raw content of a card named Earth:
The small planet we all live on is named {{_self|name}}. It has seven continents. See [[+continents]]
And here is what Earth looks like when it is rendered.
The small planet we all live on is named Earth. It has seven continents. See +continents
Similarly, here is the raw content of a card named Earth+continents
Australia, Asia, Africa, Europe, Antarctica, and North and South America are all [[_right]] on planet [[_left]].
And here is what that card looks like rendered:
Australia, Asia, Africa, Europe, Antarctica, and North and South America are all continents on planet Earth.
How To
Use these terms in links, inclusions and/or WQL where you want to refer to a card within its own content:
_self to refer to the card's name. You can also use _ for short, or in plus cards even omit it altogether. For example, in the content of our example card called Earth, all three of these would include Earth+continent:
- {{_self+continent}}
- {{_+continent}}, and
- {{+continent}}.
_left and _right to refer to the left and right parts of a plus card. You can also use _L and _R for short*. _right always refers to the rightmost card. _left always refers to everything else. For example, with "A+B+C", _left refers to "A+B", and _right refers to "C".
Another notation that works in plus cards is _1 for the first card, _2 for the second, etc., so on "A+B+C", {{_1}} would be "A" and {{_2}} would be "B".
*This notation allows for arbitrarily complex references. For example on "A+B+C+D+E", you can refer to "A+B+C" with {{_LL}}. (left of left). Each L selects the left part, first "A+B+C+D", then "A+B+C". And you can refer to "C" with {{_LLR}} (right of left of left). As above, LL gets us "A+B+C", then R selects the right part: "C".
**_user cannot be used in links (because they are not rendered separately for each user), but can be used in inclusions in link view: {{_user|link}}
These are additional terms that relate to other aspects of the user's context:
_user refers to the user card of the person who is currently signed in**.
_main refers to the main card of the page. It is generally used in custom layout cards to include the main card, and works in inclusions, links and WQL anywhere.
Tips
- These terms can be used as variables in regular web addresses - see contextual web addresses.
- In the context of searches, _self refers to the left side of the card's name. For example, in the context of wiki+peers with tag the _self (in peers with tag+*right+*content) refers to "wiki", not to "wiki+Coopetitors with tag".
- _user makes it possible to provide an individually customizable card in the sidebar for each person, by including something like _user+menu in *sidebar. (To keep "Anonymous+menu" from showing up there for people who are not signed in, you'll want to create Anonymous+menu and set its permission so that it can be viewed only by a role other than Anyone.)
Add +discussion
