Blame Manuals/en/Html/Repository/repository_48.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
-->
684dc0
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>
035049
<title>CentOS Artwork Repository: 3.45 trunk/Scripts/Bash/Functions/Svg</title>
4c79b5
035049
<meta name="description" content="CentOS Artwork Repository: 3.45 trunk/Scripts/Bash/Functions/Svg">
035049
<meta name="keywords" content="CentOS Artwork Repository: 3.45 trunk/Scripts/Bash/Functions/Svg">
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
035049
[ < ]
035049
[ > ]
4c79b5
   
4c79b5
[ << ]
4c79b5
[ Up ]
035049
[ >> ]
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
[Top]
4c79b5
[Contents]
035049
[Index]
4c79b5
[ ? ]
4c79b5
035049
035049
035049

3.45 trunk/Scripts/Bash/Functions/Svg

2c8180
2c8180
035049
273af8

3.45.1 Goals

e68a7a
035049

This section exists to organize files related to svg

035049
functionality of <tt>`centos-art.sh'</tt> script.
54b5a5

e68a7a
035049
273af8

3.45.2 Description

60c152
035049

The svg functionality of <tt>`centos-art.sh'</tt> script helps you

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

684dc0
60c152
035049
035049

3.45.2.1 Metadata maintainance

60c152
035049

The metadata used is defined by Inkscape 0.46 using the SVG standard

035049
markup. The <tt>`centos-art.sh'</tt> script replaces everything
035049
in-between <metadata and </metadata> tags with a
035049
predefined metadata template we've set for this purpose.
54b5a5

035049

The metadata template was created using the metadata information of a

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

035049

With metadata template in place, the <tt>`centos-art.sh'</tt> script uses

035049
it to create a metadata template instance for the file being processed
035049
currently.  The metadata template instance contains the metadata
035049
portion of sed replacement commands with translation markers already
035049
traduced.  In this action, instance creation, is where we take
035049
advantage of automation and generate metadata values like title, date,
035049
keywords, source, identifier, and relation dynamically, based on the
035049
file path <tt>`centos-art.sh'</tt> script is currently creating metadata
035049
information for.
54b5a5

035049

With metadata template instance in place, the <tt>`centos-art.sh'</tt>

035049
script uses it to replace real values inside all <samp>`.svg'</samp> files
035049
under the current location you're running the <tt>`centos-art.sh'</tt>
035049
script on.  Default behaviour is to ask user to enter each metadatum
035049
required, one by one. If user leaves metadatum empty, by pressing
035049
RET key, <tt>`centos-art.sh'</tt> uses its default value.
54b5a5

035049

The <tt>`centos-art.sh'</tt> script modifies the following metadata:

54b5a5

035049
035049
<samp>`Title'</samp>
035049

Name by which this document is formally known. If no value is set

035049
here, <tt>`centos-art.sh'</tt> script uses the file name as title.
54b5a5

035049
035049
<samp>`Date'</samp>
035049

Date associated with the creation of this document (YYYY-MM-DD). If no

035049
value is set here, <tt>`centos-art.sh'</tt> script uses the current date
035049
information as in date +%Y-%m-%d.
54b5a5

035049
035049
<samp>`Creator'</samp>
035049

Name of entity primarily responsible for making the content of this

035049
document. If no value is set here, <tt>`centos-art.sh'</tt> script uses
035049
the string <samp>`The CentOS Project'</samp>.
54b5a5

035049
035049
<samp>`Rights'</samp>
035049

Name of entity with rights to the intellectual Property of this

035049
document. If no value is set here, <tt>`centos-art.sh'</tt> script uses
035049
the string <samp>`The CentOS Project'</samp>.
831389

035049
035049
<samp>`Publisher'</samp>
035049

Name of entity responsible for making this document available. If no

035049
value is set here, <tt>`centos-art.sh'</tt> script uses the string
035049
<samp>`The CentOS Project'</samp>.
831389

035049
035049
<samp>`Identifier'</samp>
035049

Unique URI to reference this document. If no value is set here,

035049
<tt>`centos-art.sh'</tt> script uses the current file path to build the
035049
related url that points to current file location inside repository
035049
central server.
831389

035049
035049
<samp>`Source'</samp>
035049

Unique URI to reference the source of this document. If no value is

035049
set here, <tt>`centos-art.sh'</tt> script uses current file path to build
035049
the related url that points to current file location inside repository
035049
central server.
273af8

273af8
035049
<samp>`Relation'</samp>
035049

Unique URI to a related document. If no value is set here,

035049
<tt>`centos-art.sh'</tt> script uses current file path to build the
035049
related url that points to current file location inside repository
035049
central server.
273af8

035049
035049
<samp>`Language'</samp>
035049

Two-letter language tag with optional subtags for the language of this

