Repository Path Types
In order for automation scripts to produce content inside a
working copy of &TCAR;, it is required that all work lines be
related somehow. The relation between work lines is used by
automation scripts to know where to retrive the information
they need to work with (e.g., input files, translation
messages, output locations, etc.). This kind of relation is
built using two path constructions known as master
paths and auxiliar paths.
Master Paths
A master path refers to a directory inside the repository that
contain input files required to produce output files through
automation scripts. Examples of master paths inside the
repository include:
trunk/Identity/Models/Brands
trunk/Manuals/Tcar-ug
trunk/Identity/Models/Themes/Default/Distro/5/Anaconda
Auxiliar Paths
An auxiliar path refers to directories inside the repository
considered auxiliar for one single master path. Auxiliar path
can be either for output or localization. Assuming the master
path provides the input information, the auxiliar paths
provide the auxiliar information which describes how and where
that input information must be rendered by automation scripts.
Examples of auxiliar paths inside the repository include:
trunk/Identity/Images/Brands
trunk/Manuals/Tcar-ug/es_ES
trunk/Locales/Manuals/Tcar-ug/es_ES
trunk/Identity/Images/Themes/Flame/3/Distro/5/Anaconda/es_ES
trunk/Locales/Identity/Models/Default/Distro/5/Anaconda/es_ES
The relationship between master and auxiliar paths is built by
combining the second directory level of master paths with
directories in the second directory level of repository
layout. In the second directory level of repository layout,
the Identity, Manuals and Scripts directories are always
used to create the master paths and the output auxiliar paths.
The Locales directory,
on the other hand, is always used to create localization
auxiliar paths for all the master paths available under
Identity, Manuals and Scripts directories.
For example, if the LANG environment
variable is set to es_ES.UTF-8
and you execute
the render functionality of
centos-art.sh script with the trunk/Manuals/Tcar-ug master
path as argument, it will produce &TCARUG; in Spanish language
using translation messages from
trunk/Locales/Manuals/Tcar-ug/es_ES
auxiliar path and would save final documentation output files
under trunk/Manuals/Tcar-ug/es_ES
auxiliar path.