Resource cloning

Resource cloning is an advanced, and rare, technique that allows the same resource to appear in more than one place in a perspective. It should not be confused with resource inheritance, which allows you to define similar or identical, but still distinct, resources.

Normally, a resource appears in only one place in a perspective. This is desireable because otherwise viewers might see the same resource in two places and conclude (wrongly) that they are distinct entities. There are some rare circumstances, however, where it is desireable to override this behavior. This is accomplished by resource cloning.

Resource clones are created when referencing resources in perspectives. To create a clone, simply reference a resource as normal (such as in the to field of a relation), and append a * and an identifier. Each unique identifier results in a unique clone. Below is a simple example of cloning in a perspective:

- name: Resource A
- name: Resource B
- name: Dependency
  - from: Resource A
    to: Resource B
  - from: Resource B
    to: Resource A *2

The resulting perspective looks like so:

The identifier can be any string; it is not restricted to numbers.

Resource clones can be used anywhere regular resources are referenced, namely in relations, sequences, and slides. Cloned resources can also be referenced in aliases, and given new parents using parent overrides.

Last updated on 26 Sep 2020
Published on 26 Sep 2020