This file describes The CentOS Project customized version of mantisBT

(v1.1.8-5.el5) default visual style.

Theme Files

-----------

.

|-- centos-bottom.html        --> The page footer.

|-- centos-header.html        --> The page header.

|-- config_inc.php            --> Example of mantis configuration file.

|-- css

|   `-- default-centos.css    --> The CentOS Project visual style customization.

`-- images

    |-- centos-bugs-logo.png  --> The logo used by The CentOS Bugs website.

    |-- centos-favicon.png    --> The favicon used by The CentOS Bugs website.

    |-- h2-background.png     --> The background image used on titles

    `-- header-background.png --> the background image used on header and footer.

How To Install 

--------------

1. yum install mantis

   NOTE: This require you to have epel repository installed in your

   CentOS distribution. To know how to install the epel repository

   read http://wiki.centos.org/AdditionalResources/Repositories

2. Configure mantisBT application and be sure it works as you expect.

2. svn export https://projects.centos.org/svn/artwork/trunk/Identity/Webenv/Themes/Default/Mantis/1.1.8-5.el5 ~/Desktop/

3. Copy theme files into your system's mantisBT tree, as root user.

The source-target relation between files is shown in the following

table:

---------------------------------------------------+-----------------------------------------------

SOURCE                                             | TARGET

---------------------------------------------------+-----------------------------------------------

~/Desktop/1.1.8-5.el5/centos-bottom.html           | /usr/share/mantis/centos-bottom.html

~/Desktop/1.1.8-5.el5/centos-header.html           | /usr/share/mantis/centos-header.html

~/Desktop/1.1.8-5.el5/css/default-centos.css       | /usr/share/mantis/css/default-centos.css

~/Desktop/1.1.8-5.el5/images/centos-bugs-logo.png  | /usr/share/mantis/images/centos-bugs-logo.png

~/Desktop/1.1.8-5.el5/images/centos-favicon.png    | /usr/share/mantis/images/centos-favicon.png

~/Desktop/1.1.8-5.el5/images/h2-background.png     | /usr/share/mantis/images/h2-background.png

~/Desktop/1.1.8-5.el5/images/header-background.png | /usr/share/mantis/images/header-background.png

---------------------------------------------------+-----------------------------------------------

4. Check file permissions. Be sure these files are readable by apache

web server. For example, if both user and group for these files are

set to `root', then the `-rw-r--r--' rights are ok for all these

files.

5. Update your configuration file. Be sure it has the following

information:

	# --- html variables --------------

	$g_window_title 	    = "The CentOS Bugs";

	$g_top_include_page 	= "centos-header.html";

	$g_bottom_include_page 	= "centos-bottom.html";

	$g_css_include_file 	= "css/default-centos.css";

	$g_favicon_image 	    = "images/centos-favicon.png";

6. Point your browser to mantisBT install and reload it to see the

changes.

Package Updates

---------------

An important characteristic of this theme is that all modifications

take place in the configuration file and CSS files. No PHP files

inside the mantis package needs to be modified (except the

configuration file, of course.). This way you can update the mantis

package installed in your system without loosing the visual style

you already set for it.

Feedback

--------

Your comments and suggestions are very welcome. In fact, we need them

to make this work better. Thus, feel free to send e-mails to

centos-devel@centos.org mailing list or fill a ticket at

https://projects.centos.org/trac/artwork/newticket page.

Author

------

The following people have worked in The CentOS Project customization

of mantisBT default theme:

    * Alain Reguera Delgado <alain.reguera@gmail.com>, 2013