Blame Manuals/en/Html/Repository/repository_14.html

4c79b5
4c79b5
<html>
6414c4
09d4f2
6414c4
Copyright C 2009, 2010, 2011  Alain Reguera Delgado
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
-->
92fb7f
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>
6414c4
<title>The CentOS Artwork Repository: 3.11 trunk/Identity/Models/Tpl/Promo/Web</title>
4c79b5
6414c4
<meta name="description" content="The CentOS Artwork Repository: 3.11 trunk/Identity/Models/Tpl/Promo/Web">
6414c4
<meta name="keywords" content="The CentOS Artwork Repository: 3.11 trunk/Identity/Models/Tpl/Promo/Web">
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
5fb024
[ < ]
5fb024
[ > ]
4c79b5
   
4c79b5
[ << ]
4c79b5
[ Up ]
c489c0
[ >> ]
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
[Top]
4c79b5
[Contents]
c489c0
[Index]
4c79b5
[ ? ]
4c79b5
5fb024
5fb024
5fb024

3.11 trunk/Identity/Models/Tpl/Promo/Web

4c79b5
4c79b5
5fb024
4c79b5

3.11.1 Goals

4c79b5
5fb024

Organize scalable vector graphics (svg) to help describe the CentOS

5fb024
web environment.
5fb024

5fb024
5fb024
5fb024

3.11.2 The CentOS web environment

5fb024
5fb024

Inside CentOS corporate identity, the CentOS web environment is

5fb024
considered a promotion component. The CentOS web environment is formed
5fb024
by a central web application --to cover base needs (e.g., per-major
5fb024
release information like release notes, lifetime, downloads,
5fb024
documentation, support, security advisories, bugs, etc.)-- and many
5fb024
different free web applications --to cover specific needs (e.g.,
5fb024
wiki, mailing lists, etc.)--. 
5fb024

5fb024

The CentOS web environment is addressed to solve the following issues:

5fb024

