Difference between revisions of "Template:Edge"
(Trying out #set instead of escaping wiki links) |
|||
| (13 intermediate revisions by 2 users not shown) | |||
| Line 11: | Line 11: | ||
| description = Connects a Foo to a Bar or a Baz | | description = Connects a Foo to a Bar or a Baz | ||
| references = ... | | references = ... | ||
| − | | | + | | permitted = F,B,*,* |
| + | | specified = Foo,Bar,1,*;Foo,Baz,0..1,* | ||
<nowiki>}}</nowiki> | <nowiki>}}</nowiki> | ||
As with the Metaclass template, the extends and references parameters are optional. | 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 | + | The visible output of this will be a metaclass table describing the edge, plus two tables summarizing the generally possible and explicitly specified connections: |
{{Metaclass | {{Metaclass | ||
| Line 25: | Line 26: | ||
{| class="xcsgtable" | {| class="xcsgtable" | ||
| + | ! colspan="3" | Permitted Connections | ||
| + | |- | ||
| + | ! Predecessor !! Multiplicity !! Successor | ||
| + | |- | ||
| + | |[[F]] || ✱ ➞ ✱ || [[B]] | ||
| + | |} | ||
| + | |||
| + | {| class="xcsgtable" | ||
| + | ! colspan="3" | Specified Connections | ||
| + | |- | ||
! Predecessor !! Multiplicity !! Successor | ! Predecessor !! Multiplicity !! Successor | ||
|- | |- | ||
| Line 60: | Line 71: | ||
| description = {{{description}}} | | description = {{{description}}} | ||
| references{{#if:{{{references|}}}||NULL}}={{{references}}} | | references{{#if:{{{references|}}}||NULL}}={{{references}}} | ||
| − | }} {{#if:{{{ | + | }} {{#if:{{{permitted|}}}| |
{{{!}} class="xcsgtable" | {{{!}} class="xcsgtable" | ||
| + | ! colspan="3" {{!}} Permitted Connections | ||
| + | {{!}}- | ||
! Predecessor !! Multiplicity !! Successor | ! Predecessor !! Multiplicity !! Successor | ||
{{!}}- | {{!}}- | ||
| − | {{!}}{{#arraymap:{{{ | + | {{!}}{{#arraymap:{{{permitted|}}}| ; | PredSuccMult | [[ComesFrom::{{EnsureNamespace|{{#explode:PredSuccMult|,|0}}}}{{!}} ]]{{NameTrick|{{EnsureNamespace|{{#explode:PredSuccMult|,|0}}}}}} {{!}}{{!}} {{ReplaceAsterisks|{{#explode:PredSuccMult|,|2}}}} ➞ {{ReplaceAsterisks|{{#explode:PredSuccMult|,|3}}}} {{!}}{{!}} [[GoesTo::{{EnsureNamespace|{{#explode:PredSuccMult|,|0}}}}{{!}} ]]{{NameTrick|{{EnsureNamespace|{{#explode:PredSuccMult|,|1}}}}}} | \n{{!}}-\n{{!}}}} |
| − | {{!}}} }}<noinclude><!-- | + | {{!}}} }} {{#if:{{{specified|{{{connects|}}}}}}|{{{!}} class="xcsgtable" |
| + | ! colspan="3" {{!}} Specified Connections | ||
| + | {{!}}- | ||
| + | ! Predecessor !! Multiplicity !! Successor | ||
| + | {{!}}- | ||
| + | {{!}}{{#arraymap:{{{specified|{{{connects|}}}}}}| ; | PredSuccMult | [[ComesFrom::{{EnsureNamespace|{{#explode:PredSuccMult|,|0}}}}{{!}} ]]{{NameTrick|{{EnsureNamespace|{{#explode:PredSuccMult|,|0}}}}}} {{!}}{{!}} {{ReplaceAsterisks|{{#explode:PredSuccMult|,|2}}}} ➞ {{ReplaceAsterisks|{{#explode:PredSuccMult|,|3}}}} {{!}}{{!}} [[GoesTo::{{EnsureNamespace|{{#explode:PredSuccMult|,|0}}}}{{!}} ]]{{NameTrick|{{EnsureNamespace|{{#explode:PredSuccMult|,|1}}}}}} | \n{{!}}-\n{{!}}}} | ||
| + | {{!}}} }}<includeonly>[[Category:XCSG Edge Kinds]][[Category:XCSG Tags]]</includeonly><noinclude><!-- | ||
| Line 74: | Line 93: | ||
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:{{{ | + | --></noinclude>{{#arraymap:{{{permitted|}}}| ; | PredSuccMult | {{#set:permitted edge from {{#explode:PredSuccMult|,|0}} = {{#explode:PredSuccMult|,|1}}$SEP${{ReplaceAsterisks|{{#explode:PredSuccMult|,|3}}}}$SEP${{{description|}}} }} }}<noinclude> |
| − | + | </noinclude>{{#arraymap:{{{specified|{{{connects|}}}}}}| ; | PredSuccMult | {{#set:specified edge from {{#explode:PredSuccMult|,|0}} = {{#explode:PredSuccMult|,|1}}$SEP${{ReplaceAsterisks|{{#explode:PredSuccMult|,|3}}}}$SEP${{{description|}}} }} }}<noinclude><!-- | |
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:{{{ | + | --></noinclude>{{#arraymap:{{{permitted|}}}| ; | PredSuccMult | {{#set:permitted edge to {{#explode:PredSuccMult|,|1}} = {{#explode:PredSuccMult|,|0}}$SEP${{ReplaceAsterisks|{{#explode:PredSuccMult|,|2}}}}$SEP${{{description|}}} }} }}<noinclude> |
| + | </noinclude>{{#arraymap:{{{specified|{{{connects|}}}}}}| ; | PredSuccMult | {{#set:specified edge to {{#explode:PredSuccMult|,|1}} = {{#explode:PredSuccMult|,|0}}$SEP${{ReplaceAsterisks|{{#explode:PredSuccMult|,|2}}}}$SEP${{{description|}}} }} }}<noinclude>[[Category:XCSG Templates]]</noinclude> | ||
Latest revision as of 11:09, 24 November 2015
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 = ... | permitted = F,B,*,* | specified = 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 two tables summarizing the generally possible and explicitly specified connections:
| Metaclass | Edge |
|---|---|
| Extends | , Another Type of Edge, Yet Another Type of Edge |
| Description | Connects a Foo to a Bar or a Baz |
| References | ... |
| Permitted Connections | ||
|---|---|---|
| Predecessor | Multiplicity | Successor |
| F | ✱ ➞ ✱ | B |
| Specified Connections | ||
|---|---|---|
| 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}}} |
