render
Standardize rendition tasks inside &TCAR;.
render
Standardize rendition tasks inside &TCAR;
centos-art
render
-h|--help
-q|--quiet
--filter="REGEX"
--answer-yes
--dont-dirspecific
--releasever="RELEASEVER"
--basearch="BASEARCH"
--post-rendition="COMMAND"
--last-rendition="COMMAND"
--theme-model="MODELNAME"
--with-brands
--sync-changes
LOCATION
Description
The render functionality exists to render
final image and documentation files from their respective
source files.
Render-able directories
Inside the working copy of &TCAR;, render-able directories are
conventional locations inside the working copy where you can
find output files, produced from source files and optionally
auxiliary files. Auxiliary files are optionally used to modify
the way output files are produced from source files (e.g., to
produce localized output). Inside render-able directories the
rendition process is performed through different rendition
flows known as base-rendition, post-rendition, last-rendition
and directory-specific rendition.
Inside the working copy of &TCAR;, the following directory
structures are considered render-able directories:
trunk/Identity/Images/
— This directory structure organizes final image files
in different formats. It also includes source files for
producing the backgrounds of themes. Related design models for
all these files are under trunk/Identity/Models/ directory
structure.
Don't move any source file related to theme backgrounds from
render-able directories to theme design models directory
structure. The source files related to theme backgrounds are
specific to each theme and cannot be shared among different
themes. The directory structure related to theme design models
is reserved for files shared by all themes.
trunk/Documentation/Manuals/
— This directory structure organizes final documentation
files. Design models for all these files are organized under
trunk/Documentation/Models/
directory structure.
Base-Rendition Flow
...
Post-Rendition Flow
...
Last-Rendition Flow
...
Usage
...
Options
The centos-art prepare command accepts
common options described in and the following
specific options:
Assume yes to all confirmation requests.
This option reduces the list of files to process inside
LOCATION using
REGEX as REGUEX
using REGEX as files you want to render.
The deeper you go into the directory structure the more
specific you'll be about the files you want to render. When
you cannot go deeper into the directory structure through
LOCATION specification, use this
option to reduce the list of files therein.
Synchronizes available changes between the working copy and
the central repository.
This option expands the =\RELEASE=
,
=\MAJOR_RELEASE=
, and
=\MINOR_RELEASE=
translation makers based on
NUMBER value. Notice that
translation markers here were escaped using a backslash
(\
) in order to prevent their expansion. Use this
option when you need to produce release-specific contents, but
no release information can be retrived from the directory path
you are currently rendering.
This option expands the =\ARCHITECTURE=
,
translation makers based on ARHC value.
Notice that translation markers here were escaped using a
backslash (\
) in order to prevent their
expansion. Use this option when you need to produce
architecture-sepecific contents but no architecture
information can be retrived from the directory path you are
currently rendering.
This option specifies the name of theme model you want to use
when producing theme artistic motifs. By default, if this
option is not provided, the Default theme
model is used as reference to produce theme artistic motifs.
To know what values can be passed as
MODELNAME, run the following
command:
ls ${TCAR_WORKDIR}/trunk/Identity/Models/Themes
This option lets you apply a command as post-rendition action.
In this case, the COMMAND
represents the command-line you want to execute in order to
perform in-place modifications to base-rendition output.
This option lets you apply a command as last-rendition action.
In this case, the COMMAND argument
represents the command string you want to execute in order to
perform in-place modifications to base-rendition,
post-rendition and directory-specific rendition outputs.
Examples
...
Bugs
To report bugs related to this function, please create a new
ticket here
refering the specific problems you found in it. For example,
it would be useful if you copy and paste any error output from
centos-art.sh script.
Authors
The following people have worked in this functionality:
Alain Reguera Delgado <alain.reguera@gmail.com>, =COPYRIGHT_YEAR_LIST=
License
Copyright © =COPYRIGHT_YEAR_LIST= The CentOS Project
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
USA.