Blame Manual/centos-art.sh-html/centos-art.sh_79.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
-->
52772c
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>
1856b7
<title>centos-art.sh: 2.72 The trunk/Scripts/Bash/Cli/Functions/Render/Config Directory</title>
632e8b
1856b7
<meta name="description" content="centos-art.sh: 2.72 The trunk/Scripts/Bash/Cli/Functions/Render/Config Directory">
1856b7
<meta name="keywords" content="centos-art.sh: 2.72 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
1856b7
[ < ]
52772c
[ > ]
632e8b
   
1856b7
[ << ]
1856b7
[ Up ]
1856b7
[ >> ]
632e8b
   
632e8b
   
632e8b
   
632e8b
   
1856b7
[Top]
1856b7
[Contents]
1856b7
[Index]
1856b7
[ ? ]
632e8b
52772c
52772c
52772c

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

06d106
06d106
52772c
52772c

2.72.1 Goals

06d106
52772c

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

52772c
pre-rendering configuration scripts.
06d106

06d106
52772c
52772c

2.72.2 Description

06d106
52772c

Pre-rendering configuration scripts let you customize the way

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

52772c

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

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

06d106
52772c
52772c

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

52772c
52772c

Inside CentOS Artwork Repository, we consider identity entries to all

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

52772c

Inside identity pre-rendering configuration scripts, image-based

52772c
pre-rendering configuration scripts look like the following:
52772c

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

Inside identity pre-rendering configuration scripts, text-based

52772c
pre-rendering configuration scripts look like the following:
52772c

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

When using identity pre-rendering configuration scripts, you can

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

52772c
52772c
52772c

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

52772c
52772c

Translation pre-rendering configuration scripts take precedence before

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

52772c
52772c
52772c

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

52772c
52772c

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

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

52772c

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

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

52772c

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

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

52772c
ACTIONS[0]='BASE:renderImage'
52772c
52772c

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

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

52772c

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

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

52772c

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

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

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

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

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

52772c
ACTIONS[0]='BASE:renderImage'
52772c
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
52772c
52772c

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

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

52772c
info

Note

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

52772c
about possible values for <samp>`BASE'</samp>, <samp>`POST'</samp> and <samp>`LAST'</samp>
52772c
action definitions.
06d106

06d106
52772c

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

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

52772c
ACTIONS[0]='BASE:renderImage'
52772c
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
52772c
ACTIONS[2]='LAST:groupByformat: png xpm jpg tif'
52772c
06d106
52772c
52772c

2.72.3 Usage

06d106
52772c

Use the following commands to administer both identity and translation

52772c
pre-rendering configuration scripts:
06d106

06d106
52772c
<samp>`centos-art config --create='path/to/dir/''</samp>
06d106
52772c

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

52772c
configuration script.
06d106

06d106
52772c
<samp>`centos-art config --edit='path/to/dir/''</samp>
06d106
52772c

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

52772c
configuration script.  
06d106

06d106
52772c
<samp>`centos-art config --read='path/to/dir/''</samp>
06d106
52772c

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

52772c
configuration script.  
06d106

06d106
52772c
<samp>`centos-art config --remove='path/to/dir/''</samp>
06d106
52772c

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

52772c
configuration script.
06d106

06d106
06d106
06d106
52772c

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

52772c
directory path under <tt>`trunk/Identity'</tt> or
52772c
<tt>`trunk/Translations'</tt> structures only. 
06d106

06d106
52772c
52772c

2.72.4 See also

06d106
06d106
1856b7
2.62 The <tt>`trunk/Scripts/Bash'</tt> Directory  
06d106
9bfd15
632e8b
632e8b
632e8b
52772c
[ < ]
1856b7
[ > ]
632e8b
   
1856b7
[ << ]
52772c
[ Up ]
1856b7
[ >> ]
632e8b
632e8b

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

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