bc3531
    5fb024
  • One unique name and one unique visual style to all web
  • 5fb024
    applications used inside the web environment.
    5fb024
    5fb024
  • One-step navigation to web applications inside the environment.
  • 5fb024
    5fb024
  • High degree of customization to change the visual style of all
  • 5fb024
    web applications with few changes (e.g, updating just two or three
    5fb024
    images plus common style sheet [CSS] definitions).
    bc3531
    bc3531
    5fb024

    The CentOS project is attached to a monolithic corporate visual

    5fb024
    identity (see section trunk/Identity), where all visual manifestations
    5fb024
    have one unique name and one unique visual style. This way, the CentOS
    5fb024
    web environment has one unique name (the CentOS brand) and one unique
    5fb024
    visual style (the CentOS default theme) for all its visual
    5fb024
    manifestations, the web applications in this case.
    5fb024

    5fb024

    Since a maintainance point of view, achiving the one unique visual

    5fb024
    style inside CentOS web environment is not a simple task. The CentOS
    5fb024
    web environment is built upon many different web applications which
    5fb024
    have different visual styles and different internal ways to customize
    5fb024
    their own visual styles. For example: MoinMoin, the web application
    09d4f2
    used to support the CentOS wiki (http://wiki.centos.org/) is
    5fb024
    highly customizable but Mailman (in its 2.x.x serie), the web
    5fb024
    application used to support the CentOS mailing list, doesn't
    5fb024
    support(1) a customization system that separates
    5fb024
    presentation from logic, similar to MoinMoin's one.
    5fb024

    5fb024

    This visual style diversity complicates our goal of one unique visual

    5fb024
    style for all web applications. So, if we want one unique visual style
    5fb024
    for all web applications used, it is innevitable to modify the web
    5fb024
    applications in order to implement the CentOS one unique visual style
    5fb024
    customization in them. Direct modification of upstream applications is
    5fb024
    not convenient because upstream applications come with their one
    5fb024
    visual style and administrators take the risk of loosing all
    5fb024
    customization changes the next time the application be updated (since
    5fb024
    not all upstream web applications, used in CentOS web environment,
    5fb024
    separate presentation from logic).
    5fb024

    5fb024

    To solve the "one unique visual style" issue, installation and

    5fb024
    actualization of web applications --used inside CentOS web
    5fb024
    environment-- need to be independent from upstream web applications
    5fb024
    development line; in a way that CentOS web environment administrators
    5fb024
    can install and update web applications freely without risk of loosing
    5fb024
    the one unique visual style customization changes. 
    5fb024

    5fb024

    At the surface of this issue we can see the need of one specific yum

    5fb024
    repository to store CentOS web environment customized web applications.
    5fb024

    4c79b5
    5fb024
    5fb024

    3.11.2.1 Design model (without ads)

    5fb024
    5fb024
    5eb4a2

    The CentOS web customization design model

    4c79b5
    0151ba

    Figure 3.1: The CentOS web customization design model.

    5fb024
    bc3531

    5fb024
    5fb024
    5fb024

    3.11.2.2 Design model (with ads)

    5fb024
    5fb024
    5eb4a2

    The CentOS web customization design model using promotion

    5fb024
    0151ba

    Figure 3.2: The CentOS web customization using promotion design model.

    5fb024
    5fb024

    5fb024
    5fb024
    5fb024

    3.11.2.3 HTML definitions

    5fb024
    5fb024
    5eb4a2

    Web environment html defintions

    5fb024
    0151ba

    Figure 3.3: Web environment html definitions

    5fb024
    5fb024

    5fb024
    5fb024
    5fb024

    3.11.2.4 Controlling visual style

    5fb024
    5fb024

    Inside CentOS web environment, the visual style is controlled by the

    5fb024
    following compenents:
    5fb024

    5fb024
    5fb024
    Webenv header background
    5fb024
    trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Img/1024x250.png
    5fb024
    5fb024
    5fb024
    CSS definitions
    5fb024
    trunk/Identity/Themes/Models/Default/Promo/Web/CSS/stylesheet.css
    5fb024
    5fb024
    5fb024
    5fb024
    5fb024
    5fb024

    3.11.2.5 Producing visual style

    5fb024
    5fb024

    The visual style of CentOS web environment is defined in the following

    5fb024
    files:
    5fb024

    5fb024
    trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Xcf/1024x250.xcf
    5fb024
    trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Img/1024x250.png
    5fb024
    trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Img/1024x250-bg.png
    5fb024
    trunk/Identity/Themes/Motifs/$THEME/Backgrounds/Tpl/1024x250.svg
    5fb024
    5fb024

    As graphic designer you use <tt>`1024x250.xcf'</tt> file to produce

    5fb024
    <tt>`1024x250-bg.png'</tt> file. Later, inside <tt>`1024x250.svg'</tt> file,
    5fb024
    you use the <tt>`1024x250-bg.png'</tt> file as background layer to draw
    5fb024
    your vectorial design. When you consider you artwork ready, use the
    5fb024
    centos-art.sh script, as described below, to produce the
    5fb024
    visual style controller images of CentOS web environment.
    5fb024

    5fb024
    centos-art render --entry=trunk/Identity/Themes/Motifs/$THEME/Backgrounds --filter='1024x250'
    5fb024
    5fb024

    Once you have rendered required image files, changing the visual style

    5fb024
    of CentOS web environment is a matter of replacing old image files
    5fb024
    with new ones, inside webenv repository file system structure. The
    5fb024
    visual style changes will take effect the next time customization line
    5fb024
    of CentOS web applications be packaged, uploded, and installed from
    5fb024
    [webenv] or [webenv-test] repositories.
    5fb024

    5fb024
    5fb024
    5fb024

    3.11.2.6 Navigation

    5fb024
    5fb024

    Inside CentOS web environment, the one-step navegation between web

    5fb024
    applications is addressed using the web environment navigation bar.
    5fb024
    The web environment navigation bar contains links to main applications
    5fb024
    and is always visible no matter where you are inside the web
    5fb024
    environment.
    5fb024

    5fb024
    5eb4a2

    The CentOS web navigation design model

    5fb024
    0151ba

    Figure 3.4: The CentOS web navigation design model.

    5fb024
    5fb024

    5fb024
    5fb024
    5fb024

    3.11.2.7 Development and release cycle

    5fb024
    5fb024

    The CentOS web environment development and relase cycle is described

    5fb024
    below: 
    5fb024

    5fb024
    5fb024
    Download
    5fb024
    5fb024

    The first action is download the source code of web applications we

    5fb024
    want to use inside CentOS web environment.
    5fb024

    915635
    Important

    Important

    The source location from which web application are

    5fb024
    downloaded is very important. Use SRPMs from CentOS [base]
    5fb024
    and [updates] repositories as first choise, and third party
    5fb024
    repositories (e.g. RPMForge, EPEL, etc.) as last resource.
    5fb024

    5fb024
    5fb024
    5fb024
    Prepare
    5fb024
    5fb024

    Once web application source code has been downloaded, our duty is

    5fb024
    organize its files inside <samp>`webenv'</samp> version controlled repository.
    5fb024

    5fb024

    When preparing the structure keep in mind that different web

    5fb024
    applications have different visual styles, and also different ways to
    5fb024
    implement it. A convenient way to organize the file system structure
    5fb024
    would be create one development line for each web application we use
    5fb024
    inside CentOS web environment. For example, consider the following
    5fb024
    file system structure:
    5fb024

    5fb024
    https://projects.centos.org/svn/webenv/trunk/
    5fb024
    |-- WebApp1/
    5fb024
    |   |-- Sources/
    5fb024
    |   |   `-- webapp1-0.0.1/
    5fb024
    |   |-- Rpms/
    5fb024
    |   |   `-- webapp1-0.0.1.rpm
    5fb024
    |   |-- Srpms/
    5fb024
    |   |   `-- webapp1-0.0.1.srpm
    5fb024
    |   `-- Specs/
    5fb024
    |       `-- webapp1-0.0.1.spec
    5fb024
    |-- WebApp2/
    5fb024
    `-- WebAppN/
    5fb024
    5fb024
    5fb024
    Customize
    5fb024
    5fb024

    Once web applications have been organized inside the version

    5fb024
    controlled repository file system, use subversion to create the CentOS
    5fb024
    customization development line of web applications source code.  For
    5fb024
    example, using the above file system structure, you can create the
    5fb024
    customization development line of <tt>`webapp1-0.0.1/'</tt> with the
    5fb024
    following command:
    5fb024

    5fb024
    svn cp trunk/WebApp1/Sources/webapp1-0.0.1 trunk/WebApp1/Sources/webapp1-0.0.1-webenv
    5fb024
    5fb024

    The command above creates the following structure:

    5fb024

    5fb024
    https://projects.centos.org/svn/webenv/trunk/
    5fb024
    |-- WebApp1/
    5fb024
    |   |-- Sources/
    5fb024
    |   |   |-- webapp1-0.0.1/
    5fb024
    |   |   `-- webapp1-0.0.1-webenv/
    5fb024
    |   |-- Rpms/
    5fb024
    |   |   `-- webapp1-0.0.1.rpm
    5fb024
    |   |-- Srpms/
    5fb024
    |   |   `-- webapp1-0.0.1.srpm
    5fb024
    |   `-- Specs/
    5fb024
    |       `-- webapp1-0.0.1.spec
    5fb024
    |-- WebApp2/
    5fb024
    `-- WebAppN/
    5fb024
    5fb024

    In the above structure, the <tt>`webapp1-0.0.1-webenv/'</tt> directory is

    5fb024
    the place where you customize the visual style of
    5fb024
    <tt>`webapp1-0.0.1/'</tt> web application. 
    5fb024

    5fb024
    Info

    Tip

    Use Subversion's diff between CentOS

    5fb024
    customization and upstream development lines to know what you are
    5fb024
    changing exactly.
    5fb024

    5fb024
    5fb024
    5fb024
    Build packages
    5fb024
    5fb024

    When web application has been customized, build the web application

    5fb024
    RPM and SRPM using the source location with <samp>`-webenv'</samp> prefix. 
    5fb024

    5fb024
    https://projects.centos.org/svn/webenv/trunk/
    5fb024
    |-- WebApp1/
    5fb024
    |   |-- Sources/
    5fb024
    |   |   |-- webapp1-0.0.1/
    5fb024
    |   |   `-- webapp1-0.0.1-webenv/
    5fb024
    |   |-- Rpms/
    5fb024
    |   |   |-- webapp1-0.0.1.rpm
    5fb024
    |   |   `-- webapp1-0.0.1-webenv.rpm
    5fb024
    |   |-- Srpms/
    5fb024
    |   |   |-- webapp1-0.0.1.srpm
    5fb024
    |   |   `-- webapp1-0.0.1-webenv.srpm
    5fb024
    |   `-- Specs/
    5fb024
    |       |-- webapp1-0.0.1.spec
    5fb024
    |       `-- webapp1-0.0.1-webenv.spec
    5fb024
    |-- WebApp2/
    5fb024
    `-- WebAppN/
    5fb024
    5fb024
    5fb024
    Release for testing
    5fb024
    5fb024

    When the customized web application has been packaged, make packages

    5fb024
    available for testing and quality assurance. This can be achives using
    5fb024
    a [webenv-test] yum repository. 
    5fb024

    5fb024
    info

    Note

    The [webenv-test] repository is not shipped inside

    5fb024
    CentOS distribution default yum configuraiton. In order to use
    5fb024
    [webenv-test] repository you need to configure it first.
    5fb024

    5fb024
    5fb024

    If some problem is found to install/update/use the customized version

    5fb024
    of web application, the problem is notified somewhere (a bugtracker
    5fb024
    maybe) and the customization face is repated in order to fix the
    5fb024
    problem. To release the new package add a number after <samp>`-webenv'</samp>
    5fb024
    prefix. For example, if some problem is found in
    5fb024
    <tt>`webapp1-0.0.1-webenv.rpm'</tt>, when it be fixed the new package will
    5fb024
    be named <tt>`webapp1-0.0.1-webenv-1.rpm'</tt>. If a problem is found in
    5fb024
    <tt>`webapp1-0.0.1-webenv-1.rpm'</tt>, when it be fixed the new package
    5fb024
    will be named <tt>`webapp1-0.0.1-webenv-2.rpm'</tt>, and so on.
    5fb024

    5fb024

    The "customization -- release for testing" process is repeated

    5fb024
    until CentOS quality assurance team considers the package is ready for
    5fb024
    production.
    5fb024

    5fb024
    5fb024
    Release for production
    5fb024
    5fb024

    When customized web application packages are considered ready for

    5fb024
    production they are moved from [webenv-test] to [webenv] repository.
    5fb024
    This action is commited by CentOS quality assurance team.
    5fb024

    5fb024
    info

    Note

    The [webenv] repository is not shipped inside CentOS

    5fb024
    distribution default yum configuraiton. In order to use [webenv]
    5fb024
    repository you need to configure it first.
    5fb024

    5fb024
    5fb024
    5fb024
    5fb024
    5fb024
    5fb024

    3.11.2.8 The [webenv-test] repository

    5fb024
    5fb024
    /etc/yum.repos.d/CentOS-Webenv-test.repo
    5fb024
    5fb024
    [webenv-test]
    5fb024
    name=CentOS-$releasever - Webenv-test
    5fb024
    mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=webenv-test
    5fb024
    #baseurl=http://mirror.centos.org/centos/$releasever/webenv-test/$basearch/
    5fb024
    gpgcheck=1
    5fb024
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-$releasever
    5fb024
    enabled=1
    5fb024
    priority=10
    5fb024
    5fb024
    5fb024
    5fb024

    3.11.2.9 The [webenv] repository

    5fb024
    5fb024
    /etc/yum.repos.d/CentOS-Webenv.repo
    5fb024
    5fb024
    [webenv]
    5fb024
    name=CentOS-$releasever - Webenv
    5fb024
    mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=webenv
    5fb024
    #baseurl=http://mirror.centos.org/centos/$releasever/webenv/$basearch/
    5fb024
    gpgcheck=1
    5fb024
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-$releasever
    5fb024
    enabled=1
    5fb024
    priority=10
    5fb024
    5fb024
    5fb024
    5fb024

    3.11.2.10 Priority configuration

    5fb024
    5fb024

    Both [webenv] and [webenv-test] repositories update packages inside

    5fb024
    CentOS [base] and CentOS [updates] repositories.
    bc3531

    4c79b5
    1e9202
    4c79b5

    3.11.3 Usage

    4c79b5
    5fb024
      5fb024
    • ...
    • 5fb024
      5fb024
      4c79b5
      1e9202
      4c79b5

      3.11.4 See also

      4c79b5
      5fb024
      5fb024
      3.9 trunk/Identity/Models/Img/Promo/Web  
      5fb024
      5fb024
      4c79b5
      4c79b5
      4c79b5
      1e9202
      [ < ]
      1e9202
      [ > ]
      4c79b5
         
      4c79b5
      [ << ]
      5fb024
      [ Up ]
      c489c0
      [ >> ]
      4c79b5
      4c79b5

      4c79b5
       <font size="-1">
      92fb7f
        This document was generated on January, 5 2011 using texi2html 1.76.
      4c79b5
       </font>
      4c79b5
       
      4c79b5
      4c79b5

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