|
 |
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 |
-->
|
|
|
8d4371 |
|
|
|
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>
|
|
|
6ba043 |
<title>CentOS Artwork Repository: 3.46 trunk/Scripts/Bash/Functions/Render/Config</title>
|
|
|
4c79b5 |
|
|
|
6ba043 |
<meta name="description" content="CentOS Artwork Repository: 3.46 trunk/Scripts/Bash/Functions/Render/Config">
|
|
|
6ba043 |
<meta name="keywords" content="CentOS Artwork Repository: 3.46 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 |
|
|
|
8d4371 |
[ < ]
|
|
|
8d4371 |
[ > ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
[ << ]
|
|
|
4c79b5 |
[ Up ]
|
|
|
8d4371 |
[ >> ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
[Top]
|
|
|
4c79b5 |
[Contents]
|
|
|
8d4371 |
[Index]
|
|
|
4c79b5 |
[ ? ]
|
|
|
4c79b5 |
|
|
|
6ba043 |
|
|
|
8d4371 |
|
|
|
6ba043 |
3.46 trunk/Scripts/Bash/Functions/Render/Config
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
8d4371 |
|
|
|
6ba043 |
3.46.1 Goals
|
|
|
6ba043 |
|
|
|
6ba043 |
The <tt>`trunk/Scripts/Bash/Config'</tt> directory exists to oraganize
|
|
|
6ba043 |
pre-rendering configuration scripts.
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
8d4371 |
|
|
|
6ba043 |
3.46.2 Description
|
|
|
4c79b5 |
|
|
|
6ba043 |
Pre-rendering configuration scripts let you customize the way
|
|
|
6ba043 |
centos-art.sh script renders identity and translation
|
|
|
6ba043 |
repository entries. Pre-rendering configuration scripts are
|
|
|
6ba043 |
<tt>`render.conf.sh'</tt> files with render_loadConfig function
|
|
|
6ba043 |
definition inside.
|
|
|
6ba043 |
|
|
|
6ba043 |
There is one <tt>`render.conf.sh'</tt> file for each pre-rendering
|
|
|
6ba043 |
configuration entry. Pre-rendering configuration entries can be based
|
|
|
6ba043 |
both on identity and translation repository entires. Pre-rendering
|
|
|
6ba043 |
configuration entries are required for each identity entry, but not
|
|
|
6ba043 |
for translation entries.
|
|
|
6ba043 |
|
|
|
4c79b5 |
|
|
|
8d4371 |
|
|
|
6ba043 |
3.46.2.1 The <tt>`render.conf.sh'</tt> identity model
|
|
|
4c79b5 |
|
|
|
6ba043 |
Inside CentOS Artwork Repository, we consider identity entries to all
|
|
|
6ba043 |
directories under <tt>`trunk/Identity'</tt> directory. Identity entries can be
|
|
|
6ba043 |
image-based or text-based. When you render image-based identity
|
|
|
6ba043 |
entries you need to use image-based pre-rendering configuration
|
|
|
6ba043 |
scripts. Likewise, when you render text-based identity entries you
|
|
|
6ba043 |
need to use text-based pre-rendering configuration scripts.
|
|
|
6ba043 |
|
|
|
6ba043 |
Inside identity pre-rendering configuration scripts, image-based
|
|
|
6ba043 |
pre-rendering configuration scripts look like the following:
|
|
|
6ba043 |
|
|
|
6ba043 |
#!/bin/bash
|
|
|
300762 |
|
|
|
6ba043 |
function render_loadConfig {
|
|
|
4c79b5 |
|
|
|
6ba043 |
# Define rendering actions.
|
|
|
6ba043 |
ACTIONS[0]='BASE:renderImage'
|
|
|
6ba043 |
ACTIONS[1]='POST:renderFormats: tif xpm pdf ppm'
|
|
|
6ba043 |
|
|
|
6ba043 |
}
|
|
|
6ba043 |
|
|
|
6ba043 |
Inside identity pre-rendering configuration scripts, text-based
|
|
|
6ba043 |
pre-rendering configuration scripts look like the following:
|
|
|
6ba043 |
|
|
|
6ba043 |
#!/bin/bash
|
|
|
4c79b5 |
|
|
|
6ba043 |
function render_loadConfig {
|
|
|
6ba043 |
|
|
|
6ba043 |
# Define rendering actions.
|
|
|
6ba043 |
ACTIONS[0]='BASE:renderText'
|
|
|
6ba043 |
ACTIONS[1]='POST:formatText: --width=70 --uniform-spacing'
|
|
|
6ba043 |
|
|
|
6ba043 |
}
|
|
|
6ba043 |
|
|
|
6ba043 |
When using identity pre-rendering configuration scripts, you can
|
|
|
6ba043 |
extend both image-based and text-based pre-rendering configuration
|
|
|
6ba043 |
scripts using image-based and text-based post-rendering actions,
|
|
|
6ba043 |
respectively.
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
8d4371 |
|
|
|
6ba043 |
3.46.2.2 The <tt>`render.conf.sh'</tt> translation model
|
|
|
5fb024 |
|
|
|
6ba043 |
Translation pre-rendering configuration scripts take precedence before
|
|
|
6ba043 |
default translation rendering action. Translation pre-rendering
|
|
|
6ba043 |
actions are useful when default translation rendering action do not
|
|
|
6ba043 |
fit itself to translation entry rendering requirements.
|
|
|
6ba043 |
|
|
|
300762 |
|
|
|
8d4371 |
|
|
|
6ba043 |
3.46.2.3 The <tt>`render.conf.sh'</tt> rendering actions
|
|
|
4c79b5 |
|
|
|
6ba043 |
Inside both image-based and text-based identity pre-rendering
|
|
|
6ba043 |
configuration scripts, we use the <samp>`ACTIONS'</samp> array variable to
|
|
|
6ba043 |
define the way centos-art.sh script performs identity
|
|
|
6ba043 |
rendering. Identity rendering is organized by one <samp>`BASE'</samp> action,
|
|
|
6ba043 |
and optional <samp>`POST'</samp> and <samp>`LAST'</samp> rendering actions.
|
|
|
6ba043 |
|
|
|
6ba043 |
The <samp>`BASE'</samp> action specifies what kind of rendering does the
|
|
|
6ba043 |
centos-art.sh script will perform with the files related to
|
|
|
6ba043 |
the pre-rendering configuration script. The <samp>`BASE'</samp> action is
|
|
|
6ba043 |
required. Possible values to <samp>`BASE'</samp> action are either
|
|
|
6ba043 |
<samp>`renderImage'</samp> or <samp>`renderText'</samp> only.
|
|
|
6ba043 |
|
|
|
6ba043 |
To specify the <samp>`BASE'</samp> action you need to set the <samp>`BASE:'</samp>
|
|
|
6ba043 |
string followed by one of the possible values. For example, if you
|
|
|
6ba043 |
want to render images, consider the following definition of
|
|
|
6ba043 |
<samp>`BASE'</samp> action:
|
|
|
6ba043 |
|
|
|
6ba043 |
ACTIONS[0]='BASE:renderImage'
|
|
|
6ba043 |
|
|
|
6ba043 |
Only one <samp>`BASE'</samp> action must be specified. If more than one
|
|
|
6ba043 |
<samp>`BASE'</samp> action is specified, the last one is used. If no
|
|
|
6ba043 |
<samp>`BASE'</samp> action is specified at all, an error is triggered and the
|
|
|
6ba043 |
centos-art.sh script ends its execution.
|
|
|
6ba043 |
|
|
|
6ba043 |
The <samp>`POST'</samp> action specifies which action to apply for
|
|
|
6ba043 |
each file rendered (at the rendering time). This action is optional.
|
|
|
6ba043 |
You can set many different <samp>`POST'</samp> actions to apply many different
|
|
|
6ba043 |
actions over the same already rendered file. Possible values to
|
|
|
6ba043 |
<samp>`POST'</samp> action are <samp>`renderFormats'</samp>, <samp>`renderSyslinux'</samp>,
|
|
|
6ba043 |
<samp>`renderGrub'</samp>, etc.
|
|
|
6ba043 |
|
|
|
6ba043 |
To specify the <samp>`POST'</samp> action, you need to use set the
|
|
|
6ba043 |
<samp>`POST:'</samp> followed by the function name of the action you want to
|
|
|
6ba043 |
perform. The exact form depends on your needs. For example, consider
|
|
|
6ba043 |
the following example to produce <samp>`xpm'</samp>, <samp>`jpg'</samp>, and
|
|
|
6ba043 |
<samp>`tif'</samp> images, based on already rendered <samp>`png'</samp> image, and
|
|
|
6ba043 |
also organize the produced files in directories named as their own
|
|
|
6ba043 |
extensions:
|
|
|
6ba043 |
|
|
|
6ba043 |
ACTIONS[0]='BASE:renderImage'
|
|
|
6ba043 |
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
|
|
|
6ba043 |
ACTIONS[2]='POST:groupByFormat: png xpm jpg tif'
|
|
|
6ba043 |
|
|
|
6ba043 |
In the previous example, file organization takes place at the moment
|
|
|
6ba043 |
of rendering, just after producing the <samp>`png'</samp> base file and before
|
|
|
6ba043 |
going to the next file in the list of files to render. If you don't
|
|
|
6ba043 |
want to organized the produced files in directories named as their own
|
|
|
6ba043 |
extensions, just remove the <samp>`POST:groupByFormat'</samp> action line:
|
|
|
6ba043 |
|
|
|
6ba043 |
ACTIONS[0]='BASE:renderImage'
|
|
|
6ba043 |
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
|
|
|
6ba043 |
|
|
|
6ba043 |
The <samp>`LAST'</samp> action specifies which actions to apply once the last
|
|
|
6ba043 |
file in the list of files to process has been rendered. The
|
|
|
6ba043 |
<samp>`LAST'</samp> action is optional. Possible values for <samp>`LAST'</samp>
|
|
|
6ba043 |
actions may be <samp>`groupByFormat'</samp>, <samp>`renderGdmTgz'</samp>, etc.
|
|
|
6ba043 |
|
|
|
8d4371 |
 Note See section trunk/Scripts/Bash/Functions/Render, to know more
|
|
|
6ba043 |
about possible values for <samp>`BASE'</samp>, <samp>`POST'</samp> and <samp>`LAST'</samp>
|
|
|
6ba043 |
action definitions.
|
|
|
6ba043 |
|
|
|
5fb024 |
|
|
|
6ba043 |
To specify the <samp>`LAST'</samp> action, you need to set the <samp>`LAST:'</samp>
|
|
|
6ba043 |
string followed by the function name of the action you want to
|
|
|
6ba043 |
perform. For example, consider the following example if you want to
|
|
|
6ba043 |
render all files first and organize them later:
|
|
|
6ba043 |
|
|
|
6ba043 |
ACTIONS[0]='BASE:renderImage'
|
|
|
6ba043 |
ACTIONS[1]='POST:renderFormats: xpm jpg tif'
|
|
|
6ba043 |
ACTIONS[2]='LAST:groupByformat: png xpm jpg tif'
|
|
|
6ba043 |
|
|
|
300762 |
|
|
|
8d4371 |
|
|
|
6ba043 |
3.46.3 Usage
|
|
|
6ba043 |
|
|
|
6ba043 |
Use the following commands to administer both identity and translation
|
|
|
6ba043 |
pre-rendering configuration scripts:
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
6ba043 |
<samp>`centos-art config 'path/to/dir/' --create'</samp>
|
|
|
6ba043 |
|
|
|
6ba043 |
Use this command to create <samp>`path/to/dir'</samp> related pre-rendering
|
|
|
6ba043 |
configuration script.
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
6ba043 |
<samp>`centos-art config 'path/to/dir/' --edit'</samp>
|
|
|
6ba043 |
|
|
|
6ba043 |
Use this command to edit <samp>`path/to/dir'</samp> related pre-rendering
|
|
|
6ba043 |
configuration script.
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
6ba043 |
<samp>`centos-art config 'path/to/dir/' --read'</samp>
|
|
|
6ba043 |
|
|
|
6ba043 |
Use this command to read <samp>`path/to/dir'</samp> related pre-rendering
|
|
|
6ba043 |
configuration script.
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
6ba043 |
<samp>`centos-art config 'path/to/dir/' --remove'</samp>
|
|
|
6ba043 |
|
|
|
6ba043 |
Use this command to remove <samp>`path/to/dir'</samp> related pre-rendering
|
|
|
6ba043 |
configuration script.
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
6ba043 |
In the commands above, <samp>`path/to/dir'</samp> refers to one renderable
|
|
|
6ba043 |
directory path under <tt>`trunk/Identity'</tt> or
|
|
|
6ba043 |
<tt>`trunk/Translations'</tt> structures only.
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
8d4371 |
|
|
|
4c79b5 |
3.46.4 See also
|
|
|
4c79b5 |
|
|
|
6ba043 |
|
|
|
8d4371 |
3.35 trunk/Scripts/Bash/Config/Identity
|
|
|
6ba043 |
|
|
|
8d4371 |
3.36 trunk/Scripts/Bash/Config/Translations
|
|
|
6ba043 |
|
|
|
8d4371 |
3.34 trunk/Scripts/Bash
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
8d4371 |
[ < ]
|
|
|
8d4371 |
[ > ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
[ << ]
|
|
|
8d4371 |
[ Up ]
|
|
|
8d4371 |
[ >> ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
<font size="-1">
|
|
|
8d4371 |
This document was generated on October, 19 2010 using texi2html 1.76.
|
|
|
4c79b5 |
</font>
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
</body>
|
|
|
4c79b5 |
</html>
|