Blame Manual/repository-html/repository_62.html

ee1f37
ee1f37
<html>
ee1f37
ee1f37
ee1f37
Permission is granted to copy, distribute and/or modify this document
ee1f37
under the terms of the GNU Free Documentation License, Version 1.2 or
ee1f37
any later version published by the Free Software Foundation; with no
ee1f37
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
ee1f37
copy of the license is included in the section entitled GNU Free
ee1f37
Documentation License.  
ee1f37
-->
406f69
ee1f37
ee1f37
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
ee1f37
            Karl Berry  <karl@freefriends.org>
ee1f37
            Olaf Bachmann <obachman@mathematik.uni-kl.de>
ee1f37
            and many others.
ee1f37
Maintained by: Many creative people <dev@texi2html.cvshome.org>
ee1f37
Send bugs and suggestions to <users@texi2html.cvshome.org>
ee1f37
ee1f37
-->
ee1f37
<head>
5cb5a7
<title>CentOS Artwork Repository: 2.60 Filesystem/trunk/Scripts/Bash/Cli/Functions/Svg</title>
ee1f37
5cb5a7
<meta name="description" content="CentOS Artwork Repository: 2.60 Filesystem/trunk/Scripts/Bash/Cli/Functions/Svg">
5cb5a7
<meta name="keywords" content="CentOS Artwork Repository: 2.60 Filesystem/trunk/Scripts/Bash/Cli/Functions/Svg">
ee1f37
<meta name="resource-type" content="document">
ee1f37
<meta name="distribution" content="global">
ee1f37
<meta name="Generator" content="texi2html 1.76">
ee1f37
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
ee1f37
<style type="text/css">
ee1f37
ee1f37
@import "/home/centos/artwork/trunk/Identity/Models/Css/Texi2html/common.css";
ee1f37
ee1f37
a.summary-letter {text-decoration: none}
ee1f37
pre.display {font-family: serif}
ee1f37
pre.format {font-family: serif}
ee1f37
pre.menu-comment {font-family: serif}
ee1f37
pre.menu-preformatted {font-family: serif}
ee1f37
pre.smalldisplay {font-family: serif; font-size: smaller}
ee1f37
pre.smallexample {font-size: smaller}
ee1f37
pre.smallformat {font-family: serif; font-size: smaller}
ee1f37
pre.smalllisp {font-size: smaller}
ee1f37
span.sansserif {font-family:sans-serif; font-weight:normal;}
ee1f37
ul.toc {list-style: none}
ee1f37
-->
ee1f37
</style>
ee1f37
ee1f37
ee1f37
</head>
ee1f37
ee1f37
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
ee1f37
ee1f37
982d5c
[ < ]
982d5c
[ > ]
ee1f37
   
982d5c
[ << ]
982d5c
[ Up ]
5cb5a7
[ >> ]
ee1f37
   
ee1f37
   
ee1f37
   
ee1f37
   
56a476
[Top]
56a476
[Contents]
5cb5a7
[Index]
56a476
[ ? ]
ee1f37
982d5c
982d5c
5cb5a7

2.60 Filesystem/trunk/Scripts/Bash/Cli/Functions/Svg

ee1f37
010b2d
982d5c
982d5c

2.60.1 Goals

010b2d
982d5c

This section exists to organize files related to svg

982d5c
functionality of <tt>`centos-art.sh'</tt> script.
010b2d

010b2d
982d5c
982d5c

2.60.2 Description

010b2d
982d5c

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

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

982d5c
010b2d
982d5c
982d5c

2.60.2.1 Metadata maintainance

010b2d
982d5c

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

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

982d5c

The metadata template was created using the metadata information of a

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

982d5c

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

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

982d5c

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

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

982d5c

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

010b2d

010b2d
982d5c
<samp>`Title'</samp>
982d5c

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

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

982d5c
982d5c
<samp>`Date'</samp>
982d5c

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

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

010b2d
982d5c
<samp>`Creator'</samp>
982d5c

Name of entity primarily responsible for making the content of this

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

010b2d
982d5c
<samp>`Rights'</samp>
982d5c

Name of entity with rights to the intellectual Property of this

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

010b2d
982d5c
<samp>`Publisher'</samp>
982d5c

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

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

982d5c
982d5c
<samp>`Identifier'</samp>
982d5c

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

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

982d5c
982d5c
<samp>`Source'</samp>
982d5c

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

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

010b2d
982d5c
<samp>`Relation'</samp>
982d5c

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

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

982d5c
982d5c
<samp>`Language'</samp>
982d5c

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

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

982d5c
982d5c
<samp>`Keywords'</samp>
982d5c

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

982d5c
classifications. If no value is set here, <tt>`centos-art.sh'</tt> script
982d5c
uses file path to build 
010b2d

982d5c
982d5c
<samp>`Coverage'</samp>
982d5c

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

982d5c
<tt>`centos-art.sh'</tt> script uses the string <samp>`The CentOS Project'</samp>.
010b2d

982d5c
982d5c
<samp>`Description'</samp>
982d5c

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

982d5c
<tt>`centos-art.sh'</tt> script uses uses empty value as default.
010b2d

010b2d
982d5c
<samp>`Contributors'</samp>
982d5c

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

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

010b2d
ee1f37
982d5c

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

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

982d5c
ee1f37
982d5c
982d5c

2.60.2.2 Unused definitions

ee1f37
982d5c

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

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

982d5c

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

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

982d5c

To remove unused definitions from several scalable vector graphics

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

982d5c
982d5c
982d5c

2.60.3 Usage

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

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

982d5c
under <samp>`path/to/dir'</samp> directory.
010b2d

010b2d
982d5c
centos-art svg --vacuum-defs='path/to/dir'
982d5c
centos-art svg --vacuum-defs='path/to/dir' --filter='regex'
982d5c

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

982d5c
files under <samp>`path/to/dir'</samp> directory. 
982d5c

010b2d
010b2d
982d5c

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

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

982d5c
Warning

Warning

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

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

982d5c
982d5c

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

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

982d5c

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

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

ee1f37
982d5c
982d5c

2.60.4 See also

ee1f37
010b2d
5cb5a7
2.49 Filesystem/trunk/Scripts/Bash  
010b2d
010b2d
ee1f37
ee1f37
ee1f37
982d5c
[ < ]
982d5c
[ > ]
ee1f37
   
982d5c
[ << ]
982d5c
[ Up ]
5cb5a7
[ >> ]
ee1f37
ee1f37

ee1f37
 <font size="-1">
406f69
  This document was generated on March, 1 2011 using texi2html 1.76.
ee1f37
 </font>
ee1f37
 
ee1f37
ee1f37

ee1f37
</body>
ee1f37
</html>