Updated some links/URLs.

Updated screenshots for Mac OS X installation.
Update the install guide for unbuntu, and added some levels to the headings.
Update to the unity disapproval.
Added docs for dual monitors setup on Xfce4 and workaround.
Updated android sceenshots and docs, and added to troubleshooting.

bzr-revno: 126
This commit is contained in:
second@tgc.dk 2015-10-16 20:44:30 +01:00 committed by Tim Bentley
commit a64c0d37a7
13 changed files with 90 additions and 92 deletions

View File

@ -157,7 +157,7 @@ Importing CSV formatted Bibles
If you have a Bible in .csv format OpenLP can import it. If you wish to create If you have a Bible in .csv format OpenLP can import it. If you wish to create
a bible in the CSV format yourself the format is documented in the a bible in the CSV format yourself the format is documented in the
`OpenLP API documentation <http://docs.openlp.org/plugins/bibles.html#module-openlp.plugins.bibles.lib.csvbible>`_. `OpenLP API documentation <http://api.openlp.io/api/openlp/plugins/bibles/lib/csvbible.html#module-openlp.plugins.bibles.lib.csvbible>`_.
CSV Bibles will consist of two files a `books` file and a `verse` file. CSV Bibles will consist of two files a `books` file and a `verse` file.
Select CSV from the list of Bible types to import. Select CSV from the list of Bible types to import.

View File

@ -149,10 +149,14 @@ assumes you have properly set up any proprietary drivers if needed. You
should seek out your distributions documentation if this general guide does not should seek out your distributions documentation if this general guide does not
work. work.
**Note to Ubuntu 11.04 Users:** Ubuntu 11.04 uses the new Unity interface. It **Note to Ubuntu Users:** Standard Ubuntu uses the Unity interface.
is recommended to use the *Classic Desktop* option. OpenLP and other Unfortunately we cannot recommend using Unity for a dual display setup with
applications requiring dual monitors may not work well with Unity due to issues OpenLP, since there seems to be no reliable way to hide the menubar from the
experienced by other users with the Unity interface. secondary display, as well as other issues. Instead we recommend using a
different desktop environment like GNOME, KDE or Xfce, all of which are
available from the Ubuntu repositories, and via special Ubuntu variants, such as
`Ubuntu GNOME <https://ubuntugnome.org/>`_, `Kubuntu <http://kubuntu.org/>`_ or
`Xubuntu <http://xubuntu.org/>`_.
GNOME 3 GNOME 3
^^^^^^^ ^^^^^^^
@ -196,6 +200,34 @@ From here you will need to set up your projector with the appropriate
resolution, and position. OpenLP works best projecting to the monitor on the resolution, and position. OpenLP works best projecting to the monitor on the
right. right.
.. _xfce4display:
Xfce4
^^^^^
This guide is for users of the Xfce4 desktop. Open the Xfce4 menu and chose
:guilabel:`Settings Manager`.
.. image:: pics/xfce4-settings.png
Open :guilabel:`Display` to open the settings for displays.
.. image:: pics/xfce4-display.png
If the second display has not yet been enabled, enable it by selecting it in the
window and tick `Use this display`.
There is an issue with the Xfce4 compositor that makes OpenLP freeze when using
a dual monitor setup. This issue can be worked around by disabling an option for
the compositor. To do this open :guilabel:`Settings Manager` and open
:guilabel:`Window Manager Tweaks`.
.. image:: pics/xfce4-win-manager-tweaks-comp.png
Go to the :guilabel:`Compositor` tab and disable :guilabel:`Display fullscreen
overlay windows directly`. Click :guilabel:`Close` and now OpenLP should run
without issues.
Linux Systems Using nVidia Drivers Linux Systems Using nVidia Drivers
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

View File

@ -151,7 +151,7 @@ The Bible plugin has a `Import Wizard` which can import Bibles
from a variety of sources. The following sources are supported: from a variety of sources. The following sources are supported:
CSV CSV
The format is documented in the `OpenLP API documentation <http://docs.openlp.org/plugins/bibles.html#module-openlp.plugins.bibles.lib.csvbible>`_. The format is documented in the `OpenLP API documentation <http://api.openlp.io/api/openlp/plugins/bibles/lib/csvbible.html#module-openlp.plugins.bibles.lib.csvbible>`_.
OSIS OSIS
An XML format for Bible. You can export Bibles from the `Sword Project <http://www.crosswire.org/sword/software/>`_ An XML format for Bible. You can export Bibles from the `Sword Project <http://www.crosswire.org/sword/software/>`_

