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 --synchronize LOCATION Description The render functionality exists to automate content rendition inside &TCAR;. The content rendition process itself takes place through the following rendition modes: svg — This modes works with both gzip-compressed (.svgz) or uncompressed (.svg) scalable vector graphics as source files and produces portable network graphics as main output. docbook — This mode works with DocBook source files and produces XHTML as main output. It is also possible to produce PDF output from DocBook source files, however PDF output is commented because its production fails trying to create indexes. conf — This mode works with one or more configuration files as source and produces portable network graphics as main output. The format used in these configuration files is described in . To determine the rendition mode, the render functionality uses the path provided as LOCATION argument and the path name convention described in . Render-able Directories The render-able directories are conventional locations inside the working copy where you can find final output files. The final output files are produced from source files and auxiliary files. Auxiliary files are frequently used to create localized instances of source files which are, in turn, used to create final output files in different forms (e.g., in a different language). Inside the working copy of &TCAR;, the following directory structures are considered render-able directories: 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 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. Documentation/Manuals/ — This directory structure organizes final documentation files. Design models for all these files are organized under Documentation/Models/ directory structure. Inside render-able directories the rendition process is performed through different rendition flows known as theme-rendition, base-rendition, post-rendition and last-rendition. Theme-Rendition Flow The theme-rendition flow exists to produce content inside Identity/Images/Themes/ directory structure. This rendition flow identifies which directories are render-able and uses the base-rendition on them, one by one. The theme-rendition flow exists to support massive rendition of themes through the following command: centos-art render Identity/Images/Themes In case you need to limit the amount of themes or components inside themes you want to render, you can be more specific about the LOCATION you passed as argument and use the to specify the file you want to render. For example, if you only want to render the 01-welcome.png Anaconda file for CentOS-5 distribution based on version 2 of Modern artistic motif, then you can run the following command: centos-art render Identity/Images/Themes/Modern/2/Distro/5/Anaconda --filter="01-welcome" Notice that you can reach the same result in different ways here by creating combinations between the path you provide as LOCATION and the option. For example, the following commands produce the same result: centos-art render Identity/Images/Themes/Modern/2/Distro/5/Anaconda centos-art render Identity/Images/Themes/Modern --filter="2/Distro/5/Anaconda" You can use whatever combination you like whenever it matches a valid render-able directory inside the working copy. But it seems to be an acceptable practice to use the LOCATION argument to specify the render-able directory path inside the Identity/Images/Themes directory which images need to be rendered for and the option only when it is needed to restrict rendition to a specific file inside the directory provided as LOCATION. Base-Rendition Flow ... Post-Rendition Flow ... Last-Rendition Flow ... Configuration Files (<filename>render.conf</filename>) ... 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}/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.