# Coppermine Photo Gallery v1.5.x: Documentation and Manual

No translation available

# Editing style.css

The file style.css exists in every theme. It contains the Cascading Style Sheet (aka "CSS") for the theme. It's beyond the scope of this document to explain the aspects of CSS for absolute beginners. The idea behind CSS is to have a separation between content (the textual output mainly) and the way the content is represented - the looks. With this being said, the style sheet controls the colors and nearly all design aspects of the output of your gallery. That's why it's worth looking at it: with only some minor changes in the style you can change the overall design of your entire gallery.

## Tools

You will need some tools to edit the style sheet, but don't be afraid - nearly all of them are available for free. We have created a list of tools sorted by type that you're welcome to review: Tools recommended by the devs.

You will need a plain-text editor (notepad.exe will do, but it's recommended to use one of the more powerfull editors from the above mentioned tools page. You should not use a graphical WYSIWYG-editor though unless you know you are aware of the limitations of such editors.

## List of classes in style.css

Name | Description | Needed? | Type
--- | --- | --- | ---
textinput | . | mandatory | class
listbox | . | mandatory | class
button | . | mandatory | class
radio | . | mandatory | class
checkbox | . | mandatory | class
bblink | . | mandatory | class
maintable | . | mandatory | class
tableh1 | . | mandatory | class
tableh2 | . | mandatory | class
tableb | . | mandatory | class
tableb_alternate | . | mandatory | class
tablef | . | mandatory | class
catrow | . | mandatory | class
catrow_noalb | . | mandatory | class
album_stat | . | mandatory | class
thumb_filename | . | mandatory | class
thumb_title | . | mandatory | class
thumb_caption | . | mandatory | class
thumb_num_comments | . | mandatory | class
user_thumb_infobox | . | mandatory | class
sortorder_cell | . | mandatory | class
sortorder_options | . | mandatory | class
navmenu | . | mandatory | class
admin_menu | . | mandatory | class
admin_float | . | mandatory | class
admin_menu_wrapper | . | mandatory | class
admin_menu_anim | . | mandatory | object
icon | . | mandatory | class
comment_date | . | mandatory | class
image | . | mandatory | class
middlethumb | . | mandatory | class
imageborder | . | mandatory | class
display_media | . | mandatory | class
thumbnails | . | mandatory | class
footer | . | mandatory | class
statlink | . | mandatory | class
alblink | . | mandatory | class
catlink | . | mandatory | class
topmenu | . | mandatory | class
img_caption_table | . | mandatory | class
debug_text | . | mandatory | class
clickable_option | . | mandatory | class
listbox_lang | . | mandatory | class
pic_title | . | mandatory | class
pic_caption | . | mandatory | class
cpg_main_block | . | mandatory | object
important | . | mandatory | class
cpgChooseLanguageWrapper | . | mandatory | object
cpgChooseThemeWrapper | . | mandatory | object
filmstrip_background | . | mandatory | class
bookmarkIt | . | mandatory | object
. | . | mandatory | class
. | . | mandatory | class
. | . | mandatory | class
. | . | mandatory | class
. | . | mandatory | class
. | . | mandatory | class
. | . | mandatory | class

...tbc...

## Additional stylesheet

In addition to your individual theme's stylesheet, coppermine contains reference to an overal style sheet file that contains CSS definitions that are theme-independant. Those overall styles reside in `css/coppermine.css` and should not be edited unless you really know your way around. Instead, it is recommended to override in your custom stylesheet the definitions made in that overall file.