Difference between revisions of "Template:Edge"
m (Replace asterisks worked!) |
(changing separator of properties created from a comma to $SEP$, to avoid issues with commas in the description) |
||
Line 34: | Line 34: | ||
In addition, the following properties will be created: | In addition, the following properties will be created: | ||
− | edge from [predecessor]::[successor] | + | edge from [predecessor]::[successor]$SEP$[multiplicity]$SEP$[description of this edge] |
− | edge to [successor]::[predecessor] | + | edge to [successor]::[predecessor]$SEP$[multiplicity]$SEP$[description of this edge] |
+ | Note that $SEP$ is literal; when retrieving these properties, they can be split into the three separate values using $SEP$ as the separator argument of #explode, #arraymap, or #arraydefine. | ||
For the above example, the properies will be: | For the above example, the properies will be: | ||
− | edge from Foo::Bar | + | edge from Foo::Bar$SEP$*$SEP$Connects a Foo to a Bar or a Baz |
− | edge to Bar::Foo | + | edge to Bar::Foo$SEP$1$SEP$Connects a Foo to a Bar or a Baz |
− | edge from Foo::Baz | + | edge from Foo::Baz$SEP$*$SEP$Connects a Foo to a Bar or a Baz |
− | edge to Baz::Foo | + | edge to Baz::Foo$SEP$0..1$SEP$Connects a Foo to a Bar or a Baz |
</noinclude><noinclude><!-- | </noinclude><noinclude><!-- | ||
Line 73: | Line 74: | ||
Knowing only the origin node, we want to be able to discover this edge, the destination node, the multiplicity from the origin node, and the short description of this edge. | Knowing only the origin node, we want to be able to discover this edge, the destination node, the multiplicity from the origin node, and the short description of this edge. | ||
− | --></noinclude>{{#arraymap:{{{connects|}}}| ; | PredSuccMult | [[edge from {{#explode:PredSuccMult|,|0}}::{{#explode:PredSuccMult|,|1}} | + | --></noinclude>{{#arraymap:{{{connects|}}}| ; | PredSuccMult | [[edge from {{#explode:PredSuccMult|,|0}}::{{#explode:PredSuccMult|,|1}}$SEP${{ReplaceAsterisks|{{#explode:PredSuccMult|,|3}}}}$SEP${{{description|}}}{{!}} ]] | }}<noinclude><!-- |
Line 79: | Line 80: | ||
Knowing only the destination node, we want to be able to discover this edge, the predecessor node, the multiplicity of incoming edges of this type, and the short description of this edge. | Knowing only the destination node, we want to be able to discover this edge, the predecessor node, the multiplicity of incoming edges of this type, and the short description of this edge. | ||
− | --></noinclude>{{#arraymap:{{{connects|}}}| ; | PredSuccMult | [[edge to {{#explode:PredSuccMult|,|1}}::{{#explode:PredSuccMult|,|0}} | + | --></noinclude>{{#arraymap:{{{connects|}}}| ; | PredSuccMult | [[edge to {{#explode:PredSuccMult|,|1}}::{{#explode:PredSuccMult|,|0}}$SEP${{ReplaceAsterisks|{{#explode:PredSuccMult|,|2}}}}$SEP${{{description|}}}{{!}} ]] | }} |
Revision as of 11:08, 27 March 2014
This template, for use on edge kind pages, takes in a short description of this edge, and a list of the kinds of connections this edge can form (the predecessor node kind, successor node kind, and multiplicities at each end), and stores that information in properties so it can be retrieved by knowing either the edge kind, the predecessor kind, or the successor kind, using a single query.
It also produces a table summarizing this information.
For example, this is the template call that would be used on a page "Edge" to indicate that "Edge" is an edge kind, that connects either a "Foo" node kind to a "Bar" node kind, or to a "Baz" node kind, with each "Bar" node being associated with exactly one "Foo" node, and each "Baz" node optionally being associated with exactly one "Foo" node:
{{Edge | extends = Another Type of Edge, Yet Another Type of Edge | description = Connects a Foo to a Bar or a Baz | references = ... | connects = Foo,Bar,1,*;Foo,Baz,0..1,* }}
As with the Metaclass template, the extends and references parameters are optional.
The visible output of this will be a metaclass table describing the edge, plus a table summarizing the connections:
Metaclass | Edge |
---|---|
Extends | , Another Type of Edge, Yet Another Type of Edge |
Description | Connects a Foo to a Bar or a Baz |
References | ... |
Predecessor | Multiplicity | Successor |
---|---|---|
Foo | 1 ➞ ✱ | Bar |
Foo | 0..1 ➞ ✱ | Baz |
In addition, the following properties will be created:
edge from [predecessor]::[successor]$SEP$[multiplicity]$SEP$[description of this edge]
edge to [successor]::[predecessor]$SEP$[multiplicity]$SEP$[description of this edge]
Note that $SEP$ is literal; when retrieving these properties, they can be split into the three separate values using $SEP$ as the separator argument of #explode, #arraymap, or #arraydefine.
For the above example, the properies will be:
edge from Foo::Bar$SEP$*$SEP$Connects a Foo to a Bar or a Baz
edge to Bar::Foo$SEP$1$SEP$Connects a Foo to a Bar or a Baz
edge from Foo::Baz$SEP$*$SEP$Connects a Foo to a Bar or a Baz
edge to Baz::Foo$SEP$0..1$SEP$Connects a Foo to a Bar or a Baz
Metaclass | Edge |
---|---|
Description | {{{description}}} |
Predecessor | Multiplicity | Successor |
---|---|---|
Node Kind | 1 ➞ ✱ | Node Kind |
Node Kind | ✱ ➞ 1 | Node Kind |