Blame Manuals/Repository/repository-html/repository_60.html

4c79b5
4c79b5
<html>
ccb7a3
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
-->
acd47b
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>
c2a1bc
<title>CentOS Artwork Repository: 3.57 trunk/Scripts/Bash/Functions/Svg</title>
4c79b5
c2a1bc
<meta name="description" content="CentOS Artwork Repository: 3.57 trunk/Scripts/Bash/Functions/Svg">
c2a1bc
<meta name="keywords" content="CentOS Artwork Repository: 3.57 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
300762
2dc146
[ < ]
2dc146
[ > ]
4c79b5
   
4c79b5
[ << ]
38bcd9
[ Up ]
c2a1bc
[ >> ]
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
[Top]
4c79b5
[Contents]
c2a1bc
[Index]
4c79b5
[ ? ]
4c79b5
c2a1bc
2dc146
c2a1bc

3.57 trunk/Scripts/Bash/Functions/Svg

4a9d2a
4a9d2a
2dc146
4a9d2a

3.57.1 Goals

4a9d2a
c2a1bc

This section exists to organize files related to svg

2dc146
functionality of <tt>`centos-art.sh'</tt> script.
4a9d2a

4a9d2a
2dc146
4a9d2a

3.57.2 Description

4a9d2a
c2a1bc

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

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

c2a1bc
c2a1bc
c2a1bc
c2a1bc

3.57.2.1 Metadata maintainance

c2a1bc
c2a1bc

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

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

c2a1bc

The metadata template was created using the metadata information of a

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

c2a1bc

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

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

c2a1bc

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

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

c2a1bc

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

c2a1bc

c2a1bc
c2a1bc
<samp>`Title'</samp>
c2a1bc

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

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

c2a1bc
c2a1bc
<samp>`Date'</samp>
c2a1bc

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

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

c2a1bc
c2a1bc
<samp>`Creator'</samp>
c2a1bc

Name of entity primarily responsible for making the content of this

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

c2a1bc
c2a1bc
<samp>`Rights'</samp>
c2a1bc

Name of entity with rights to the intellectual Property of this

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

c2a1bc
c2a1bc
<samp>`Publisher'</samp>
c2a1bc

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

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

c2a1bc
c2a1bc
<samp>`Identifier'</samp>
c2a1bc

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

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

c2a1bc
c2a1bc
<samp>`Source'</samp>
c2a1bc

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

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

c2a1bc
c2a1bc
<samp>`Relation'</samp>
c2a1bc

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

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

c2a1bc
c2a1bc
<samp>`Language'</samp>
c2a1bc

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

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

c2a1bc
c2a1bc
<samp>`Keywords'</samp>
c2a1bc

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

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

c2a1bc
c2a1bc
<samp>`Coverage'</samp>
c2a1bc

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

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

c2a1bc
c2a1bc
<samp>`Description'</samp>
c2a1bc

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

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

c2a1bc
c2a1bc
<samp>`Contributors'</samp>
c2a1bc

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

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

c2a1bc
2c8180
c2a1bc

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

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

c2a1bc
2dc146
c2a1bc
c2a1bc

3.57.2.2 Unused definitions

2dc146
c2a1bc

Many of the no-longer-used gradients, patterns, and markers (more

c2a1bc
precisely, those which you edited manually) remain in the
c2a1bc
corresponding palettes and can be reused for new objects. However if
c2a1bc
you want to optimize your document, use the <samp>`Vacuum Defs'</samp> command
c2a1bc
in <samp>`File'</samp> menu. It will remove any gradients, patterns, or
c2a1bc
markers which are not used by anything in the document, making the
c2a1bc
file smaller. 
c2a1bc

c2a1bc

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

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

c2a1bc

To remove unused definitions from several scalable vector graphics

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

c2a1bc
c2a1bc
008ee0

3.57.3 Usage

008ee0
4a9d2a
c2a1bc
centos-art svg --update-metadata='path/to/dir'
c2a1bc
centos-art svg --update-metadata='path/to/dir' --filter='regex'
c2a1bc

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

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

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

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

c2a1bc
files under <samp>`path/to/dir'</samp> directory. 
2dc146

4a9d2a
4a9d2a
2dc146

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

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

2dc146
Warning

Warning

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

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

2dc146
c2a1bc

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

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

2dc146

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

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

008ee0
c2a1bc
38bcd9

3.57.4 See also

38bcd9
4a9d2a
c2a1bc
3.48 trunk/Scripts/Bash  
4a9d2a
c2a1bc
3.49 trunk/Scripts/Bash/Functions  
4a9d2a
4a9d2a
008ee0
6aec21
300762
c2a1bc
[ < ]
c2a1bc
[ > ]
300762
   
300762
[ << ]
2dc146
[ Up ]
c2a1bc
[ >> ]
300762
4c79b5

4c79b5
 <font size="-1">
acd47b
  This document was generated on February, 26 2011 using texi2html 1.76.
4c79b5
 </font>
4c79b5
 
4c79b5
4c79b5

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