View File

@ -13,59 +13,19 @@ Installation of OpenLP on Ubuntu can either be done through the Software Center
or the command line. Command line instructions will be included at the end of or the command line. Command line instructions will be included at the end of
this section on Ubuntu and its variants. this section on Ubuntu and its variants.
Ubuntu 12.04 or later OpenLP 2.2 supports Ubuntu 14.04 or later versions. There is currently an older
^^^^^^^^^^^^^^^^^^^^^^^^^ version of OpenLP available in the official Ubuntu repositories, which can be
found using the Software Center, but to get OpenLP 2.2 it is necessary to add
the OpenLP Personal Package Archive (PPA) to your system.
If you are using Ubuntu 12.10 or a more recent version then OpenLP is Ubuntu, Ubuntu GNOME, Xubuntu
included in the standard distribution. If you are using Ubuntu 12.04 then ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
OpenLP has been added to the backports packages and so is available
with the appropriate setting below.
Open up the software center by clicking on the :guilabel:`Software Center` icon
in the Launcher if you are using the Unity desktop, or if you are using an
older version of Ubuntu, or the Classic Desktop go to :menuselection:`Applications`
and select the Software Center from the bottom of the menu. You will need to
be the administrator of the system to install OpenLP and will be asked for the
administrator password several times through this process.
If using Ubuntu 12.04 then when you have the Software Center running you need to
turn on support for backports. From the menu choose Edit/Software Sources and
then the "Updates" tab. Now make sure that "Unsupported Updates
(precise-backports) is ticked. Then click :guilabel:`close`.
.. image:: pics/ubuntu-backports.png
Next in any of these versions simply search for OpenLP in the Software Center
and click :guilabel:`Install`.
.. image:: pics/4searchopenlp.png
You will see the install progress as OpenLP and the dependencies required for
it to run are downloaded.
.. image:: pics/5installprogressubuntu.png
After installation you should see that OpenLP is installed.
.. image:: pics/6installcompleteubuntu.png
You can now run OpenLP by either searching for it in the *Dash*, or clicking on
the category *Media Apps* in Unity. If you are running the Classic Desktop you
will have OpenLP available by clicking
:menuselection:`Applications --> Sound and Video --> OpenLP`
Ubuntu older than 12.04
^^^^^^^^^^^^^^^^^^^^^^^^
In older versions of Ubuntu you will first need to add the
OpenLP Personal Package Archive (PPA) to your system.
Open up the software center using :menuselection:`Applications` Open up the software center using :menuselection:`Applications`
and select the Software Center from the bottom of the menu. You will need to and select the Software Center from the bottom of the menu. You will need to
be the administrator of the system to install OpenLP and will be asked for the be the administrator of the system to install OpenLP and will be asked for the
administrator password several times through this process. administrator password several times through this process.
Then go to :menuselection:`Edit --> Software Sources` Then go to :menuselection:`Edit --> Software Sources`
.. image:: pics/1softwaresources.png .. image:: pics/1softwaresources.png
@ -104,7 +64,7 @@ will have OpenLP available by clicking
:menuselection:`Applications --> Sound and Video --> OpenLP` :menuselection:`Applications --> Sound and Video --> OpenLP`
Kubuntu Kubuntu
------- ^^^^^^^
From the Kickoff Menu click :guilabel:`System Settings` Then click on From the Kickoff Menu click :guilabel:`System Settings` Then click on
:guilabel:`Software Management`. :guilabel:`Software Management`.
@ -160,22 +120,10 @@ menu.
.. image:: pics/kubuntuopenlplaunch.png .. image:: pics/kubuntuopenlplaunch.png
Ubuntu Command Line Install Ubuntu Command Line Install
--------------------------- ^^^^^^^^^^^^^^^^^^^^^^^^^^^
If you are using Ubuntu 12.10 or a more recent version then OpenLP is included First you will need to add the Personal Package Archive (PPA) to Ubuntu's
in the standard distribution. To Install OpenLP open a terminal and type:: software sources. From a terminal type::
user@ubuntu:~$ sudo apt-get install openlp
OpenLP should now be available in your desktop's menu system, but if you wish
to run OpenLP from the command line type::
user@ubuntu:~$ openlp
If you are using an older Ubuntu that does not include OpenLP in the standard
distribution then the following install procedure should work across all Ubuntu
variants. First you will need to add the Personal Package Archive (PPA) to
Ubuntu's software sources. From a terminal type::
user@ubuntu:~$ sudo add-apt-repository ppa:openlp-core/release user@ubuntu:~$ sudo add-apt-repository ppa:openlp-core/release
@ -192,12 +140,18 @@ to run OpenLP from the command line type::
user@ubuntu:~$ openlp user@ubuntu:~$ openlp
Fedora (GNOME) Fedora
-------------- ------
To install OpenLP on Fedora follow the instructions below. The instructions
describes how to do the install when using GNOME, KDE or the command line.
**Note** When installing OpenLP you will need to have administrator privileges. **Note** When installing OpenLP you will need to have administrator privileges.
You will be asked for the administrator password to install. You will be asked for the administrator password to install.
Fedora (GNOME)
^^^^^^^^^^^^^^
Installing with Fedora you will use the default Add/Remove Programs available Installing with Fedora you will use the default Add/Remove Programs available
from :menuselection:`System --> Administration --> Add/Remove Programs` in from :menuselection:`System --> Administration --> Add/Remove Programs` in
Fedora 14 and below or in :menuselection:`Applications --> System Tools --> Fedora 14 and below or in :menuselection:`Applications --> System Tools -->
@ -229,10 +183,7 @@ later.
OpenLP will be available in :menuselection:`Applications --> Sound & Video --> OpenLP` OpenLP will be available in :menuselection:`Applications --> Sound & Video --> OpenLP`
Fedora (KDE) Fedora (KDE)
------------ ^^^^^^^^^^^^
**Note** when installing OpenLP you will need to have administrator privileges.
You will be asked for the administrator password to install.
From the Kickoff open *Software Management*. Type OpenLP into the search From the Kickoff open *Software Management*. Type OpenLP into the search
box. Then click :guilabel:`Find by name` or press :kbd:`Enter`. box. Then click :guilabel:`Find by name` or press :kbd:`Enter`.
@ -254,7 +205,7 @@ install notification, or from the Kickoff menu.
.. image:: pics/4fedoracompleted.png .. image:: pics/4fedoracompleted.png
Fedora Command Line Install Fedora Command Line Install
--------------------------- ^^^^^^^^^^^^^^^^^^^^^^^^^^^
To install OpenLP from the command line type:: To install OpenLP from the command line type::
@ -269,9 +220,15 @@ Linux Mint
---------- ----------
The following instructions are for a standard Linux Mint install. These The following instructions are for a standard Linux Mint install. These
instructions will not work with Linux Mint Debian Edition. If your are running instructions will not work with Linux Mint Debian Edition. Most users should
Linux Mint without the standard desktop please see the :ref:`mint-command` be able to follow the instructions for :ref:`mint-softman`, but if your are
install instructions. running Linux Mint without the standard desktop please see the
:ref:`mint-command` install instructions.
.. _mint-softman:
Software Manager Install
^^^^^^^^^^^^^^^^^^^^^^^^
The administrator password will be required several times during the The administrator password will be required several times during the
installation. To install OpenLP open the Software Manager from the Mint Menu. installation. To install OpenLP open the Software Manager from the Mint Menu.
@ -317,7 +274,7 @@ from the *Sound and Video* section of the Mint Menu.
.. _mint-command: .. _mint-command:
Linux Mint Command Line Install Linux Mint Command Line Install
------------------------------- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
You will need to add the Personal Package Archive (PPA) to Linux Mint's You will need to add the Personal Package Archive (PPA) to Linux Mint's
software sources. From a terminal type:: software sources. From a terminal type::

