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

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
-->
4c79b5
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>
4c79b5
<title>CentOS Artwork Repository: 3.27 trunk/Scripts/Bash</title>
4c79b5
4c79b5
<meta name="description" content="CentOS Artwork Repository: 3.27 trunk/Scripts/Bash">
4c79b5
<meta name="keywords" content="CentOS Artwork Repository: 3.27 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
4c79b5
@import "/home/centos/artwork/trunk/Identity/Themes/Motifs/Modern/Web/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
4c79b5
[ < ]
4c79b5
[ > ]
4c79b5
   
4c79b5
[ << ]
4c79b5
[ Up ]
4c79b5
[ >> ]
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
[Top]
4c79b5
[Contents]
4c79b5
[Index]
4c79b5
[ ? ]
4c79b5
4c79b5
4c79b5
4c79b5

3.27 trunk/Scripts/Bash

4c79b5
4c79b5
4c79b5
4c79b5

3.27.1 Goals

4c79b5
4c79b5

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

4c79b5
"trunk" development line of centos-art.sh automation
4c79b5
script.  The centos-art.sh script standardize frequent tasks
4c79b5
inside your working copy of CentOS Artwork Repository.
4c79b5

4c79b5
4c79b5
4c79b5

3.27.2 Description

4c79b5
4c79b5

The best way to understand centos-art.sh automation script

4c79b5
is studying its source code. The centos-art.sh script is
4c79b5
splited in several configuration and function files which are loaded
4c79b5
when the centos-art.sh script is executed. This section
4c79b5
describes the order in which centos-art.sh loads its
4c79b5
configuration and function files.
4c79b5

4c79b5

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

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

4c79b5

When centos-art.sh script is executed, the first it does is

4c79b5
execute the <tt>`trunk/Scripts/Bash/initFunctions.sh'</tt> file to
4c79b5
initialize gettext variables and all function scripts inside
4c79b5
<tt>`trunk/Scripts/Bash/Functions'</tt> directory. 
4c79b5

4c79b5

Once gettext variables and all function scripts have been

4c79b5
initialized, the centos-art.sh script initializes its
4c79b5
environment variables using the cli_getVariables function.
4c79b5
At this point the centos-art.sh script calls the
4c79b5
cli_getActions function from cli_getVariables
4c79b5
function's bottom. 
4c79b5

4c79b5

The cli_getActions function defines which actions the

4c79b5
centos-art.sh script is able to perform. Inside
4c79b5
cli_getActions function, actions are defined combining
4c79b5
positional arguments and function calls.
4c79b5

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

Figure 3.1: The centos-art.sh initialization environment.

4c79b5
4c79b5

4c79b5
4c79b5
4c79b5

3.27.2.1 The identity matching list

4c79b5
4c79b5

The identity matching list is used by identity rendering functions to

4c79b5
define the relation between translation files and identity design
4c79b5
templates. See section trunk/Scripts/Bash/Functions/Config/cli_getIdentityMatchinglist.sh, for more information.
4c79b5

4c79b5
4c79b5
4c79b5

3.27.2.2 Adding new features

4c79b5
4c79b5

To add new features inside centos-art.sh script, you need to

4c79b5
set positional arguments and function calls inside
4c79b5
cli_getActions function for the new function or functions
4c79b5
required by the new feature you want to add.
4c79b5

4c79b5
4c79b5
4c79b5

3.27.3 Usage

4c79b5
4c79b5
4c79b5
4c79b5

3.27.3.1 The centos-art <samp>`check'</samp> action

4c79b5
4c79b5

This feature is supported through the following command:

4c79b5

4c79b5
4c79b5
<samp>`centos-art check'</samp>
4c79b5

This command verifies paths, symbolic links, installed packages and

4c79b5
everything your workstation needs in order to run the
4c79b5
centos-art command correctly. 
4c79b5

4c79b5
Warning

Warning

If this is the first time you run

4c79b5
centos-art command, the appropriate way to execute check
4c79b5
action is not using the centos-art command, but the absolute
4c79b5
path to centos-art.sh script instead:
4c79b5

