documentation/manual/source/themes.rst
2015-09-16 14:39:03 +01:00

259 lines
8.3 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 4 choices in the drop down menu for Background
type: Solid Color, Gradient, Image or Transparent.
.. 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, :guilabel:`Starting color` and :guilabel:`Ending color`
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.
**Transparent:**
Using the transparent theme will use whatever wallpaper or background color
that your desktop is using for the theme background.
.. image:: /pics/theme_manager_transparent.png
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 change the position of your main area and
footer area to a specific location on the screen using the X and Y positions or
a specific size using width and height. (e.g. if you have a theme image with a
border around it and do not want your lyrics to be displayed over top of the
border or if you do not want your footer displayed on the bottom left, you can
make the adjustments here).
.. image:: /pics/theme_manager_outputlocation.png
To view your main and footer layout positions click :guilabel:`Layout Preview`.
The blue outlined area shows the position of the main window and the red
outlined area is the position of the footer area. To go back to the previous
window click :guilabel:`OK`
.. image:: /pics/theme_manager_layout.png
To change the default locations or sizes of the main and footer area toggle off
the :guilabel:`Use default location` on the main area or footer area by clicking
on the checkmark. This will unlock the X and Y positions and the width and
height. You will now be able to change the settings.
.. image:: /pics/theme_manager_outputchanged.png
Click :guilabel:`Layout Preview` to view the changes made.
.. image:: /pics/theme_manager_layoutchanged.png
When you are satisfied with the settings of 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:** You cannot delete the theme currently selected as global or default.
.. _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.
**Note:** You cannot rename the theme currently selected as global or default.
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