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

4c79b5
4c79b5
<html>
09d4f2
09d4f2
09d4f2
The CentOS Artwork Repository exists to organize and automate The
09d4f2
CentOS Project corporate visual identity (, to
09d4f2
start on).
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
-->
97552b
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 ]
09d4f2
[ >> ]
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
[Top]
4c79b5
[Contents]
09d4f2
[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
09d4f2
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
09d4f2
3.45 trunk/Scripts/Bash/Locale  
efa7b7
6ba043
4c79b5
bc3531
4c79b5
efa7b7
[ < ]
efa7b7
[ > ]
4c79b5
   
4c79b5
[ << ]
d06c98
[ Up ]
09d4f2
[ >> ]
4c79b5
4c79b5

4c79b5
 <font size="-1">
97552b
  This document was generated on November, 26 2010 using texi2html 1.76.
4c79b5
 </font>
4c79b5
 
4c79b5
4c79b5

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