Blame Manual/repository-html/repository_73.html

632e8b
632e8b
<html>
632e8b
632e8b
organization, and administration of CentOS Artwork Repository.
632e8b
632e8b
Copyright C 2009-2011 Alain Reguera Delgado
632e8b
632e8b
Permission is granted to copy, distribute and/or modify this document
632e8b
under the terms of the GNU Free Documentation License, Version 1.2 or
632e8b
any later version published by the Free Software Foundation; with no
632e8b
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
632e8b
copy of the license is included in the section entitled GNU Free
632e8b
Documentation License.  
632e8b
-->
ff7772
632e8b
632e8b
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
632e8b
            Karl Berry  <karl@freefriends.org>
632e8b
            Olaf Bachmann <obachman@mathematik.uni-kl.de>
632e8b
            and many others.
632e8b
Maintained by: Many creative people <dev@texi2html.cvshome.org>
632e8b
Send bugs and suggestions to <users@texi2html.cvshome.org>
632e8b
632e8b
-->
632e8b
<head>
632e8b
<title>CentOS Artwork Repository: 2.69 The trunk/Scripts/Bash/Cli/Functions/Render/Config Directory</title>
632e8b
632e8b
<meta name="description" content="CentOS Artwork Repository: 2.69 The trunk/Scripts/Bash/Cli/Functions/Render/Config Directory">
632e8b
<meta name="keywords" content="CentOS Artwork Repository: 2.69 The trunk/Scripts/Bash/Cli/Functions/Render/Config Directory">
632e8b
<meta name="resource-type" content="document">
632e8b
<meta name="distribution" content="global">
632e8b
<meta name="Generator" content="texi2html 1.76">
632e8b
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
632e8b
<style type="text/css">
632e8b
632e8b
@import "/home/centos/artwork/trunk/Identity/Models/Css/Texi2html/common.css";
632e8b
632e8b
a.summary-letter {text-decoration: none}
632e8b
pre.display {font-family: serif}
632e8b
pre.format {font-family: serif}
632e8b
pre.menu-comment {font-family: serif}
632e8b
pre.menu-preformatted {font-family: serif}
632e8b
pre.smalldisplay {font-family: serif; font-size: smaller}
632e8b
pre.smallexample {font-size: smaller}
632e8b
pre.smallformat {font-family: serif; font-size: smaller}
632e8b
pre.smalllisp {font-size: smaller}
632e8b
span.sansserif {font-family:sans-serif; font-weight:normal;}
632e8b
ul.toc {list-style: none}
632e8b
-->
632e8b
</style>
632e8b
632e8b
632e8b
</head>
632e8b
632e8b
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
632e8b
632e8b
ff7772
[ < ]
ff7772
[ > ]
632e8b
   
632e8b
[ << ]
632e8b
[ Up ]
ff7772
[ >> ]
632e8b
   
632e8b
   
632e8b
   
632e8b
   
632e8b
[Top]
632e8b
[Contents]
ff7772
[Index]
632e8b
[ ? ]
632e8b
632e8b
ff7772
632e8b

2.69 The <tt>`trunk/Scripts/Bash/Cli/Functions/Render/Config'</tt> Directory

632e8b
632e8b
ff7772
632e8b

2.69.1 Goals

632e8b
632e8b

The <tt>`trunk/Scripts/Bash/Config'</tt> directory exists to oraganize

632e8b
pre-rendering configuration scripts.
632e8b

632e8b
ff7772
632e8b

2.69.2 Description

632e8b
632e8b

Pre-rendering configuration scripts let you customize the way

632e8b
centos-art.sh script renders identity and translation
632e8b
repository entries.  Pre-rendering configuration scripts are
632e8b
<tt>`render.conf.sh'</tt> files with render_loadConfig function
632e8b
definition inside. 
632e8b

632e8b

There is one <tt>`render.conf.sh'</tt> file for each pre-rendering

632e8b
configuration entry. Pre-rendering configuration entries can be based
632e8b
both on identity and translation repository entires.  Pre-rendering
632e8b
configuration entries are required for each identity entry, but not
632e8b
for translation entries. 
632e8b

632e8b
ff7772
632e8b

