Blame Manuals/en/Html/Repository/repository_45.html

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

3.42 trunk/Scripts/Bash/Functions/Render/Config

fe989b
54264c
12494b
c9b54d

3.42.1 Goals

c9b54d
38bcd9

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

38bcd9
pre-rendering configuration scripts.
38bcd9

38bcd9
12494b
38bcd9

3.42.2 Description

38bcd9
38bcd9

Pre-rendering configuration scripts let you customize the way

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

38bcd9

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

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

38bcd9
12494b
38bcd9

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

38bcd9
38bcd9

Inside CentOS Artwork Repository, we consider identity entries to all

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

38bcd9

Inside identity pre-rendering configuration scripts, image-based

38bcd9
pre-rendering configuration scripts look like the following:
38bcd9

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

Inside identity pre-rendering configuration scripts, text-based

38bcd9
pre-rendering configuration scripts look like the following:
38bcd9

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

When using identity pre-rendering configuration scripts, you can

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

fe989b
12494b
38bcd9

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

38bcd9
38bcd9

Translation pre-rendering configuration scripts take precedence before

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

fe989b
12494b
38bcd9

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

fe989b
38bcd9

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

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

38bcd9

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

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

38bcd9

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

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

38bcd9
ACTIONS[0]='BASE:renderImage'
38bcd9
38bcd9

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

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

38bcd9

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

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

38bcd9

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

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

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

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

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

38bcd9
ACTIONS[0]='BASE:renderImage'
38bcd9
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
38bcd9
38bcd9

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

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

12494b
info

Note

See section trunk/Scripts/Bash/Functions/Render, to know more

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

fe989b
38bcd9

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

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

38bcd9
ACTIONS[0]='BASE:renderImage'
38bcd9
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
38bcd9
ACTIONS[2]='LAST:groupByformat: png xpm jpg tif'
38bcd9
fe989b
12494b
fe989b

3.42.3 Usage

fe989b
38bcd9

Use the following commands to administer both identity and translation

38bcd9
pre-rendering configuration scripts:
38bcd9

38bcd9
38bcd9
<samp>`centos-art config 'path/to/dir/' --create'</samp>
38bcd9
38bcd9

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

38bcd9
configuration script.
38bcd9

38bcd9
38bcd9
<samp>`centos-art config 'path/to/dir/' --edit'</samp>
38bcd9
38bcd9

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

38bcd9
configuration script.  
38bcd9

38bcd9
38bcd9
<samp>`centos-art config 'path/to/dir/' --read'</samp>
38bcd9
38bcd9

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

38bcd9
configuration script.  
38bcd9

38bcd9
38bcd9
<samp>`centos-art config 'path/to/dir/' --remove'</samp>
38bcd9
38bcd9

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

38bcd9
configuration script.
38bcd9

38bcd9
38bcd9
fe989b
38bcd9

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

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

fe989b
12494b
54264c

3.42.4 See also

4c79b5
38bcd9
38bcd9
3.34 trunk/Scripts/Bash  
38bcd9
38bcd9
4c79b5
4c79b5
4c79b5
12494b
[ < ]
12494b
[ > ]
4c79b5
   
4c79b5
[ << ]
12494b
[ Up ]
12494b
[ >> ]
4c79b5
4c79b5

4c79b5
 <font size="-1">
12494b
  This document was generated on October, 29 2010 using texi2html 1.76.
4c79b5
 </font>
4c79b5
 
4c79b5
4c79b5

4c79b5
</body>
4c79b5
</html>