Blame Manuals/en/Html/Repository/repository_39.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
-->
008ee0
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>
63f275
<title>CentOS Artwork Repository: 3.36 trunk/Scripts/Bash</title>
4c79b5
63f275
<meta name="description" content="CentOS Artwork Repository: 3.36 trunk/Scripts/Bash">
63f275
<meta name="keywords" content="CentOS Artwork Repository: 3.36 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
008ee0
[ < ]
008ee0
[ > ]
4c79b5
   
4c79b5
[ << ]
4c79b5
[ Up ]
035049
[ >> ]
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
[Top]
4c79b5
[Contents]
035049
[Index]
4c79b5
[ ? ]
4c79b5
63f275
008ee0
63f275

3.36 trunk/Scripts/Bash

4c79b5
5fb024
008ee0
5fb024

3.36.1 Goals

5fb024
63f275

The <tt>`trunk/Scripts/Bash'</tt> directory exists to organize the trunk

63f275
development line of <tt>`centos-art.sh'</tt> automation script.  The
63f275
<tt>`centos-art.sh'</tt> script standardizes frequent tasks inside your
63f275
working copy of CentOS Artwork Repository.
63f275

5fb024
008ee0
5fb024

3.36.2 Description

5fb024
63f275

The best way to understand <tt>`centos-art.sh'</tt> automation script is

63f275
studying its source code. The <tt>`centos-art.sh'</tt> script is splited
63f275
in several configuration and function files which are loaded when the
63f275
<tt>`centos-art.sh'</tt> script is executed. This section describes the
63f275
order in which <tt>`centos-art.sh'</tt> loads its configuration and
63f275
function files.
54b5a5

63f275

When you type the centos-art command in your terminal, the

63f275
operating system trys to execute that command. In order to execute the
63f275
command, the operating system needs to know where it is, so the
63f275
operating system uses the PATH environment variable to look for
63f275
that command's location. If your system was prepared to use CentOS
035049
Artwork Repository correctly (see section trunk/Scripts/Bash/Functions/Verify), you should have a symbolic link inside <tt>`~/bin/'</tt>
63f275
directory that points to the <tt>`centos-art.sh'</tt> script file. As
63f275
<tt>`~/bin/'</tt> directory is, by default, inside PATH environment
63f275
variable, the execution of centos-art command runs the
63f275
<tt>`centos-art.sh'</tt> script.
54b5a5

63f275

When <tt>`centos-art.sh'</tt> script is executed, the first it does is

63f275
executing the <tt>`trunk/Scripts/Bash/initFunctions.sh'</tt> script to
63f275
initialize global variables (e.g., gettext's variables) and
63f275
global function scripts.  Global function scripts are located inside
63f275
<tt>`trunk/Scripts/Bash/Functions'</tt> directory and their file names
63f275
begin with <samp>`cli'</samp>. Global function scripts provide common
63f275
functionalities that can be used anywhere inside <tt>`centos-art.sh'</tt>
63f275
script execution environment.
54b5a5

63f275

Once global variables and function scripts have been loaded,

63f275
<tt>`centos-art.sh'</tt> script executes the cli global function
63f275
from <tt>`cli.sh'</tt> function script to retrive command-line arguments
63f275
and define some default values that may be used later by specific
63f275
function scripts (see section trunk/Scripts/Bash/Functions).
54b5a5

63f275

As convenction, the <tt>`centos-art.sh'</tt> command-line arguments have

63f275
the following format:
54b5a5

63f275
centos-art arg1 --arg2=val2 --arg3=val3
63f275
63f275

In the above example, <samp>`centos-art'</samp> is the command you use to

63f275
invoke <tt>`centos-art.sh'</tt> script. The <samp>`arg1'</samp> represents the
63f275
action you want to do (e.g., <samp>`verify'</samp>, <samp>`render'</samp>,
63f275
<samp>`locale'</samp>, <samp>`help'</samp>, etc.). The remaining arguments are
63f275
modifiers to <samp>`arg1'</samp>. The <samp>`--arg2'</samp> definition is
63f275
required.  The <samp>`--arg3'</samp> is optional. For example, if you want
63f275
to render all anaconda progress slides, for all major releases of
63f275
CentOS distribution, for all languages availabe using TreeFlower motif
63f275
as background, you use the following command:
63f275

63f275
centos-art render --entry=trunk/Identity/Themes/Motifs/TreeFlower/Distro/Anaconda/Progress
63f275
63f275

Now, if you only want to render anaconda progress

63f275
<tt>`01-welcome.png'</tt> slide, for CentOS distribution major release 5,
63f275
in English language, you need to add the third argument as follows:
63f275

63f275
centos-art render --entry=trunk/Identity/Themes/Motifs/TreeFlower/Distro/Anaconda/Progress --filter=5/en/01-welcome
63f275
63f275

Once command-line arguments have been retrived, the

63f275
<tt>`centos-art.sh'</tt> script loads specific functions using the
63f275
<tt>`cli_getActions.sh'</tt> function script.  For example, if you run the
63f275
command centos-art render --entry, the <tt>`centos-art.sh'</tt>
63f275
script will look for <tt>`trunk/Scripts/Bash/Functions/Render'</tt>
63f275
directory and will load the render function from
63f275
<tt>`render.sh'</tt> function script; this, in order to achive the
63f275
rendering task as it defines.
63f275

63f275
63f275
+------------------------------------------------------------------+
63f275
| [centos@host]$ centos-art action 'path/to/dir' --option='value'  |
63f275
+------------------------------------------------------------------+
63f275
| ~/bin/centos-art --> ~/artwork/trunk/Scripts/Bash/centos-art.sh  |
63f275
+---v-----------------------------------------v--------------------+
63f275
    | centos-art.sh                           |
63f275
    +---v---------------------------------v---+
63f275
    .   | initFunctions.sh                |   .
63f275
    .   +---------------------------------+   .
63f275
    .   | cli $@                          |   .
63f275
    .   +---v-------------------------v---+   .
63f275
    .   .   | cli_getActions $@       |   .   .
63f275
    .   .   +---v-----------------v---+   .   .
63f275
    .   .   .   | function call 1 |   .   .   .
63f275
    .   .   .   | function call 2 |   .   .   .
63f275
    .   .   .   | function call n |   .   .   .
63f275
    .   .   .   +-----------------+   .   .   .
63f275
    .   .   ...........................   .   .
63f275
    .   ...................................   .
63f275
    ...........................................
63f275
63f275

Figure 3.8: The <tt>`centos-art.sh'</tt> initialization environment.

63f275
54b5a5

54b5a5
63f275
63f275

3.36.3 Usage

54b5a5
63f275

The <tt>`centos-art.sh'</tt> script usage information is described inside

63f275
each specific function documentation (see section trunk/Scripts/Bash/Functions).
63f275

5fb024
008ee0
5fb024

3.36.4 See also

5fb024
63f275
63f275
3.35 trunk/Scripts  
63f275
63f275
3.37 trunk/Scripts/Bash/Functions  
63f275
035049
3.47 trunk/Scripts/Bash/Locale  
63f275
63f275
4c79b5
4c79b5
4c79b5
008ee0
[ < ]
008ee0
[ > ]
4c79b5
   
4c79b5
[ << ]
008ee0
[ Up ]
035049
[ >> ]
4c79b5
4c79b5

4c79b5
 <font size="-1">
008ee0
  This document was generated on December, 2 2010 using texi2html 1.76.
4c79b5
 </font>
4c79b5
 
4c79b5
4c79b5

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