2.69.2.1 The <tt>`render.conf.sh'</tt> identity model

632e8b
632e8b

Inside CentOS Artwork Repository, we consider identity entries to all

632e8b
directories under <tt>`trunk/Identity'</tt> directory. Identity entries can be
632e8b
image-based or text-based. When you render image-based identity
632e8b
entries you need to use image-based pre-rendering configuration
632e8b
scripts. Likewise, when you render text-based identity entries you
632e8b
need to use text-based pre-rendering configuration scripts.
632e8b

632e8b

Inside identity pre-rendering configuration scripts, image-based

632e8b
pre-rendering configuration scripts look like the following:
632e8b

632e8b
#!/bin/bash
632e8b
632e8b
function render_loadConfig {
632e8b
632e8b
    # Define rendering actions.
632e8b
    ACTIONS[0]='BASE:renderImage'
632e8b
    ACTIONS[1]='POST:renderFormats: tif xpm pdf ppm'
632e8b
632e8b
}
632e8b
632e8b

Inside identity pre-rendering configuration scripts, text-based

632e8b
pre-rendering configuration scripts look like the following:
632e8b

632e8b
#!/bin/bash
632e8b
632e8b
function render_loadConfig {
632e8b
632e8b
    # Define rendering actions.
632e8b
    ACTIONS[0]='BASE:renderText'
632e8b
    ACTIONS[1]='POST:formatText: --width=70 --uniform-spacing'
632e8b
632e8b
}
632e8b
632e8b

When using identity pre-rendering configuration scripts, you can

632e8b
extend both image-based and text-based pre-rendering configuration
632e8b
scripts using image-based and text-based post-rendering actions,
632e8b
respectively. 
632e8b

632e8b
ff7772
632e8b

2.69.2.2 The <tt>`render.conf.sh'</tt> translation model

632e8b
632e8b

Translation pre-rendering configuration scripts take precedence before

632e8b
default translation rendering action. Translation pre-rendering
632e8b
actions are useful when default translation rendering action do not
632e8b
fit itself to translation entry rendering requirements.
632e8b

632e8b
ff7772
632e8b

2.69.2.3 The <tt>`render.conf.sh'</tt> rendering actions

632e8b
632e8b

Inside both image-based and text-based identity pre-rendering

632e8b
configuration scripts, we use the <samp>`ACTIONS'</samp> array variable to
632e8b
define the way centos-art.sh script performs identity
632e8b
rendering.  Identity rendering is organized by one <samp>`BASE'</samp> action,
632e8b
and optional <samp>`POST'</samp> and <samp>`LAST'</samp> rendering actions.
632e8b

632e8b

The <samp>`BASE'</samp> action specifies what kind of rendering does the

632e8b
centos-art.sh script will perform with the files related to
632e8b
the pre-rendering configuration script. The <samp>`BASE'</samp> action is
632e8b
required. Possible values to <samp>`BASE'</samp> action are either
632e8b
<samp>`renderImage'</samp> or <samp>`renderText'</samp> only.
632e8b

632e8b

To specify the <samp>`BASE'</samp> action you need to set the <samp>`BASE:'</samp>

632e8b
string followed by one of the possible values. For example, if you
632e8b
want to render images, consider the following definition of
632e8b
<samp>`BASE'</samp> action:
632e8b

632e8b
ACTIONS[0]='BASE:renderImage'
632e8b
632e8b

Only one <samp>`BASE'</samp> action must be specified. If more than one

632e8b
<samp>`BASE'</samp> action is specified, the last one is used. If no
632e8b
<samp>`BASE'</samp> action is specified at all, an error is triggered and the
632e8b
centos-art.sh script ends its execution.
632e8b

632e8b

The <samp>`POST'</samp> action specifies which action to apply for

632e8b
each file rendered (at the rendering time). This action is optional.
632e8b
You can set many different <samp>`POST'</samp> actions to apply many different
632e8b
actions over the same already rendered file. Possible values to
632e8b
<samp>`POST'</samp> action are <samp>`renderFormats'</samp>, <samp>`renderSyslinux'</samp>,
632e8b
<samp>`renderGrub'</samp>, etc. 
632e8b

632e8b

To specify the <samp>`POST'</samp> action, you need to use set the