View File

@ -2,7 +2,7 @@ Installing OpenLP on Microsoft Windows
====================================== ======================================
Installing OpenLP is identical over all supported versions of Windows. After Installing OpenLP is identical over all supported versions of Windows. After
downloading the file from the `download page <http://www.openlp.org/en/download.html>`_ downloading the file from the `website <http://www.openlp.org/>`_
open the file by double clicking when the download is complete. After opening open the file by double clicking when the download is complete. After opening
the downloaded file agree to open the unverified file if you are prompted. the downloaded file agree to open the unverified file if you are prompted.
On Windows 8 you might have to click :guilabel:`More info` before you can On Windows 8 you might have to click :guilabel:`More info` before you can
@ -63,22 +63,23 @@ Privacy Settings to run OpenLP.
Click the Apple icon and open System Preferences Click the Apple icon and open System Preferences
.. image:: pics/gatekeeper1.png .. image:: pics/mac-os-x-system-menu.png
Open the Security & Privacy settings Open the Security & Privacy settings
.. image:: pics/gatekeeper2.png .. image:: pics/mac-os-x-settings.png
Change the setting from Mac App Store to Anywhere. If the settings are grayed Change the setting from Mac App Store to Anywhere. If the settings are grayed
out click on the lock in the lower lefthand corner of the settings window to out click on the lock in the lower lefthand corner of the settings window to
enable editing. enable editing.
.. image:: pics/gatekeeper3.png .. image:: pics/mac-os-x-security-and-privacy.png
If you have not already downloaded the correct file from the OpenLP If you have not already downloaded the correct file from the OpenLP
`download page <http://www.openlp.org/en/download.html>`_, download it now. `website <http://www.openlp.org/>`_, download it now. Then double click on the
Then double click on the .dmg file. Drag the OpenLP icon over to the Applications .dmg file. This will open a window with two icons: An OpenLP icon and an
folder and you will be ready to use OpenLP. OpenLP will be available in your Applications Folder icon. To install OpenLP, simply drag the OpenLP icon over to
Applications folder. the Applications folder icon and you will be ready to use OpenLP. OpenLP will be
available in your Applications folder.
.. image:: pics/osxinstall.png .. image:: pics/mac-os-x-dnd-install.png