~/artwork/trunk/Scripts/Bash/centos-art.sh check
4c79b5
4c79b5
4c79b5
4c79b5
4c79b5
4c79b5
4c79b5

3.27.3.2 The centos-art <samp>`search'</samp> action

4c79b5
4c79b5

This feature is not supported yet.

4c79b5

4c79b5
4c79b5
<samp>`centos-art search 'pattern''</samp>
4c79b5
4c79b5

Use this command to find directories and files that match exactly the

4c79b5
posix-regular expression set in <samp>`pattern'</samp> as in <samp>`^pattern$'</samp>.
4c79b5

4c79b5
4c79b5
<samp>`centos-art search 'pattern1 pattern2 patternN''</samp>
4c79b5
4c79b5

Use this command to search repository entries that match pattern1

4c79b5
or patter2 or patternN as in
4c79b5
<samp>`'^.*(pattern1|pattern2|patternN).*$''</samp>.
4c79b5

4c79b5
4c79b5
<samp>`centos-art search 'path/to/dir1 path/to/dir2 path/to/dirN''</samp>
4c79b5
4c79b5

Use this command to search repository entries that match

4c79b5
<samp>`path/to/dir1'</samp> or <samp>`path/to/dir2'</samp>, or
4c79b5
<samp>`path/to/dirN'</samp> as in
4c79b5
<samp>`^.*(path/to/dir1|path/to/dir2|path/to/dirN).*$''</samp>.
4c79b5

4c79b5
4c79b5
4c79b5
4c79b5
4c79b5
4c79b5

3.27.3.3 The centos-art <samp>`path'</samp> action

4c79b5
4c79b5

This feature is not supported yet.

4c79b5

4c79b5
4c79b5
<samp>`centos-art path 'path/to/dir/' --copy-to='path/to/dir''</samp>
4c79b5
<samp>`centos-art path 'path/to/dir/' --copy-to='path/to/dir/filename''</samp>
4c79b5
<samp>`centos-art path 'path/to/dir/' --move-to='path/to/dir''</samp>
4c79b5
<samp>`centos-art path 'path/to/dir/' --move-to='path/to/dir/filename''</samp>
4c79b5
<samp>`centos-art path 'path/to/dir/' --remove'</samp>
4c79b5
4c79b5
4c79b5
4c79b5
4c79b5

3.27.3.4 The centos-art <samp>`locale-art'</samp> action

4c79b5
4c79b5

This feature is not supported yet.

4c79b5

4c79b5
4c79b5
<samp>`centos-art locale-art 'path/to/dir' --edit'</samp>
4c79b5
<samp>`centos-art locale-art 'path/to/dir' --edit='filename''</samp>
4c79b5
<samp>`centos-art locale-art 'path/to/dir' --list'</samp>
4c79b5
<samp>`centos-art locale-art 'path/to/dir' --list='filename''</samp>
4c79b5
4c79b5
4c79b5
4c79b5
4c79b5

3.27.3.5 The centos-art <samp>`license'</samp> action

4c79b5
4c79b5

This feature is supported through the following command:

4c79b5

4c79b5
4c79b5
<samp>`centos-art license'</samp>
4c79b5

Use this command to see a brief description of centos-art

4c79b5
command its copyright and its license notes.
4c79b5

4c79b5
4c79b5
4c79b5
4c79b5
4c79b5

3.27.4 See also

4c79b5
4c79b5
4c79b5
3.28 trunk/Scripts/Bash/Config  
4c79b5
4c79b5
3.31 trunk/Scripts/Bash/Functions  
4c79b5
4c79b5
3.38 trunk/Scripts/Bash/Locale  
4c79b5
4c79b5
3.26 trunk/Scripts  
4c79b5
4c79b5
4c79b5
4c79b5
4c79b5
4c79b5
[ < ]
4c79b5
[ > ]
4c79b5
   
4c79b5
[ << ]
4c79b5
[ Up ]
4c79b5
[ >> ]
4c79b5
4c79b5

4c79b5
 <font size="-1">
4c79b5
  This document was generated on September, 18 2010 using texi2html 1.76.
4c79b5
 </font>
4c79b5
 
4c79b5
4c79b5

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