Standardizing Configuration Tasks
prepare
Inside the centos-art.sh script, the
working copy configuration tasks are standardized through the
prepare functionality. The main goals of
this function are: to set environment variables, to
install/update required packages, to create symbolic links for
content reusing, to render images based on available design
models and artistic motifs, to render documentation manuals,
build language-specific files required for content
localization and anything else needed in order to make the
working copy of &TCAR; ready to be used.
Use the prepare functionality the first
time you download a working copy of &TCAR; or later, to be
sure your workstation has all the components it needs so you
can use the working copy of &TCAR; in all its extension.
Syntax
Assuming this is the very first time you run the
centos-art command, you'll find that there
isn't such a command in your workstation. This is correct
because you haven't created the symbolic link that makes it
available in your execution path, yet. In order to make the
centos-art command available in the
execution path of your workstation, you need to run the
centos-art.sh script using its absolute
path first:
~/artwork/trunk/Scripts/Bash/centos-art.sh
prepare
--quiet
--answer-yes
--set-environment
--see-environment
--packages
--locales
--links
--images
--manuals
--sync-changes
Later, once the centos-art command is
available in your execution path, there is no need for you to
use any absolute path again. From this time on, you can use
the centos-art command-line interface
directly, as the following example describes:
centos-art
prepare
--quiet
--answer-yes
--set-environment
--see-environment
--packages
--locales
--links
--images
--manuals
--sync-changes
Options
The centos-art prepare command accepts the
following options:
Supress all output messages except error messages. When this
option is passed, all confirmation requests are supressed and
a possitive answer is assumed for them, just as if the
option whould have been provided.
Assume yes to all confirmation requests.
This option verifies packeges required by automation scripts
and installs or updates them as required. When required
packages aren't installed or need to be updated, the
centos-art uses the sudo
and yum to perform either installations or
actualizations tasks. In both cases, it is required that you
configure the /etc/sudoers configuration
file first, as discribed in .
This option creates or updates the portable objects (PO) and
machine object (MO) used by gettext
to retrive translated strings related to
centos-art.sh script. This option calls
the locale functionality of centos-art.sh
with the option, as described in
.
This option maintains the file relation between your working
copy and configuration files inside your workstation through
symbolic links. When you provide this option, the
centos-art.sh script puts itself into your
system's execution path through its command line interface
centos-art and makes common brushes,
patterns, palettes and fonts inside the working copy,
available to applications like GIMP in order for you to make
use of them without loosing version control over them.
This option removes all common fonts, brushes, patterns, and
palettes currently installed in your home directory, in order
to create a fresh installation of them all again, using the
working copy as section.
This option initializes image files inside the working copy.
When you provide this option, the
centos-art.sh calls the
render functionality to create images
related to each design model available in your working copy,
as described in .
This option initializes documentation files inside the working
copy. When you provide this option, the
centos-art.sh script calls both the
render and help
functionality to produce DocBook and Texinfo manuals,
respectively.
Print the name and value of some of the environment variables
used by centos-art.sh script as described
in .
Set default environment values to your personal profile
(~/.bash_profile).
Description
When no option is provided to prepare
functionality, the centos-art.sh script
uses the ,
,
, and
options, in that order, as default
behaviour. Otherwise, if you provide any option, the
centos-art.sh script avoids its default
behaviour and executes the prepare
functionality as specified by the options you provided.
Notice that it is possible for you to execute the
prepare functionality as many times as
you need to. This is specially useful when you need to keep
syncronized the relation between content produced inside your
working copy and the applications you use outside it. For
example, considering you've added new brushes to or removed
old brushes from your working copy of &TCAR;, the link
information related to those files need to be updated in the
~/.gimp-2.2/brushes
directory too, in a way the addition/deletion change that took
place in your working copy can be reflected there, as well.
The same is true for other similar components like fonts,
patterns and palettes.
Bugs
To report bugs related to this function, please create a new
ticket at refering the
name of this function clearly and the specific problems you
found in it.
Authors
The following people have worked in the
prepare functionality:
Alain Reguera Delgado <alain.reguera@gmail.com>, =COPYRIGHT_YEAR_LIST=
License
Copyright © =COPYRIGHT_YEAR_LIST= The CentOS Project
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
USA.