View File

@ -143,7 +143,7 @@ The following options are available on the quick search tab:
A detailed description of the format and how it is parsed by OpenLP can A detailed description of the format and how it is parsed by OpenLP can
be read `In the OpenLP API documentation be read `In the OpenLP API documentation
<http://docs.openlp.org/plugins/bibles.html#openlp.plugins.bibles.lib.parse_reference>`_. <http://api.openlp.io/api/openlp/plugins/bibles/lib.html#openlp.plugins.bibles.lib.parse_reference>`_.
If an invalid format is used for a search a popup window will show the If an invalid format is used for a search a popup window will show the
examples also shown above. examples also shown above.
@ -328,8 +328,7 @@ Clicking on *Media* in the :ref:`g-media-manager` will display the media item
for media. The media item shows a list of imported audio or video files. for media. The media item shows a list of imported audio or video files.
**Note:** On some computers OpenLP has trouble displaying videos. Please read **Note:** On some computers OpenLP has trouble displaying videos. Please read
the `Frequently Asked Questions <http://wiki.openlp.org/faq>`_ for tips on how the :ref:`troubleshooting` for tips on how to resolve these issues.
to resolve these issues.
.. image:: pics/mediamanager_media.png .. image:: pics/mediamanager_media.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 61 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 64 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 73 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 68 KiB

View File

@ -1,3 +1,5 @@
.. _troubleshooting:
=============== ===============
Troubleshooting Troubleshooting
=============== ===============
@ -207,3 +209,10 @@ The `servicemanager` folder which can be found in OpenLP's data folder is used
internally by OpenLP for temporary files and anything in there can and will be internally by OpenLP for temporary files and anything in there can and will be
deleted by OpenLP. In general you should not modify or create files in OpenLP's deleted by OpenLP. In general you should not modify or create files in OpenLP's
data folder unless you know what you are doing. data folder unless you know what you are doing.
OpenLP freezes on Xfce4 in a dual monitor setup
-----------------------------------------------
There is an issue with the Xfce4 compositor that makes OpenLP freeze when using
a dual monitor setup. See configuration of dual monitor for :ref:`xfce4display`
for a solution.

View File

@ -3,7 +3,7 @@
; ;
; Place the script in your gimp scripts folder (eg. ~/.gimp-2.8/scripts) go to the ; Place the script in your gimp scripts folder (eg. ~/.gimp-2.8/scripts) go to the
; folder with images you wish to add shadow to and execute like this: ; folder with images you wish to add shadow to and execute like this:
; gimp --no-data -i -b '(batch-drop-shadow "*.png" 8 8 10)' -b '(gimp-quit 0)' ; gimp --no-data -i -b '(batch-drop-shadow "*.png" 3 3 5)' -b '(gimp-quit 0)'
; ;
(define (batch-drop-shadow pattern (define (batch-drop-shadow pattern