documentation/manual/source/themes.rst
Wesley Stout 9da96a89b1 head
2011-09-27 12:47:50 -05:00

236 lines
7.4 KiB
ReStructuredText

.. _themes:
======
Themes
======
The *Theme Manager* is where you can set backgrounds, fonts, and colors to the
style you desire. From the theme manager you can create a new theme, Edit a
theme, Delete a theme, Import a theme, and Export a theme.
.. image:: /pics/theme_manager_main.png
Creating New Themes
===================
|theme_new| **Create a new theme:**
This will bring up the *Theme Wizard*
.. image:: /pics/theme_manager_wizard.png
Click :guilabel:`Next`. You have 3 choices in the drop down menu for Background
type: Solid Color, Gradient, or Image.
.. image:: /pics/theme_manager_background.png
**Solid color:**
Select solid color and click on the black button next to Color. You have the
option of choosing among the colors you see or entering your own.
.. image:: /pics/theme_manager_selectcolor.png
**Gradient:**
Choose the two colors, *Starting* and *Ending* that you want to fade
together and the Gradient drop down will let you determine the directions
of the fade.
.. image:: /pics/theme_manager_gradient.png
**Image:**
You have the ability to use an image for your background. OpenLP accepts a
variety of image types. JPG is the most common format of images but can
cause previews to be slow. If you experience this you may want to convert
your image to PNG as it previews quicker than other formats.
.. image:: /pics/theme_manager_image.png
**Background color:**
Choose the color that will appear on the borders if your image is smaller
than your projector display setting.
**Image:**
Click |buttons_open| to find and select your image.
**Note:** When possible, try to use the same size image as your projector is
displaying unless you want a background color for a border.
When finished with your selection for background, click the :guilabel:`Next`
button.
Main Area Font Details
----------------------
This is the area where you will select and define your font characteristics for
the Display text.
.. image:: /pics/theme_manager_mainfont.png
**Font:**
Choose the font you would like to use from the drop down.
**Color:**
Choose the color of your font.
**Size:**
The size of your font determines how many lines are shown per slide.
As you change the font size, the lines per slide will change.
**Line Spacing:**
This setting determines how much space you want between lines. This setting
will also change the lines per slide.
**Outline:**
If you desire an outline around your font, select the Outline box, choose
your color and size of the outline.
**Shadow:**
If you desire a shadow around your font, select the Shadow box and choose
your color and size of the shadow.
**Bold Display:**
Select the box for Bold font
**Italic Display:**
Select the box for Italic font
When you are finished selecting your font details click the :guilabel:`Next`
button.
Footer Area Font Details
------------------------
This page determines the Font, Font Color, and size of the font for the footer.
The footer is where the Title of the song, Author or Authors, Copyright and
CCLI License are displayed.
.. image:: /pics/theme_manager_footerfont.png
When you are finished setting your footer font details, click :guilabel:`Next`.
Text Formatting Details
-----------------------
This page determines the alignment of the text on your slide and the transition
from one slide to the next.
.. image:: /pics/theme_manager_textalign.png
**Horizontal Align:**
This moves the text to the Left, Right, Center or Justify on the screen.
**Note:** Text is only justified when the text does not fit on one line,
(only when a line is wrapped).
**Vertical Align:**
This moves the text to the Top, Middle or Bottom of the screen.
**Transitions:**
When this box is selected, switching slides will fade out from one and fade
in to the next. When the box is not selected, slide changing will be instant.
When you are finished setting your Text Formatting Details, click :guilabel:`Next`.
Output Area Locations
---------------------
This page gives you the ability to position your Main area or Footer area to a
specific area of the screen using the x and y positions. ie: if you do not want
your footer on the bottom left, you can make the adjustment here.
You can re-size the Width and the Height of the Main Area and the Footer Area.
ie: If you have a temporary or permanent obstacle in one part of the viewing
area, you can re-size the Main or Footer area and use x and y positions to
display in a different position on the screen.
.. image:: /pics/theme_manager_outputlocation.png
You can also change the Width and the Height of the Main Area and the Footer Area.
When you are finished setting your Output Area Locations, click :guilabel:`Next`.
Save and Preview
----------------
.. image:: /pics/theme_manager_save.png
**Theme Name:**
Enter your theme name here.
**Preview:**
The Preview shows the choices you made when setting up the previous pages
plus, shows all the edit effects possible so you can see what the impact
is on all possible font colors and characteristics.
When you are satisfied with your selections, click :guilabel:`Finish`. If you
want to make a change, use the :guilabel:`Back` button.
Editing Themes
==============
Now that you created your theme and you display it on the projector and there is
something you don't like, you can easily *Edit* your theme either by clicking
the |theme_edit| Theme Edit Button or by right-clicking your theme and selecting
the appropriate action.
Deleting Themes
===============
|theme_delete| **Delete a theme:**
Delete a selected theme or you can right-click your theme and select
:guilabel:`Delete`.
**Note:** Deleting the currently selected global theme or the default theme is
not possible.
.. _export_themes:
Exporting Themes
================
If you would like to transfer a theme from one computer to another, click on
the theme you want to export, click |theme_export| and choose the folder you
want to save your theme in and click :guilabel:`OK`.
.. _import_themes:
Importing Themes
================
To import a theme that has been previously exported, click the import button
|theme_import| and select the folder and the theme file, and click :guilabel:`OK`.
Your imported theme will be entered in the Theme Manager. *Import Theme* will
also handle version 1 Exports. You will need to check your imported theme since
many of the values will have been defaulted.
Rename Theme
============
If you created a theme and want to change the name of it, right-click your
theme and click Rename theme and enter the new name.
Copy Theme
==========
Now that you created a theme with all the attributes you like, you can
right-click the theme, click on Copy theme, choose your new name and click OK.
You now have a duplicate of your first theme that you can edit the way you want.
Set as Global default
=====================
If you right-click your theme, you have the option to set the theme as Global
default. This option is covered in greater detail under :ref:`configure`.
.. These are all the image templates that are used in this page.
.. |THEME_DELETE| image:: pics/theme_delete.png
.. |THEME_EDIT| image:: pics/theme_edit.png
.. |THEME_EXPORT| image:: pics/theme_export.png
.. |THEME_IMPORT| image:: pics/theme_import.png
.. |THEME_NEW| image:: pics/theme_new.png
.. |BUTTONS_OPEN| image:: pics/buttons_open.png