632e8b
<samp>`POST:'</samp> followed by the function name of the action you want to
632e8b
perform.  The exact form depends on your needs. For example, consider
632e8b
the following example to produce <samp>`xpm'</samp>, <samp>`jpg'</samp>, and
632e8b
<samp>`tif'</samp> images, based on already rendered <samp>`png'</samp> image, and
632e8b
also organize the produced files in directories named as their own
632e8b
extensions:
632e8b

632e8b
ACTIONS[0]='BASE:renderImage'
632e8b
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
632e8b
ACTIONS[2]='POST:groupByFormat: png xpm jpg tif'
632e8b
632e8b

In the previous example, file organization takes place at the moment

632e8b
of rendering, just after producing the <samp>`png'</samp> base file and before
632e8b
going to the next file in the list of files to render. If you don't
632e8b
want to organized the produced files in directories named as their own
632e8b
extensions, just remove the <samp>`POST:groupByFormat'</samp> action line:
632e8b

632e8b
ACTIONS[0]='BASE:renderImage'
632e8b
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
632e8b
632e8b

The <samp>`LAST'</samp> action specifies which actions to apply once the last

632e8b
file in the list of files to process has been rendered. The
632e8b
<samp>`LAST'</samp> action is optional. Possible values for <samp>`LAST'</samp>
632e8b
actions may be <samp>`groupByFormat'</samp>, <samp>`renderGdmTgz'</samp>, etc.
632e8b

632e8b
info

Note

-- Removed(xref:trunk Scripts Bash Functions Render) --, to know more

632e8b
about possible values for <samp>`BASE'</samp>, <samp>`POST'</samp> and <samp>`LAST'</samp>
632e8b
action definitions.
632e8b

632e8b
632e8b

To specify the <samp>`LAST'</samp> action, you need to set the <samp>`LAST:'</samp>

632e8b
string followed by the function name of the action you want to
632e8b
perform.  For example, consider the following example if you want to
632e8b
render all files first and organize them later:
632e8b

632e8b
ACTIONS[0]='BASE:renderImage'
632e8b
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
632e8b
ACTIONS[2]='LAST:groupByformat: png xpm jpg tif'
632e8b
632e8b
ff7772
632e8b

2.69.3 Usage

632e8b
632e8b

Use the following commands to administer both identity and translation

632e8b
pre-rendering configuration scripts:
632e8b

632e8b
632e8b
<samp>`centos-art config --create='path/to/dir/''</samp>
632e8b
632e8b

Use this command to create <samp>`path/to/dir'</samp> related pre-rendering

632e8b
configuration script.
632e8b

632e8b
632e8b
<samp>`centos-art config --edit='path/to/dir/''</samp>
632e8b
632e8b

Use this command to edit <samp>`path/to/dir'</samp> related pre-rendering

632e8b
configuration script.  
632e8b

632e8b
632e8b
<samp>`centos-art config --read='path/to/dir/''</samp>
632e8b
632e8b

Use this command to read <samp>`path/to/dir'</samp> related pre-rendering

632e8b
configuration script.  
632e8b

632e8b
632e8b
<samp>`centos-art config --remove='path/to/dir/''</samp>
632e8b
632e8b

Use this command to remove <samp>`path/to/dir'</samp> related pre-rendering

632e8b
configuration script.
632e8b

632e8b
632e8b
632e8b
632e8b

In the commands above, <samp>`path/to/dir'</samp> refers to one renderable

632e8b
directory path under <tt>`trunk/Identity'</tt> or
632e8b
<tt>`trunk/Translations'</tt> structures only. 
632e8b

632e8b
ff7772
632e8b

2.69.4 See also

632e8b
632e8b
ff7772
2.60 The <tt>`trunk/Scripts/Bash'</tt> Directory  
632e8b
632e8b
632e8b
632e8b
632e8b
ff7772
[ < ]
ff7772
[ > ]
632e8b
   
632e8b
[ << ]
ff7772
[ Up ]
ff7772
[ >> ]
632e8b
632e8b

632e8b
 <font size="-1">
ff7772
  This document was generated on March, 6 2011 using texi2html 1.76.
632e8b
 </font>
632e8b
 
632e8b
632e8b

632e8b
</body>
632e8b
</html>