Blame Identity/Webenv/Themes/Default/Mantis/1.1.8-5.el5/README

c54774
This file describes The CentOS Project customized version of mantisBT
c54774
(v1.1.8-5.el5) default visual style.
c54774
c54774
Theme Files
c54774
-----------
c54774
.
c54774
|-- centos-bottom.html        --> The page footer.
c54774
|-- centos-header.html        --> The page header.
c54774
|-- config_inc.php            --> Example of mantis configuration file.
c54774
|-- css
c54774
|   `-- default-centos.css    --> The CentOS Project visual style customization.
c54774
`-- images
c54774
    |-- centos-bugs-logo.png  --> The logo used by The CentOS Bugs website.
c54774
    |-- centos-favicon.png    --> The favicon used by The CentOS Bugs website.
c54774
    |-- h2-background.png     --> The background image used on titles
c54774
    `-- header-background.png --> the background image used on header and footer.
c54774
c54774
c54774
How To Install 
c54774
--------------
c54774
c54774
1. yum install mantis
c54774
c54774
   NOTE: This require you to have epel repository installed in your
c54774
   CentOS distribution. To know how to install the epel repository
c54774
   read http://wiki.centos.org/AdditionalResources/Repositories
c54774
c54774
2. Configure mantisBT application and be sure it works as you expect.
c54774
c54774
2. svn export https://projects.centos.org/svn/artwork/trunk/Identity/Webenv/Themes/Default/Mantis/1.1.8-5.el5 ~/Desktop/
c54774
c54774
3. Copy theme files into your system's mantisBT tree, as root user.
c54774
The source-target relation between files is shown in the following
c54774
table:
c54774
c54774
---------------------------------------------------+-----------------------------------------------
c54774
SOURCE                                             | TARGET
c54774
---------------------------------------------------+-----------------------------------------------
c54774
~/Desktop/1.1.8-5.el5/centos-bottom.html           | /usr/share/mantis/centos-bottom.html
c54774
~/Desktop/1.1.8-5.el5/centos-header.html           | /usr/share/mantis/centos-header.html
c54774
~/Desktop/1.1.8-5.el5/css/default-centos.css       | /usr/share/mantis/css/default-centos.css
c54774
~/Desktop/1.1.8-5.el5/images/centos-bugs-logo.png  | /usr/share/mantis/images/centos-bugs-logo.png
c54774
~/Desktop/1.1.8-5.el5/images/centos-favicon.png    | /usr/share/mantis/images/centos-favicon.png
c54774
~/Desktop/1.1.8-5.el5/images/h2-background.png     | /usr/share/mantis/images/h2-background.png
c54774
~/Desktop/1.1.8-5.el5/images/header-background.png | /usr/share/mantis/images/header-background.png
c54774
---------------------------------------------------+-----------------------------------------------
c54774
c54774
4. Check file permissions. Be sure these files are readable by apache
c54774
web server. For example, if both user and group for these files are
c54774
set to `root', then the `-rw-r--r--' rights are ok for all these
c54774
files.
c54774
c54774
5. Update your configuration file. Be sure it has the following
c54774
information:
c54774
c54774
	# --- html variables --------------
c54774
	$g_window_title 	    = "The CentOS Bugs";
c54774
	$g_top_include_page 	= "centos-header.html";
c54774
	$g_bottom_include_page 	= "centos-bottom.html";
c54774
	$g_css_include_file 	= "css/default-centos.css";
c54774
	$g_favicon_image 	    = "images/centos-favicon.png";
c54774
c54774
6. Point your browser to mantisBT install and reload it to see the
c54774
changes.
c54774
c54774
Package Updates
c54774
---------------
c54774
An important characteristic of this theme is that all modifications
c54774
take place in the configuration file and CSS files. No PHP files
c54774
inside the mantis package needs to be modified (except the
c54774
configuration file, of course.). This way you can update the mantis
c54774
package installed in your system without loosing the visual style
c54774
you already set for it.
c54774
c54774
Feedback
c54774
--------
c54774
Your comments and suggestions are very welcome. In fact, we need them
c54774
to make this work better. Thus, feel free to send e-mails to
c54774
centos-devel@centos.org mailing list or fill a ticket at
c54774
https://projects.centos.org/trac/artwork/newticket page.
c54774
c54774
Author
c54774
------
c54774
The following people have worked in The CentOS Project customization
c54774
of mantisBT default theme:
c54774
c54774
    * Alain Reguera Delgado <alain.reguera@gmail.com>, 2013