@subsection Goals

This section exists to organize files related to @code{svg}
functionality of @file{centos-art.sh} script.

@subsection Description

The @code{svg} functionality of @file{centos-art.sh} script helps you
to maintain scalable vector graphics (SVG) inside repository. For
example, suppose you've been working in CentOS default design models
under @file{trunk/Identity/Themes/Models/}, and you want to set common
metadata to all of them, and later remove all unused SVG defintions
from @samp{*.svg} files. Doing so file by file may be a tedious task,
so the @file{centos-art.sh} script provides the @code{svg}
functionality to aid you maintain such actions.

@cindex Metadata maintainance
@subsubsection Metadata maintainance

The metadata used is defined by Inkscape 0.46 using the SVG standard
markup. The @file{centos-art.sh} script replaces everything
in-between @code{<metadata} and @code{</metadata>} tags with a
predefined metadata template we've set for this purpose.

The metadata template was created using the metadata information of a
file which, using Inkscape 0.46, all metadata fields were set. This
created a complete markup representation of how SVG metadata would
look like. Later, we replaced every single static value with a
translation marker in the form @samp{=SOMETEXT=}, where
@code{SOMETEXT} is the name of its main opening tag. Later, we
transform the metadata template into a sed replacement set of commads
escaping new lines at the end of each line.

With metadata template in place, the @file{centos-art.sh} script uses
it to create a metadata template instance for the file being processed
currently.  The metadata template instance contains the metadata
portion of sed replacement commands with translation markers already
traduced.  In this action, instance creation, is where we take
advantage of automation and generate metadata values like title, date,
keywords, source, identifier, and relation dynamically, based on the
file path @file{centos-art.sh} script is currently creating metadata
information for.

With metadata template instance in place, the @file{centos-art.sh}
script uses it to replace real values inside all @samp{.svg} files
under the current location you're running the @file{centos-art.sh}
script on.  Default behaviour is to ask user to enter each metadatum
required, one by one. If user leaves metadatum empty, by pressing
@key{RET} key, @file{centos-art.sh} uses its default value.

The @file{centos-art.sh} script modifies the following metadata:

@table @samp
@item Title
Name by which this document is formally known. If no value is set
here, @file{centos-art.sh} script uses the file name as title.

@item Date
Date associated with the creation of this document (YYYY-MM-DD). If no
value is set here, @file{centos-art.sh} script uses the current date
information as in @command{date +%Y-%m-%d}.

@item Creator
Name of entity primarily responsible for making the content of this
document. If no value is set here, @file{centos-art.sh} script uses
the string @samp{The CentOS Project}.

@item Rights
Name of entity with rights to the intellectual Property of this
document. If no value is set here, @file{centos-art.sh} script uses
the string @samp{The CentOS Project}.

@item Publisher
Name of entity responsible for making this document available. If no
value is set here, @file{centos-art.sh} script uses the string
@samp{The CentOS Project}.

@item Identifier
Unique URI to reference this document. If no value is set here,
@file{centos-art.sh} script uses the current file path to build the
related url that points to current file location inside repository
central server.

@item Source
Unique URI to reference the source of this document. If no value is
set here, @file{centos-art.sh} script uses current file path to build
the related url that points to current file location inside repository
central server.

@item Relation
Unique URI to a related document. If no value is set here,
@file{centos-art.sh} script uses current file path to build the
related url that points to current file location inside repository
central server.

@item Language
Two-letter language tag with optional subtags for the language of this
document. (e.g. @samp{en-GB}). If no value is set here,
@file{centos-art.sh} script uses the current locale information as in
@code{cli_getCurrentLocale} function.

@item Keywords
The topic of this document as comma-separated key words, prhases, or
classifications. If no value is set here, @file{centos-art.sh} script
uses file path to build 

@item Coverage
Extent or scope of this document. If no value is set here,
@file{centos-art.sh} script uses the string @samp{The CentOS Project}.

@item Description
Description about the document. If no value is set here,
@file{centos-art.sh} script uses uses empty value as default.

@item Contributors
People that contributes in the creation/maintainance of the document.
If no value is set here, @file{centos-art.sh} script uses uses empty
value as default.
@end table

The @samp{License} metadatum is not set as a choise, by now. It is
fixed @url{http://creativecommons.org/licenses/by-sa/3.0/, Creative
Common Attribution Share-Alike 3.0 License}. This is done in order to
grant license consistency among all SVG files we manage inside CentOS
Artwork Repository.

@cindex Unused definitions
@subsubsection Unused definitions 

Many of the no-longer-used gradients, patterns, and markers (more
precisely, those which you edited manually) remain in the
corresponding palettes and can be reused for new objects. However if
you want to optimize your document, use the @samp{Vacuum Defs} command
in @samp{File} menu. It will remove any gradients, patterns, or
markers which are not used by anything in the document, making the
file smaller. 

If you have one or two couple of files, removing unused definitions
using the graphical interface may be enough to you.  In contrast, if
you have dozens or even houndreds of scalable vector graphics files to
maintain it is not a fun task to use the graphical interface to remove
unused definitions editing those files one by one.

To remove unused definitions from several scalable vector graphics
files, the @file{centos-art.sh} script uses Inkscape command-line
interface, specifically with the @option{--vaccum-defs} option.

@subsection Usage

@table @command
@item centos-art svg --update-metadata='path/to/dir'
@item centos-art svg --update-metadata='path/to/dir' --filter='regex'
Use these commands to update metadata information to @samp{.svg} files
under @samp{path/to/dir} directory.

@item centos-art svg --vacuum-defs='path/to/dir'
@item centos-art svg --vacuum-defs='path/to/dir' --filter='regex'
Use these commands to remove unused definitions inside @samp{.svg}
files under @samp{path/to/dir} directory. 
@end table

When you provide @option{--filter='regex'} argument, the list of files
to process is reduced as specified in @samp{regex} regular expression.
Inside @file{centos-art.sh} script, the @samp{regex} regular
expression is used in combination with @command{find} command to look
for files matching the regular expression path pattern.

@quotation
@strong{Warning} In order for @samp{regex} regular expression to match
a file, the @samp{regex} regular expresion must match the whole file
path not just the file name. 
@end quotation

For example, if you want to match all @file{summary.svg} files inside
@file{path/to/dir}, use the @code{.+/summary} regular expression.
Later, @file{centos-art.sh} script uses this value inside
@code{^$REGEX\.svg$} expression in order to build the final regular
expression (i.e., @code{^.+/summary\.svg$}) that is evaluated against
available file paths inside the list of files to process.

Exceptionally, when you provide @option{--filter='regex'} in the way
that @samp{regex}, appended to @samp{path/to/dir/} (i.e.
@samp{path/to/dir/regex}), matches a regular file; the
@file{centos-art.sh} script uses the file matching as only file in the
list of files to process. 

@subsection See also

@menu
* trunk Scripts Bash::
* trunk Scripts Bash Functions::
@end menu