|
 |
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 |
-->
|
|
|
52772c |
|
|
|
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>
|
|
|
1075b9 |
<title>CentOS Artwork Repository: 2.16 The trunk/Identity/Models/Tpl/Promo/Web Directory</title>
|
|
|
ee1f37 |
|
|
|
1075b9 |
<meta name="description" content="CentOS Artwork Repository: 2.16 The trunk/Identity/Models/Tpl/Promo/Web Directory">
|
|
|
1075b9 |
<meta name="keywords" content="CentOS Artwork Repository: 2.16 The trunk/Identity/Models/Tpl/Promo/Web 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 |
|
|
|
1075b9 |
[ < ]
|
|
|
52772c |
[ > ]
|
|
|
ee1f37 |
|
|
|
1075b9 |
[ << ]
|
|
|
1075b9 |
[ Up ]
|
|
|
1075b9 |
[ >> ]
|
|
|
ee1f37 |
|
|
|
ee1f37 |
|
|
|
ee1f37 |
|
|
|
ee1f37 |
|
|
|
1075b9 |
[Top]
|
|
|
1075b9 |
[Contents]
|
|
|
1075b9 |
[Index]
|
|
|
1075b9 |
[ ? ]
|
|
|
ee1f37 |
|
|
|
1075b9 |
|
|
|
52772c |
|
|
|
52772c |
2.16 The <tt>`trunk/Identity/Models/Tpl/Promo/Web'</tt> Directory
|
|
|
ee1f37 |
|
|
|
ee1f37 |
|
|
|
52772c |
|
|
|
52772c |
2.16.1 Goals
|
|
|
ee1f37 |
|
|
|
52772c |
Organize scalable vector graphics (svg) to help describe the CentOS
|
|
|
52772c |
web environment.
|
|
|
06d106 |
|
|
|
ee1f37 |
|
|
|
52772c |
|
|
|
52772c |
2.16.2 The CentOS web environment
|
|
|
b9dbd3 |
|
|
|
52772c |
Inside CentOS corporate identity, the CentOS web environment is
|
|
|
52772c |
considered a promotion component. The CentOS web environment is formed
|
|
|
52772c |
by a central web application --to cover base needs (e.g., per-major
|
|
|
52772c |
release information like release notes, lifetime, downloads,
|
|
|
52772c |
documentation, support, security advisories, bugs, etc.)-- and many
|
|
|
52772c |
different free web applications --to cover specific needs (e.g.,
|
|
|
52772c |
wiki, mailing lists, etc.)--.
|
|
|
52772c |
|
|
|
52772c |
The CentOS web environment is addressed to solve the following issues:
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
One unique name and one unique visual style to all web
|
|
|
52772c |
applications used inside the web environment.
|
|
|
b9dbd3 |
|
|
|
52772c |
One-step navigation to web applications inside the environment.
|
|
|
671838 |
|
|
|
52772c |
High degree of customization to change the visual style of all
|
|
|
52772c |
web applications with few changes (e.g, updating just two or three
|
|
|
52772c |
images plus common style sheet [CSS] definitions).
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
The CentOS project is attached to a monolithic corporate visual
|
|
|
1075b9 |
identity (see section The <tt>`trunk/Identity'</tt> Directory), where all visual manifestations
|
|
|
52772c |
have one unique name and one unique visual style. This way, the CentOS
|
|
|
52772c |
web environment has one unique name (the CentOS brand) and one unique
|
|
|
52772c |
visual style (the CentOS default theme) for all its visual
|
|
|
52772c |
manifestations, the web applications in this case.
|
|
|
632e8b |
|
|
|
52772c |
Since a maintainance point of view, achiving the one unique visual
|
|
|
52772c |
style inside CentOS web environment is not a simple task. The CentOS
|
|
|
52772c |
web environment is built upon many different web applications which
|
|
|
52772c |
have different visual styles and different internal ways to customize
|
|
|
52772c |
their own visual styles. For example: MoinMoin, the web application
|
|
|
52772c |
used to support the CentOS wiki (http://wiki.centos.org/) is
|
|
|
52772c |
highly customizable but Mailman (in its 2.x.x serie), the web
|
|
|
52772c |
application used to support the CentOS mailing list, doesn't
|
|
|
1075b9 |
support(1) a customization system that separates
|
|
|
52772c |
presentation from logic, similar to that used by MoinMoin.
|
|
|
52772c |
|
|
|
52772c |
This visual style diversity complicates our goal of one unique visual
|
|
|
52772c |
style for all web applications. So, if we want one unique visual style
|
|
|
52772c |
for all web applications used, it is innevitable to modify the web
|
|
|
52772c |
applications in order to implement the CentOS one unique visual style
|
|
|
52772c |
customization in them. Direct modification of upstream applications is
|
|
|
52772c |
not convenient because upstream applications come with their one
|
|
|
52772c |
visual style and administrators take the risk of loosing all
|
|
|
52772c |
customization changes the next time the application be updated (since
|
|
|
52772c |
not all upstream web applications, used in CentOS web environment,
|
|
|
52772c |
separate presentation from logic).
|
|
|
52772c |
|
|
|
52772c |
To solve the "one unique visual style" issue, installation and
|
|
|
52772c |
actualization of web applications --used inside CentOS web
|
|
|
52772c |
environment-- need to be independent from upstream web applications
|
|
|
52772c |
development line; in a way that CentOS web environment administrators
|
|
|
52772c |
can install and update web applications freely without risk of loosing
|
|
|
52772c |
the one unique visual style customization changes.
|
|
|
52772c |
|
|
|
52772c |
At the surface of this issue we can see the need of one specific yum
|
|
|
52772c |
repository to store CentOS web environment customized web applications.
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
2.16.2.1 Design model (without ads)
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
2.16.2.2 Design model (with ads)
|
|
|
52772c |
|
|
|
06d106 |
|
|
|
52772c |
|
|
|
52772c |
2.16.2.3 HTML definitions
|
|
|
aaf678 |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
2.16.2.4 Controlling visual style
|
|
|
52772c |
|
|
|
52772c |
Inside CentOS web environment, the visual style is controlled by the
|
|
|
52772c |
following compenents:
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
Webenv header background
|
|
|
52772c |
trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Img/1024x250.png
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
CSS definitions
|
|
|
52772c |
trunk/Identity/Themes/Models/Default/Promo/Web/CSS/stylesheet.css
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
2.16.2.5 Producing visual style
|
|
|
52772c |
|
|
|
52772c |
The visual style of CentOS web environment is defined in the following
|
|
|
52772c |
files:
|
|
|
52772c |
|
|
|
52772c |
trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Xcf/1024x250.xcf
|
|
|
52772c |
trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Img/1024x250.png
|
|
|
52772c |
trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Img/1024x250-bg.png
|
|
|
52772c |
trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Tpl/1024x250.svg
|
|
|
52772c |
|
|
|
52772c |
As graphic designer you use <tt>`1024x250.xcf'</tt> file to produce
|
|
|
52772c |
<tt>`1024x250-bg.png'</tt> file. Later, inside <tt>`1024x250.svg'</tt> file,
|
|
|
52772c |
you use the <tt>`1024x250-bg.png'</tt> file as background layer to draw
|
|
|
52772c |
your vectorial design. When you consider you artwork ready, use the
|
|
|
52772c |
centos-art.sh script, as described below, to produce the
|
|
|
52772c |
visual style controller images of CentOS web environment.
|
|
|
52772c |
|
|
|
52772c |
centos-art render --entry=trunk/Identity/Themes/Motifs/$THEME/Backgrounds --filter='1024x250'
|
|
|
52772c |
|
|
|
52772c |
Once you have rendered required image files, changing the visual style
|
|
|
52772c |
of CentOS web environment is a matter of replacing old image files
|
|
|
52772c |
with new ones, inside webenv repository file system structure. The
|
|
|
52772c |
visual style changes will take effect the next time customization line
|
|
|
52772c |
of CentOS web applications be packaged, uploded, and installed from
|
|
|
52772c |
[webenv] or [webenv-test] repositories.
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
2.16.2.6 Navigation
|
|
|
52772c |
|
|
|
52772c |
Inside CentOS web environment, the one-step navegation between web
|
|
|
52772c |
applications is addressed using the web environment navigation bar.
|
|
|
52772c |
The web environment navigation bar contains links to main applications
|
|
|
52772c |
and is always visible no matter where you are inside the web
|
|
|
52772c |
environment.
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
2.16.2.7 Development and release cycle
|
|
|
52772c |
|
|
|
52772c |
The CentOS web environment development and relase cycle is described
|
|
|
52772c |
below:
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
Download
|
|
|
52772c |
|
|
|
52772c |
The first action is download the source code of web applications we
|
|
|
52772c |
want to use inside CentOS web environment.
|
|
|
52772c |
|
|
|
52772c |
 Important The source location from which web application are
|
|
|
52772c |
downloaded is very important. Use SRPMs from CentOS [base]
|
|
|
52772c |
and [updates] repositories as first choise, and third party
|
|
|
52772c |
repositories (e.g. RPMForge, EPEL, etc.) as last resource.
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
Prepare
|
|
|
52772c |
|
|
|
52772c |
Once web application source code has been downloaded, our duty is
|
|
|
52772c |
organize its files inside <samp>`webenv'</samp> version controlled repository.
|
|
|
52772c |
|
|
|
52772c |
When preparing the structure keep in mind that different web
|
|
|
52772c |
applications have different visual styles, and also different ways to
|
|
|
52772c |
implement it. A convenient way to organize the file system structure
|
|
|
52772c |
would be create one development line for each web application we use
|
|
|
52772c |
inside CentOS web environment. For example, consider the following
|
|
|
52772c |
file system structure:
|
|
|
52772c |
|
|
|
52772c |
https://projects.centos.org/svn/webenv/trunk/
|
|
|
52772c |
|-- WebApp1/
|
|
|
52772c |
| |-- Sources/
|
|
|
52772c |
| | `-- webapp1-0.0.1/
|
|
|
52772c |
| |-- Rpms/
|
|
|
52772c |
| | `-- webapp1-0.0.1.rpm
|
|
|
52772c |
| |-- Srpms/
|
|
|
52772c |
| | `-- webapp1-0.0.1.srpm
|
|
|
52772c |
| `-- Specs/
|
|
|
52772c |
| `-- webapp1-0.0.1.spec
|
|
|
52772c |
|-- WebApp2/
|
|
|
52772c |
`-- WebAppN/
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
Customize
|
|
|
52772c |
|
|
|
52772c |
Once web applications have been organized inside the version
|
|
|
52772c |
controlled repository file system, use subversion to create the CentOS
|
|
|
52772c |
customization development line of web applications source code. For
|
|
|
52772c |
example, using the above file system structure, you can create the
|
|
|
52772c |
customization development line of <tt>`webapp1-0.0.1/'</tt> with the
|
|
|
52772c |
following command:
|
|
|
52772c |
|
|
|
52772c |
svn cp trunk/WebApp1/Sources/webapp1-0.0.1 trunk/WebApp1/Sources/webapp1-0.0.1-webenv
|
|
|
52772c |
|
|
|
52772c |
The command above creates the following structure:
|
|
|
52772c |
|
|
|
52772c |
https://projects.centos.org/svn/webenv/trunk/
|
|
|
52772c |
|-- WebApp1/
|
|
|
52772c |
| |-- Sources/
|
|
|
52772c |
| | |-- webapp1-0.0.1/
|
|
|
52772c |
| | `-- webapp1-0.0.1-webenv/
|
|
|
52772c |
| |-- Rpms/
|
|
|
52772c |
| | `-- webapp1-0.0.1.rpm
|
|
|
52772c |
| |-- Srpms/
|
|
|
52772c |
| | `-- webapp1-0.0.1.srpm
|
|
|
52772c |
| `-- Specs/
|
|
|
52772c |
| `-- webapp1-0.0.1.spec
|
|
|
52772c |
|-- WebApp2/
|
|
|
52772c |
`-- WebAppN/
|
|
|
52772c |
|
|
|
52772c |
In the above structure, the <tt>`webapp1-0.0.1-webenv/'</tt> directory is
|
|
|
52772c |
the place where you customize the visual style of
|
|
|
52772c |
<tt>`webapp1-0.0.1/'</tt> web application.
|
|
|
52772c |
|
|
|
52772c |
 Tip Use the diff command of Subversion between
|
|
|
52772c |
CentOS customization and upstream development lines to know what you
|
|
|
52772c |
are changing exactly.
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
Build packages
|
|
|
52772c |
|
|
|
52772c |
When web application has been customized, build the web application
|
|
|
52772c |
RPM and SRPM using the source location with <samp>`-webenv'</samp> prefix.
|
|
|
52772c |
|
|
|
52772c |
https://projects.centos.org/svn/webenv/trunk/
|
|
|
52772c |
|-- WebApp1/
|
|
|
52772c |
| |-- Sources/
|
|
|
52772c |
| | |-- webapp1-0.0.1/
|
|
|
52772c |
| | `-- webapp1-0.0.1-webenv/
|
|
|
52772c |
| |-- Rpms/
|
|
|
52772c |
| | |-- webapp1-0.0.1.rpm
|
|
|
52772c |
| | `-- webapp1-0.0.1-webenv.rpm
|
|
|
52772c |
| |-- Srpms/
|
|
|
52772c |
| | |-- webapp1-0.0.1.srpm
|
|
|
52772c |
| | `-- webapp1-0.0.1-webenv.srpm
|
|
|
52772c |
| `-- Specs/
|
|
|
52772c |
| |-- webapp1-0.0.1.spec
|
|
|
52772c |
| `-- webapp1-0.0.1-webenv.spec
|
|
|
52772c |
|-- WebApp2/
|
|
|
52772c |
`-- WebAppN/
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
Release for testing
|
|
|
52772c |
|
|
|
52772c |
When the customized web application has been packaged, make packages
|
|
|
52772c |
available for testing and quality assurance. This can be achives using
|
|
|
52772c |
a [webenv-test] yum repository.
|
|
|
52772c |
|
|
|
52772c |
 Note The [webenv-test] repository is not shipped inside
|
|
|
52772c |
CentOS distribution default yum configuraiton. In order to use
|
|
|
52772c |
[webenv-test] repository you need to configure it first.
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
If some problem is found to install/update/use the customized version
|
|
|
52772c |
of web application, the problem is notified somewhere (a bugtracker
|
|
|
52772c |
maybe) and the customization face is repated in order to fix the
|
|
|
52772c |
problem. To release the new package add a number after <samp>`-webenv'</samp>
|
|
|
52772c |
prefix. For example, if some problem is found in
|
|
|
52772c |
<tt>`webapp1-0.0.1-webenv.rpm'</tt>, when it be fixed the new package will
|
|
|
52772c |
be named <tt>`webapp1-0.0.1-webenv-1.rpm'</tt>. If a problem is found in
|
|
|
52772c |
<tt>`webapp1-0.0.1-webenv-1.rpm'</tt>, when it be fixed the new package
|
|
|
52772c |
will be named <tt>`webapp1-0.0.1-webenv-2.rpm'</tt>, and so on.
|
|
|
52772c |
|
|
|
52772c |
The "customization -- release for testing" process is repeated
|
|
|
52772c |
until CentOS quality assurance team considers the package is ready for
|
|
|
52772c |
production.
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
Release for production
|
|
|
52772c |
|
|
|
52772c |
When customized web application packages are considered ready for
|
|
|
52772c |
production they are moved from [webenv-test] to [webenv] repository.
|
|
|
52772c |
This action is commited by CentOS quality assurance team.
|
|
|
52772c |
|
|
|
52772c |
Note The [webenv] repository is not shipped inside CentOS
|
|
|
52772c |
distribution default yum configuraiton. In order to use [webenv]
|
|
|
52772c |
repository you need to configure it first.
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
2.16.2.8 The [webenv-test] repository
|
|
|
52772c |
|
|
|
52772c |
/etc/yum.repos.d/CentOS-Webenv-test.repo
|
|
|
52772c |
|
|
|
52772c |
[webenv-test]
|
|
|
52772c |
name=CentOS-$releasever - Webenv-test
|
|
|
52772c |
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=webenv-test
|
|
|
52772c |
#baseurl=http://mirror.centos.org/centos/$releasever/webenv-test/$basearch/
|
|
|
52772c |
gpgcheck=1
|
|
|
52772c |
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-$releasever
|
|
|
52772c |
enabled=1
|
|
|
52772c |
priority=10
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
2.16.2.9 The [webenv] repository
|
|
|
52772c |
|
|
|
52772c |
/etc/yum.repos.d/CentOS-Webenv.repo
|
|
|
52772c |
|
|
|
52772c |
[webenv]
|
|
|
52772c |
name=CentOS-$releasever - Webenv
|
|
|
52772c |
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=webenv
|
|
|
52772c |
#baseurl=http://mirror.centos.org/centos/$releasever/webenv/$basearch/
|
|
|
52772c |
gpgcheck=1
|
|
|
52772c |
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-$releasever
|
|
|
52772c |
enabled=1
|
|
|
52772c |
priority=10
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
2.16.2.10 Priority configuration
|
|
|
52772c |
|
|
|
52772c |
Both [webenv] and [webenv-test] repositories update packages inside
|
|
|
52772c |
CentOS [base] and CentOS [updates] repositories.
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
2.16.3 Usage
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
...
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
|
|
|
52772c |
2.16.4 See also
|
|
|
ee1f37 |
|
|
|
06d106 |
|
|
|
1075b9 |
2.13 The <tt>`trunk/Identity/Models/Img/Promo/Web'</tt> Directory
|
|
|
06d106 |
|
|
|
06d106 |
|
|
|
ee1f37 |
|
|
|
ee1f37 |
|
|
|
ee1f37 |
|
|
|
52772c |
[ < ]
|
|
|
1075b9 |
[ > ]
|
|
|
ee1f37 |
|
|
|
1075b9 |
[ << ]
|
|
|
52772c |
[ Up ]
|
|
|
1075b9 |
[ >> ]
|
|
|
ee1f37 |
|
|
|
ee1f37 |
|
|
|
ee1f37 |
<font size="-1">
|
|
|
52772c |
This document was generated on March, 22 2011 using texi2html 1.76.
|
|
|
ee1f37 |
</font>
|
|
|
ee1f37 |
|
|
|
ee1f37 |
|
|
|
ee1f37 |
|
|
|
ee1f37 |
</body>
|
|
|
ee1f37 |
</html>
|