035049
document. (e.g. <samp>`en-GB'</samp>). If no value is set here,
035049
<tt>`centos-art.sh'</tt> script uses the current locale information as in
035049
cli_getCurrentLocale function.
273af8

035049
035049
<samp>`Keywords'</samp>
035049

The topic of this document as comma-separated key words, prhases, or

035049
classifications. If no value is set here, <tt>`centos-art.sh'</tt> script
035049
uses file path to build 
54b5a5

54b5a5
035049
<samp>`Coverage'</samp>
035049

Extent or scope of this document. If no value is set here,

035049
<tt>`centos-art.sh'</tt> script uses the string <samp>`The CentOS Project'</samp>.
54b5a5

54b5a5
035049
<samp>`Description'</samp>
035049

Description about the document. If no value is set here,

035049
<tt>`centos-art.sh'</tt> script uses uses empty value as default.
54b5a5

54b5a5
035049
<samp>`Contributors'</samp>
035049

People that contributes in the creation/maintainance of the document.

035049
If no value is set here, <tt>`centos-art.sh'</tt> script uses uses empty
035049
value as default.
63f275

54b5a5
54b5a5
035049

The <samp>`License'</samp> metadatum is not set as a choise, by now. It is

035049
fixed Creative Common Attribution Share-Alike 3.0 License. This is done in order to
035049
grant license consistency among all SVG files we manage inside CentOS
035049
Artwork Repository.
e37211

684dc0
035049
035049
035049

3.45.2.2 Unused definitions

035049
035049

As SVG files grow they may end up with unused definitions inside. For

035049
example, if you stop using a pattern or gradient, tags used to define
035049
them are considered unused definitions then. Inkscape 0.46 brings the
035049
<samp>`Vaccum Defs'</samp> feature to remove those unused definitions from SVG
035049
files. The <samp>`Vaccum Defs'</samp> feature is available both at graphical
035049
interface and command line interface.
273af8

035049

If you have one or two couple of files, removing unused SVG

035049
definitions using graphical interface may be enough to you.  In
035049
contrast, if you have houndred of files to maintain it is not a fun
035049
task to use the gui interface to remove unused SVG definitions editing
035049
those files one by one.
b0644c

035049

To remove unused SVG definitions from several SVG files, the

035049
<tt>`centos-art.sh'</tt> script uses Inkscape's command-line interface,
035049
specifically with the <samp>`--vaccum-defs'</samp> option.
b0644c

035049
035049
035049

3.45.3 Usage

035049
035049
035049
centos-art svg --update-metadata='path/to/dir'
035049
centos-art svg --update-metadata='path/to/dir' --filter='regex'
035049

Use these commands to update metadata information to <samp>`.svg'</samp> files

035049
under <samp>`path/to/dir'</samp> directory.
b0644c

e37211
035049
centos-art svg --vacuum-defs='path/to/dir'
035049
centos-art svg --vacuum-defs='path/to/dir' --filter='regex'
035049

Use these commands to remove unused definitions inside <samp>`.svg'</samp>

035049
files under <samp>`path/to/dir'</samp> directory. 
e37211

e37211
e68a7a
035049

When you provide <samp>`--filter='regex''</samp> argument, the list of files

035049
to process is reduced as specified in <samp>`regex'</samp> regular expression.
035049
Inside <tt>`centos-art.sh'</tt> script, the <samp>`regex'</samp> regular
035049
expression is used in combination with find command to look
035049
for files matching the regular expression path pattern.
035049

035049
Warning

Warning

In order for <samp>`regex'</samp> regular expression to match

035049
a file, the <samp>`regex'</samp> regular expresion must match the whole file
035049
path not just the file name. 
035049

035049
035049

For example, if you want to match all <tt>`summary.svg'</tt> files inside

035049
<tt>`path/to/dir'</tt>, use the .+/summary regular expression.
035049
Later, <tt>`centos-art.sh'</tt> script uses this value inside
035049
^$REGEX\.svg$ expression in order to build the final regular
035049
expression (i.e., ^.+/summary\.svg$) that is evaluated against
035049
available file paths inside the list of files to process.
035049

035049

Exceptionally, when you provide <samp>`--filter='regex''</samp> in the way

035049
that <samp>`regex'</samp>, appended to <samp>`path/to/dir/'</samp> (i.e.
035049
<samp>`path/to/dir/regex'</samp>), matches a regular file; the
035049
<tt>`centos-art.sh'</tt> script uses the file matching as only file in the
035049
list of files to process. 
035049

e37211
035049
300762

3.45.4 See also

4c79b5
2c8180
63f275
3.36 trunk/Scripts/Bash  
54b5a5
63f275
3.37 trunk/Scripts/Bash/Functions  
2c8180
2c8180
4c79b5
4c79b5
4c79b5
035049
[ < ]
035049
[ > ]
4c79b5
   
4c79b5
[ << ]
035049
[ Up ]
035049
[ >> ]
4c79b5
4c79b5

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

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