Blame Manual/repository-html/repository_60.html

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

2.58 Filesystem/trunk/Scripts/Bash/Cli/Functions/Render/Config

ee1f37
ee1f37
982d5c
982d5c

2.58.1 Goals

ee1f37
982d5c

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

982d5c
pre-rendering configuration scripts.
ee1f37

ee1f37
982d5c
982d5c

2.58.2 Description

982d5c
982d5c

Pre-rendering configuration scripts let you customize the way

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

982d5c

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

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

982d5c
982d5c
982d5c

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

982d5c
982d5c

Inside CentOS Artwork Repository, we consider identity entries to all

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

982d5c

Inside identity pre-rendering configuration scripts, image-based

982d5c
pre-rendering configuration scripts look like the following:
982d5c

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

Inside identity pre-rendering configuration scripts, text-based

982d5c
pre-rendering configuration scripts look like the following:
010b2d

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

When using identity pre-rendering configuration scripts, you can

982d5c
extend both image-based and text-based pre-rendering configuration
982d5c
scripts using image-based and text-based post-rendering actions,
982d5c
respectively. 
010b2d

982d5c
982d5c
982d5c

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

982d5c
982d5c

Translation pre-rendering configuration scripts take precedence before

982d5c
default translation rendering action. Translation pre-rendering
982d5c
actions are useful when default translation rendering action do not
982d5c
fit itself to translation entry rendering requirements.
010b2d

ee1f37
982d5c
982d5c

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

982d5c
982d5c

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

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

982d5c

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

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

982d5c

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

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

982d5c
ACTIONS[0]='BASE:renderImage'
010b2d
982d5c

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

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

982d5c

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

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

982d5c

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

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

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

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

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

982d5c
ACTIONS[0]='BASE:renderImage'
982d5c
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
010b2d
982d5c

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

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

982d5c
info

Note

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

982d5c
about possible values for <samp>`BASE'</samp>, <samp>`POST'</samp> and <samp>`LAST'</samp>
982d5c
action definitions.
ee1f37

ee1f37
982d5c

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

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

982d5c
ACTIONS[0]='BASE:renderImage'
982d5c
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
982d5c
ACTIONS[2]='LAST:groupByformat: png xpm jpg tif'
982d5c
ee1f37
010b2d
982d5c

2.58.3 Usage

ee1f37
982d5c

Use the following commands to administer both identity and translation

982d5c
pre-rendering configuration scripts:
982d5c

ee1f37
982d5c
<samp>`centos-art config --create='path/to/dir/''</samp>
982d5c
982d5c

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

982d5c
configuration script.
010b2d

982d5c
982d5c
<samp>`centos-art config --edit='path/to/dir/''</samp>
982d5c
982d5c

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

982d5c
configuration script.  
010b2d

982d5c
982d5c
<samp>`centos-art config --read='path/to/dir/''</samp>
982d5c
982d5c

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

982d5c
configuration script.  
982d5c

982d5c
982d5c
<samp>`centos-art config --remove='path/to/dir/''</samp>
982d5c
982d5c

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

982d5c
configuration script.
982d5c

982d5c
982d5c
982d5c
982d5c

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

982d5c
directory path under <tt>`trunk/Identity'</tt> or
982d5c
<tt>`trunk/Translations'</tt> structures only. 
010b2d

ee1f37
010b2d
982d5c

2.58.4 See also

ee1f37
ee1f37
5cb5a7
2.49 Filesystem/trunk/Scripts/Bash  
ee1f37
ee1f37
ee1f37
ee1f37
ee1f37
010b2d
[ < ]
56a476
[ > ]
ee1f37
   
982d5c
[ << ]
982d5c
[ Up ]
5cb5a7
[ >> ]
ee1f37
ee1f37

ee1f37
 <font size="-1">
406f69
  This document was generated on March, 1 2011 using texi2html 1.76.
ee1f37
 </font>
ee1f37
 
ee1f37
ee1f37

ee1f37
</body>
ee1f37
</html>