Blame Manuals/Repository-fs/repository-fs-html/repository_57.html

4c79b5
4c79b5
<html>
ccb7a3
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
-->
bf28e1
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>
1023f4
<title>CentOS Artwork Repository: 3.54 trunk/Scripts/Bash/Functions/Render/Config</title>
4c79b5
1023f4
<meta name="description" content="CentOS Artwork Repository: 3.54 trunk/Scripts/Bash/Functions/Render/Config">
1023f4
<meta name="keywords" content="CentOS Artwork Repository: 3.54 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
300762
1023f4
[ < ]
1023f4
[ > ]
4c79b5
   
4c79b5
[ << ]
4c79b5
[ Up ]
1023f4
[ >> ]
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
[Top]
4c79b5
[Contents]
1023f4
[Index]
4c79b5
[ ? ]
4c79b5
1023f4
1023f4
1023f4

3.54 trunk/Scripts/Bash/Functions/Render/Config

70ef27
70ef27
1023f4
70ef27

3.54.1 Goals

70ef27
1023f4

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

1023f4
pre-rendering configuration scripts.
70ef27

70ef27
1023f4
70ef27

3.54.2 Description

70ef27
1023f4

Pre-rendering configuration scripts let you customize the way

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

1023f4

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

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

70ef27
1023f4
1023f4

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

70ef27
1023f4

Inside CentOS Artwork Repository, we consider identity entries to all

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

1023f4

Inside identity pre-rendering configuration scripts, image-based

1023f4
pre-rendering configuration scripts look like the following:
70ef27

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

Inside identity pre-rendering configuration scripts, text-based

1023f4
pre-rendering configuration scripts look like the following:
70ef27

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

When using identity pre-rendering configuration scripts, you can

1023f4
extend both image-based and text-based pre-rendering configuration
1023f4
scripts using image-based and text-based post-rendering actions,
1023f4
respectively. 
c2a1bc

c2a1bc
1023f4
1023f4

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

70ef27
1023f4

Translation pre-rendering configuration scripts take precedence before

1023f4
default translation rendering action. Translation pre-rendering
1023f4
actions are useful when default translation rendering action do not
1023f4
fit itself to translation entry rendering requirements.
6a8116

7e35dc
1023f4
1023f4

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

70ef27
1023f4

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

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

1023f4

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

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

1023f4

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

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

1023f4
ACTIONS[0]='BASE:renderImage'
1023f4
1023f4

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

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

1023f4

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

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

1023f4

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

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

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

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

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

1023f4
ACTIONS[0]='BASE:renderImage'
1023f4
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
1023f4
1023f4

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

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

1023f4
info

Note

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

1023f4
about possible values for <samp>`BASE'</samp>, <samp>`POST'</samp> and <samp>`LAST'</samp>
1023f4
action definitions.
42563b

c12cdc
1023f4

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

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

1023f4
ACTIONS[0]='BASE:renderImage'
1023f4
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
1023f4
ACTIONS[2]='LAST:groupByformat: png xpm jpg tif'
2c3589
c2a1bc
1023f4
70ef27

3.54.3 Usage

bf28e1
1023f4

Use the following commands to administer both identity and translation

1023f4
pre-rendering configuration scripts:
1023f4

7e35dc
1023f4
<samp>`centos-art config --create='path/to/dir/''</samp>
1023f4
1023f4

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

1023f4
configuration script.
1023f4

1023f4
1023f4
<samp>`centos-art config --edit='path/to/dir/''</samp>
2c3589
1023f4

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

1023f4
configuration script.  
2c3589

2c3589
1023f4
<samp>`centos-art config --read='path/to/dir/''</samp>
7e35dc
1023f4

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

1023f4
configuration script.  
1023f4

1023f4
1023f4
<samp>`centos-art config --remove='path/to/dir/''</samp>
1023f4
1023f4

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

1023f4
configuration script.
42563b

70ef27
7e35dc
7e35dc
1023f4

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

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

70ef27
1023f4
70ef27

3.54.4 See also

300762
ec5f63
1023f4
3.47 trunk/Scripts/Bash  
1023f4
1023f4
3.48 trunk/Scripts/Bash/Functions  
70ef27
1023f4
3.53 trunk/Scripts/Bash/Functions/Render  
ec5f63
ec5f63
ec5f63
300762
300762
1023f4
[ < ]
1023f4
[ > ]
300762
   
300762
[ << ]
1023f4
[ Up ]
1023f4
[ >> ]
300762
4c79b5

4c79b5
 <font size="-1">
bf28e1
  This document was generated on February, 27 2011 using texi2html 1.76.
4c79b5
 </font>
4c79b5
 
4c79b5
4c79b5

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