Blame Manual/repository-html/repository_65.html

ee1f37
ee1f37
<html>
d1db00
d1db00
organization, and administration of CentOS Artwork Repository.
d1db00
d1db00
Copyright C 2009-2011 Alain Reguera Delgado
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>
671838
<title>CentOS Artwork Repository: 2.61 The trunk/Scripts/Bash/Cli/Functions/Svg Directory</title>
ee1f37
671838
<meta name="description" content="CentOS Artwork Repository: 2.61 The trunk/Scripts/Bash/Cli/Functions/Svg Directory">
671838
<meta name="keywords" content="CentOS Artwork Repository: 2.61 The trunk/Scripts/Bash/Cli/Functions/Svg Directory">
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
671838
[ < ]
671838
[ > ]
ee1f37
   
671838
[ << ]
671838
[ Up ]
671838
[ >> ]
ee1f37
   
ee1f37
   
ee1f37
   
ee1f37
   
56a476
[Top]
56a476
[Contents]
671838
[Index]
56a476
[ ? ]
ee1f37
671838
671838
671838

2.61 The <tt>`trunk/Scripts/Bash/Cli/Functions/Svg'</tt> Directory

b130a0
b9dbd3
671838
671838

2.61.1 Goals

b9dbd3
671838

This section exists to organize files related to svg

063806
functionality of <tt>`centos-art.sh'</tt> script.
063806

063806
671838
671838

2.61.2 Description

b9dbd3
671838

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

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

671838
671838
671838
671838

2.61.2.1 Metadata maintainance

671838
671838

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

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

671838

The metadata template was created using the metadata information of a

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

671838

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

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

671838

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

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

671838

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

671838

671838
671838
<samp>`Title'</samp>
671838

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

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

671838
671838
<samp>`Date'</samp>
671838

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

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

671838
671838
<samp>`Creator'</samp>
671838

Name of entity primarily responsible for making the content of this

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

671838
671838
<samp>`Rights'</samp>
671838

Name of entity with rights to the intellectual Property of this

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

671838
671838
<samp>`Publisher'</samp>
671838

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

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

671838
671838
<samp>`Identifier'</samp>
671838

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

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

671838
671838
<samp>`Source'</samp>
671838

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

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

671838
671838
<samp>`Relation'</samp>
671838

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

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

671838
671838
<samp>`Language'</samp>
671838

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

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

671838
671838
<samp>`Keywords'</samp>
671838

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

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

671838
671838
<samp>`Coverage'</samp>
671838

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

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

671838
671838
<samp>`Description'</samp>
671838

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

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

671838
671838
<samp>`Contributors'</samp>
671838

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

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

671838
b9dbd3
671838

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

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

671838
671838
671838
671838

2.61.2.2 Unused definitions

b9dbd3
671838

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

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

671838

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

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

671838

To remove unused definitions from several scalable vector graphics

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

b9dbd3
671838
671838

2.61.3 Usage

b9dbd3
063806
671838
centos-art svg --update-metadata='path/to/dir'
671838
centos-art svg --update-metadata='path/to/dir' --filter='regex'
671838

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

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

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

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

671838
files under <samp>`path/to/dir'</samp> directory. 
063806

063806
b130a0
063806

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

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

063806
Warning

Warning

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

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

b130a0
671838

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

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

063806

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

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

b130a0
671838
671838

2.61.4 See also

982d5c
063806
671838
2.50 The <tt>`trunk/Scripts/Bash'</tt> Directory  
063806
063806
ee1f37
ee1f37
ee1f37
671838
[ < ]
671838
[ > ]
ee1f37
   
671838
[ << ]
671838
[ Up ]
671838
[ >> ]
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>