After initializing (using r3
setup commands), the user needs to set up some dimensions.
Currently, only two user-configurable dimensions are allowed:
product and intl. A third dimension, the
page dimension, is also used but not configurable with
these commands. Both r3 dimension product and
r3 dimension intl produce this usage
message:
usage:r3 [-c <arg>] dimension <dimension> dimension tools (dimension is one of product,intl) list [-t <arg>] [... list dimensions create [-p <arg>] creates an r3 element delete [-f] [-p] remove an element attribute attribute tools parent changes parent for an r3 element within the given domain
An important part of r3 is the concept of inheritance chains in each dimension. Each new dimension element can set another, already existing, element as its parent. Templates, translations and targets all use the concept of locations to specify their positions in the file structure. The location is a combination of product, intl and page. When the product and intl elements of the location each have a chain of parents leading to a most generic location, r3 uses the inheritance of locations to place a specific item from the specified location or to search down the chain of locations until a more generic version of this specific item is found and used.
The page dimension is created by r3 target create and always has a generic element available below the created page.
You can set different inheritance hierarchies for a dimension when used in the context of pages, templates or translations. In the rest of this documentation, these three are referred to as domains. The main use envisaged for domains is to set a different hierarchy for translations and templates.
dimension | dim