A link to an action stored in a resource which may or may not be loaded as part of the editing resource set. The model and action specificed in the action link’s reference (
ref) is loaded only during the generation. This way it is different ActionReference which references an action available in the editing resource set - models in the same modeling project or loaded with “Load resource” context menu. For example, action link reference may point to a dynamically generated model or may contain interpolation tokens and different actions can be linked based on generation configuration.
The linked action inherits this action link context. As such the same linked action linked by different action links may behave differently depending on the action link context/configuration. I.e. a link may create a different “instance” of linked action. In this case the linked action activator shall also be context dependent - otherwise different instances of the same action will point to the same resource/url.
If path is not blank then it is resolved against the context URI to produce a new context URI for the linked action. It can be used to organize generated content into folders in order to avoid name clashes or semantic references, e.g.
index.html generated by one action overwriting
index.html generated by another.
For example, if the linked action activator is
click-me.html and the path is blank, then the linked action will be generated in the same folder as the parent of the action link. If the path is
click-me-demo then the linked action content will be generated to
https://nasdanika.org/builds/master/doc/ token can be used to define the uri relative to the base generation URI (output folder) instead of the parent URI. It might be useful it the parent URI is an absolute external URI.
https://nasdanika.org/builds/master/doc/ ends with a slash, so there is no need to add a slash. E.g.
Action specification URL interpolated and then relsolved relative to the model location. The URL consists of the target model URL and optional action ID fragment separated from the model URL part by
#. In the absence of the fragment part the URL is resolved to the root action of the target model file.
In Nasdanika Tool Suite Documentation Bundle
models/documentation.vinci links the root action of
ref value of that link is
guides/vinci/vinci.vinci because the reference is to the root action and therefore there is no action id fragment.
Referencing a non-root action would require a fragment part with action id, e.g.