|
 |
4c79b5 |
|
|
|
4c79b5 |
<html>
|
|
|
4c79b5 |
|
|
|
4c79b5 |
can you do inside it.
|
|
|
4c79b5 |
|
|
|
6c4982 |
Copyright C 2009, 2010 Alain Reguera Delgado. 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 |
-->
|
|
|
5eb4a2 |
|
|
|
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.34 trunk/Scripts/Bash</title>
|
|
|
4c79b5 |
|
|
|
6ba043 |
<meta name="description" content="CentOS Artwork Repository: 3.34 trunk/Scripts/Bash">
|
|
|
6ba043 |
<meta name="keywords" content="CentOS Artwork Repository: 3.34 trunk/Scripts/Bash">
|
|
|
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 |
|
|
|
d06c98 |
[ < ]
|
|
|
d06c98 |
[ > ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
[ << ]
|
|
|
4c79b5 |
[ Up ]
|
|
|
915635 |
[ >> ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
[Top]
|
|
|
4c79b5 |
[Contents]
|
|
|
915635 |
[Index]
|
|
|
4c79b5 |
[ ? ]
|
|
|
4c79b5 |
|
|
|
6ba043 |
|
|
|
d06c98 |
|
|
|
6ba043 |
3.34 trunk/Scripts/Bash
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
d06c98 |
|
|
|
6ba043 |
3.34.1 Goals
|
|
|
6ba043 |
|
|
|
efa7b7 |
The <tt>`trunk/Scripts/Bash'</tt> directory exists to organize the trunk
|
|
|
efa7b7 |
development line of <tt>`centos-art.sh'</tt> automation script. The
|
|
|
efa7b7 |
<tt>`centos-art.sh'</tt> script standardizes frequent tasks inside your
|
|
|
efa7b7 |
working copy of CentOS Artwork Repository.
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
d06c98 |
|
|
|
6ba043 |
3.34.2 Description
|
|
|
6ba043 |
|
|
|
efa7b7 |
The best way to understand <tt>`centos-art.sh'</tt> automation script is
|
|
|
efa7b7 |
studying its source code. The <tt>`centos-art.sh'</tt> script is splited
|
|
|
efa7b7 |
in several configuration and function files which are loaded when the
|
|
|
efa7b7 |
<tt>`centos-art.sh'</tt> script is executed. This section describes the
|
|
|
efa7b7 |
order in which <tt>`centos-art.sh'</tt> loads its configuration and
|
|
|
efa7b7 |
function files.
|
|
|
6ba043 |
|
|
|
6ba043 |
When you type the centos-art command in your terminal, the
|
|
|
6ba043 |
operating system trys to execute that command. In order to execute the
|
|
|
6ba043 |
command, the operating system needs to know where it is, so the
|
|
|
6ba043 |
operating system uses the PATH environment variable to look for
|
|
|
6ba043 |
that command's location. If your system was prepared to use CentOS
|
|
|
915635 |
Artwork Repository correctly (see section trunk/Scripts/Bash/Functions/Verify), you should have a symbolic link inside <tt>`~/bin/'</tt>
|
|
|
efa7b7 |
directory that points to the <tt>`centos-art.sh'</tt> script file. As
|
|
|
efa7b7 |
<tt>`~/bin/'</tt> directory is, by default, inside PATH environment
|
|
|
efa7b7 |
variable, the execution of centos-art command runs the
|
|
|
efa7b7 |
<tt>`centos-art.sh'</tt> script.
|
|
|
6ba043 |
|
|
|
efa7b7 |
When <tt>`centos-art.sh'</tt> script is executed, the first it does is
|
|
|
efa7b7 |
executing the <tt>`trunk/Scripts/Bash/initFunctions.sh'</tt> script to
|
|
|
efa7b7 |
initialize global variables (e.g., gettext's variables) and
|
|
|
efa7b7 |
global function scripts. Global function scripts are located inside
|
|
|
efa7b7 |
<tt>`trunk/Scripts/Bash/Functions'</tt> directory and their file names
|
|
|
efa7b7 |
begin with <samp>`cli'</samp>. Global function scripts provide common
|
|
|
efa7b7 |
functionalities that can be used anywhere inside <tt>`centos-art.sh'</tt>
|
|
|
efa7b7 |
script execution environment.
|
|
|
6ba043 |
|
|
|
efa7b7 |
Once global variables and function scripts have been loaded,
|
|
|
efa7b7 |
<tt>`centos-art.sh'</tt> script executes the cli global function
|
|
|
efa7b7 |
from <tt>`cli.sh'</tt> function script to retrive command-line arguments
|
|
|
efa7b7 |
and define some default values that may be used later by specific
|
|
|
efa7b7 |
function scripts (see section trunk/Scripts/Bash/Functions).
|
|
|
6ba043 |
|
|
|
efa7b7 |
As convenction, the <tt>`centos-art.sh'</tt> command-line arguments have
|
|
|
efa7b7 |
the following format:
|
|
|
efa7b7 |
|
|
|
efa7b7 |
centos-art arg1 --arg2=val2 --arg3=val3
|
|
|
efa7b7 |
|
|
|
efa7b7 |
In the above example, <samp>`centos-art'</samp> is the command you use to
|
|
|
efa7b7 |
invoke <tt>`centos-art.sh'</tt> script. The <samp>`arg1'</samp> represents the
|
|
|
efa7b7 |
action you want to do (e.g., <samp>`verify'</samp>, <samp>`render'</samp>,
|
|
|
efa7b7 |
<samp>`locale'</samp>, <samp>`help'</samp>, etc.). The remaining arguments are
|
|
|
efa7b7 |
modifiers to <samp>`arg1'</samp>. The <samp>`--arg2'</samp> definition is
|
|
|
efa7b7 |
required. The <samp>`--arg3'</samp> is optional. For example, if you want
|
|
|
efa7b7 |
to render all anaconda progress slides, for all major releases of
|
|
|
efa7b7 |
CentOS distribution, for all languages availabe using TreeFlower motif
|
|
|
efa7b7 |
as background, you use the following command:
|
|
|
efa7b7 |
|
|
|
efa7b7 |
centos-art render --entry=trunk/Identity/Themes/Motifs/TreeFlower/Distro/Anaconda/Progress
|
|
|
efa7b7 |
|
|
|
efa7b7 |
Now, if you only want to render anaconda progress
|
|
|
efa7b7 |
<tt>`01-welcome.png'</tt> slide, for CentOS distribution major release 5,
|
|
|
efa7b7 |
in English language, you need to add the third argument as follows:
|
|
|
efa7b7 |
|
|
|
efa7b7 |
centos-art render --entry=trunk/Identity/Themes/Motifs/TreeFlower/Distro/Anaconda/Progress --filter=5/en/01-welcome
|
|
|
efa7b7 |
|
|
|
efa7b7 |
Once command-line arguments have been retrived, the
|
|
|
efa7b7 |
<tt>`centos-art.sh'</tt> script loads specific functions using the
|
|
|
efa7b7 |
<tt>`cli_getActions.sh'</tt> function script. For example, if you run the
|
|
|
efa7b7 |
command centos-art render --entry, the <tt>`centos-art.sh'</tt>
|
|
|
efa7b7 |
script will look for <tt>`trunk/Scripts/Bash/Functions/Render'</tt>
|
|
|
6c4982 |
directory and will load the render function from
|
|
|
6c4982 |
<tt>`render.sh'</tt> function script; this, in order to achive the
|
|
|
6c4982 |
rendering task as it defines.
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
6ba043 |
+------------------------------------------------------------------+
|
|
|
6ba043 |
| [centos@host]$ centos-art action 'path/to/dir' --option='value' |
|
|
|
6ba043 |
+------------------------------------------------------------------+
|
|
|
6ba043 |
| ~/bin/centos-art --> ~/artwork/trunk/Scripts/Bash/centos-art.sh |
|
|
|
6ba043 |
+---v-----------------------------------------v--------------------+
|
|
|
6ba043 |
| centos-art.sh |
|
|
|
6ba043 |
+---v---------------------------------v---+
|
|
|
6ba043 |
. | initFunctions.sh | .
|
|
|
6ba043 |
. +---------------------------------+ .
|
|
|
efa7b7 |
. | cli $@ | .
|
|
|
6ba043 |
. +---v-------------------------v---+ .
|
|
|
915635 |
. . | cli_getActions $@ | . .
|
|
|
6ba043 |
. . +---v-----------------v---+ . .
|
|
|
6ba043 |
. . . | function call 1 | . . .
|
|
|
6ba043 |
. . . | function call 2 | . . .
|
|
|
6ba043 |
. . . | function call n | . . .
|
|
|
6ba043 |
. . . +-----------------+ . . .
|
|
|
6ba043 |
. . ........................... . .
|
|
|
6ba043 |
. ................................... .
|
|
|
6ba043 |
...........................................
|
|
|
6ba043 |
|
|
|
5eb4a2 |
Figure 3.8: The <tt>`centos-art.sh'</tt> initialization environment.
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
d06c98 |
|
|
|
6ba043 |
3.34.3 Usage
|
|
|
6ba043 |
|
|
|
efa7b7 |
The <tt>`centos-art.sh'</tt> script usage information is described inside
|
|
|
efa7b7 |
each specific function documentation (see section trunk/Scripts/Bash/Functions).
|
|
|
6ba043 |
|
|
|
6ba043 |
|
|
|
efa7b7 |
|
|
|
5fb024 |
3.34.4 See also
|
|
|
4c79b5 |
|
|
|
6ba043 |
|
|
|
d06c98 |
3.33 trunk/Scripts
|
|
|
6ba043 |
|
|
|
6c4982 |
3.35 trunk/Scripts/Bash/Functions
|
|
|
6c4982 |
|
|
|
915635 |
3.45 trunk/Scripts/Bash/Locale
|
|
|
efa7b7 |
|
|
|
6ba043 |
|
|
|
4c79b5 |
|
|
|
bc3531 |
|
|
|
4c79b5 |
|
|
|
efa7b7 |
[ < ]
|
|
|
efa7b7 |
[ > ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
[ << ]
|
|
|
d06c98 |
[ Up ]
|
|
|
915635 |
[ >> ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
<font size="-1">
|
|
|
5eb4a2 |
This document was generated on November, 12 2010 using texi2html 1.76.
|
|
|
4c79b5 |
</font>
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
</body>
|
|
|
4c79b5 |
</html>
|