raoul/openlp
1
0
Fork 0
forked from openlp/openlp
Code Issues Pull Requests Projects Releases Wiki Activity

first run wizard

Browse Source
This commit is contained in:
John Cegalis 2011-04-02 15:50:35 -04:00
parent cc49df2c13
commit 4e99237e3a
2 changed files with 133 additions and 87 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

219
documentation/manual/source/faq.rst
View File

@ -1,11 +1,13 @@
======
F.A.Q.
======
====================================
F.A.Q. => Frequently Asked Questions
====================================
General Questions
=================
**What is OpenLP?**
What is OpenLP?
^^^^^^^^^^^^^^^
OpenLP stands for "Open source Lyric Projection" and is presentation software
developed for Churches to provide a single easy to use interface for the
@ -29,23 +31,26 @@ cannot be beaten for value. Still in active development by a growing team of
enthusiastic developers, features are being added all the time, meaning the
software just improves all the time.
**When is the release date for OpenLP 2.0?**
When is the release date for OpenLP 2.0?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
`It will be ready when it's ready!` We do not have fixed dates, but we have
set some [[Version_2_Milestones|targets for the releases]]. If you take part in
the [[Development:Getting_Started|development]], start to
[[Testing:Getting_Started|test OpenLP]] and [[Help:Contents|provide feedback]]
this will speed up the progress.
set some `targets for the releases <http://wiki.openlp.org/Version_2_Milestones>`_.
If you take part in the `development <http://wiki.openlp.org/Development:Getting_Started>`_,
start to `test OpenLP <http://wiki.openlp.org/Testing:Getting_Started>`_ and
`provide feedback <http://wiki.openlp.org/Help:Contents>`_ this will speed up
the progress.
**Can I help with OpenLP?**
Can I help with OpenLP?
^^^^^^^^^^^^^^^^^^^^^^^
OpenLP is possible because of the commitment of individuals. If you would like
to help there are several things that you can get involved with. Please see:
`Contributing <http://openlp.org/en/documentation/introduction/contributing.html>`_
for more information.
**I use and like OpenLP and would like to tell others online. Where can I do
this?**
I use and like OpenLP and would like to tell others online. Where can I do this?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
A variety of places!
@ -57,42 +62,46 @@ A variety of places!
* If you are a member of any Christian Forums or websites, and their rules allow it, then perhaps review the software or ask others to review it.
What operating systems will OpenLP 2.0 support?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
===============================================
OpenLP 2.0 is designed to be cross platform. Currently it has been known to run
on Windows (XP, Vista, 7), Linux (Ubuntu/Kubuntu, Fedora), FreeBSD & Mac OSX.
[[Help:Contents|Please let us know]] if you've successfully run it on something
else.
`Please let us know <http://wiki.openlp.org/Help:Contents>`_ if you've
successfully run it on something else.
**Which programming language is 2.0 developed in?**
Which programming language is 2.0 developed in?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
OpenLP 2.0 is written in `Python <http://www.python.org>`_ and uses the
`Qt4 toolkit <http://qt.nokia.com>`_. Both are cross-platform which allows the
software to run on different types of machine and so allow more people access to
free worship software. Python is one of the easier programming languages to
learn, so this helps us develop and find [[Bug|bugs]] quicker, and also allows
more developers to contribute with the project.
learn, so this helps us develop and `find bugs <http://wiki.openlp.org/Bug#Something_has_gone_wrong.2C_what_should_I_do_to_help_get_it_fixed.3F>`_
quicker, and also allows more developers to contribute with the project.
**Which written languages does OpenLP support?**
Which written languages does OpenLP support?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The beta now has support for a few languages which can be seen on the
:menuselection:`Settings -->Translate` menu. However some of these translations
are incomplete. If you would like to help complete or start to translate OpenLP
into your language then see the [[Translation:Getting_Started|Getting started page]].
into your language then see the `Getting started page <http://wiki.openlp.org/Translation:Getting_Started>`_.
**What is a beta release?**
What is a beta release?
^^^^^^^^^^^^^^^^^^^^^^^
A beta release is a release which is almost feature complete and is fairly
stable. However there may still be a few [[Version_2_Features|features]] to
complete, and [[bugs]] we've not yet fixed. It is used by several people without
serious problems. However there is a small possibility that it could still crash
occasionally or do unexpected things. It is intended for those who want the
latest version, and are prepared to give the program a good test before using it
in a live situation to ensure they won't encounter any unexpected problems. If
you want to have a look at the latest beta release then just
`download it <http://openlp.org/en/download.html>`_.
stable. However there may still be a few `features <http://wiki.openlp.org/Version_2_Features>`_
to complete, and `bugs <https://bugs.launchpad.net/openlp>`_ we've not yet fixed.
It is used by several people without serious problems. However there is a small
possibility that it could still crash occasionally or do unexpected things. It
is intended for those who want the latest version, and are prepared to give the
program a good test before using it in a live situation to ensure they won't
encounter any unexpected problems. If you want to have a look at the latest beta
release then just `download it <http://openlp.org/en/download.html>`_.
**Should I use this beta release at Church in my Sunday services?**
Should I use this beta release at Church in my Sunday services?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
As long as you have taken the time to run through your service a couple of times
on your target machine, the answer to this question is **yes**. The OpenLP
@ -110,9 +119,10 @@ As of beta 1, version 1.2 of OpenLP is "put out to pasture" - no more
development or even bugfixes will be performed on that version.
Upgrading
^^^^^^^^^
=========
**Does 2.0 replace 1.2, or can they be run side by side?**
Does 2.0 replace 1.2, or can they be run side by side?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
It is perfectly safe to install 2.0 on a system with 1.2. Both versions are
installed in separate places, so you can still go back to 1.2. You can even run
@ -121,23 +131,27 @@ them at the same time!
2.0 stores its data in a separate folder to 1.2, so your data is perfectly safe,
and whatever you do in 2.0 will not damage 1.2
**Are 1.2 and 2.0 compatible?**
Are 1.2 and 2.0 compatible?
^^^^^^^^^^^^^^^^^^^^^^^^^^^
No. However imports exist to transfer your data to the new version.
**I have a computer that is quite old, should I upgrade?**
I have a computer that is quite old, should I upgrade?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2.0 does require significantly more resources than v1.2. Therefore if your
computer does not have much memory you may find 2.0 will struggle, `especially`
when changing between slides.
**Why can I not see my 1.2 songs, bibles and themes in 2.0?**
Why can I not see my 1.2 songs, bibles and themes in 2.0?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
This is an beta release, which means it is not finished and one of the things we
haven't completely finished yet is importing 1.2 data automatically. We plan to
do this [[Version_2_Milestones#Version_1.9.6_.28beta_2.29|Version 1.9.6 (beta 2)]].
do this `Version 1.9.6 (beta 2) <http://wiki.openlp.org/Version_2_Milestones#Version_1.9.6_.28beta_2.29>`_.
**How do I transfer my 1.2 song database?**
How do I transfer my 1.2 song database?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
In OpenLP v2, go to the :menuselection:`File --> Import --> Song` menu.
In the Wizard that appears, click Next and choose "openlp.org v1.x" from the
@ -151,7 +165,8 @@ the wizard).`
Click Open, then in the wizard just click Next and wait for the import to complete.
**How do I transfer my 1.2 Bibles?**
How do I transfer my 1.2 Bibles?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
In OpenLP v2, go to the :menuselection:`File --> Import --> Bible` menu.
In the Wizard that appears, click Next and choose "openlp.org v1.x" from the
@ -167,14 +182,16 @@ the wizard).`
Choose the Bible, Click Open, then in the wizard just click Next, enter the
License details, and wait for the import to complete.
**How do I transfer my 1.2 Themes?**
How do I transfer my 1.2 Themes?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
In openlp.org v1, export each theme by selecting it in the Theme Manager, and
then clicking the picture of a blue folder with red arrow on the Theme Managers
toolbox. This theme file can then be imported into V2 using the
:menuselection:`File --> Import --> Theme` menu.
**I can't get my 2.0 theme to look the same as 1.2**
I can't get my 2.0 theme to look the same as 1.2
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
OpenLP 2.0 is a complete rewrite using a completely different programming
language so it would work on different types of system. There are differences in
@ -182,9 +199,10 @@ how the old and new languages draw text on the screen, and therefore it is
unlikely you'll get an exact match.
Using OpenLP
^^^^^^^^^^^^
============
**Is there a manual or any documentation for 2.0?**
Is there a manual or any documentation for 2.0?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Some folks are working on a brand new manual for OpenLP 2.0. You can find the
latest version of this manual at http://manual.openlp.org. If you need help,
@ -192,28 +210,32 @@ use the live chat feature or ask in the forums. If you would like to help write
the manual, please let us know - we are always happy for new volunteers to join
the team and contribute to the project.
**I've started OpenLP, but I can't see the songs or bibles section in the Media Manager**
I've started OpenLP, but I can't see the songs or bibles section in the Media Manager
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
When you installed OpenLP, the first time wizard would have asked which plugins
you wanted, and songs and bibles should have been selected. If for some reason
they were not, then you will need to activate them yourself. See
[[#How do I activate / deactivate a plugin?|How do I activate / deactivate a plugin]]
`How do I activate / deactivate a plugin <http://wiki.openlp.org/Bug#How_do_I_activate_.2F_deactivate_a_plugin.3F>`_
for instructions.
**How do I activate / deactivate a plugin?**
How do I activate / deactivate a plugin?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Plugins can be turned on and off from the Plugin List Screen. Select the plugin
you wish to start/stop and change it's status. You should not need to restart
OpenLP.
**What are these plugins that I keep seeing mentioned?**
What are these plugins that I keep seeing mentioned?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The plugins allow OpenLP to be extend easily. A number have been written
(Songs, Bibles, Presentations) etc but it is possible for the application to be
extended with functionality only you require. If this is the case then go for
it but lets us know as we can help and it may be something someone else wants.
**How do I enable PowerPoint/Impress/PowerPoint Viewer?**
How do I enable PowerPoint/Impress/PowerPoint Viewer?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
First of all ensure that the presentation plugin is enabled (see above).
Then to enable a presentation application, go to the `Settings` dialog, switch
@ -223,13 +245,11 @@ appropriate checkbox(es). Check the applications you require, and then restart
OpenLP for the change to be detected.
Note, PowerPoint Viewer 2010 is not yet supported, use 2003 or 2007.
See also [[OpenLP_2_Introduction_and_FAQ#I.27m_on_Windows_and_PowerPoint_is_
installed.2C_but_it_doesn.27t_appear_as_an_option|I'm on Windows and PowerPoint
is installed, but it doesn't appear as an option]]
and [[#Why_is_there_no_presentations_plugin_available_on_OS_X.3F|Why is there no
presentations plugin available on OS X?]]
See also `I'm on Windows and PowerPoint is installed, but it doesn't appear as an option <http://wiki.openlp.org/OpenLP_2_Introduction_and_FAQ#I.27m_on_Windows_and_PowerPoint_is_installed.2C_but_it_doesn.27t_appear_as_an_option>`_
and `Why is there no presentations plugin available on OS X? <http://wiki.openlp.org/OpenLP_2_Introduction_and_FAQ#Why_is_there_no_presentations_plugin_available_on_OS_X.3F>`_
**Why is there no presentations plugin available on OS X?**
Why is there no presentations plugin available on OS X?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Currently the presentations plugin is not bundled with OpenLP on OS X. The
reason for that is that the OpenOffice.org version on Mac OS X does not contain
@ -238,7 +258,8 @@ called pyuno bridge) which could be used by OpenLP. As soon as the
interoperability component works on OS X we can re-enable the plugin and bundle
it. We are really sorry for that.
**Is it possible to get Bible x? How?**
Is it possible to get Bible x? How?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The Bible plugin has a much improved `Import Wizard` which can import Bibles
from a variety of sources. The following sources are supported:
@ -263,7 +284,10 @@ from a variety of sources. The following sources are supported:
* `BibleGateway <http://www.biblegateway.com/versions/>`_
**Why do my Bible verses take a long time to load?**
* `BibleServer <http://www.bibleserver.com>`_
Why do my Bible verses take a long time to load?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
In order to better conform to copyright law, the Web Download Bibles are not
downloaded when you import them, but on the fly as you search for them. As a
@ -271,8 +295,8 @@ result, the search takes a little longer if you need to download those
particular verses. Having said that, the Web Download Bibles cache downloaded
verses so that you don't need to download them again.
**My Bible is on the Web Download sites, but my Church isn't on the internet.
What options do I have?**
My Bible is on the Web Download sites, but my Church isn't on the internet. What options do I have?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
When you create and save a service, all the items in the service are saved with
it. That means any images, presentations, songs and media items are saved. This
@ -282,9 +306,10 @@ service using your church computer and voila, the bible passage should be there!
Note this can also be done with songs, etc!
(Advanced) Where do I find the configuration file?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
==================================================
**Linux, FreeBSD & PC-BSD**
Linux, FreeBSD & PC-BSD
^^^^^^^^^^^^^^^^^^^^^^^
If your distribution supports the XDG standard, you'll find OpenLP's
configuration file in::
@ -295,14 +320,16 @@ If that file and/or directory does not exist, look for::
/home/<user>/.openlp/openlp.conf
**OS X**
OS X
^^^^
You'll find your configuration file here::
/Users/<user>/Library/Preferences/com.openlp.OpenLP.plist
/Users/<user>/Library/Preferences/org.openlp.OpenLP.plist
**Windows**
Windows
^^^^^^^
On Windows, OpenLP does not use a configuration file, it uses the Windows
registry. You can find the settings here::
@ -310,9 +337,10 @@ registry. You can find the settings here::
HKEY_CURRENT_USER\Software\OpenLP\OpenLP
Troubleshooting
^^^^^^^^^^^^^^^
===============
**Something has gone wrong, what should I do to help get it fixed?**
Something has gone wrong, what should I do to help get it fixed?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
If you have found an error in the program (what we call a bug) you should report
this to us so that OpenLP can be improved. Before reporting any bugs please
@ -331,7 +359,7 @@ please post a new bug report.
#. If none of these ways suits you, you can send an email to bugs (at) openlp.org.
What information should I include in a bug report?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
==================================================
* Operating System
@ -347,7 +375,8 @@ What information should I include in a bug report?
The more information you give us, the better we can help you.
**I've been asked to email a debug log, where do I find this?**
I've been asked to email a debug log, where do I find this?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
We may need a debug log to help pin-point the issue. A new log file is created
each time you start OpenLP so copy the file before you run the software a second
@ -361,7 +390,8 @@ file in a text editor (such as notepad on Windows) and copy and paste the
contents into somewhere like `pastebin.com <http://pastebin.com>`_. Then give us
the link to the page that is created.
**Windows**
Windows
^^^^^^^
Find the OpenLP 2.0 folder in your Start menu. Choose the "OpenLP (Debug)" option.
@ -375,7 +405,8 @@ and then close down OpenLP.
In the Explorer window you left open, navigate up one level into the openlp
folder. You will see the <code>openlp.log</code> file. This is the file to e-mail.
**Linux**
Linux
^^^^^
If you installed OpenLP from a package::
@ -393,7 +424,8 @@ Otherwise, you'll find the log file in::
~/.openlp/openlp.log
**Mac OS X**
Mac OS X
^^^^^^^^
Open Terminal.app and navigate to where you installed OpenLP, usually
<code>/Applications</code>::
@ -415,12 +447,13 @@ directory::
/Users/<username>/Library/Application Support/openlp/openlp.log
**I'm on Windows and PowerPoint is installed, but it doesn't appear as an
option**
I'm on Windows and PowerPoint is installed, but it doesn't appear as an option
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Try installing the `Visual C++ Runtime Redistributable <http://www.microsoft.com/downloads/details.aspx?FamilyID=9b2da534-3e03-4391-8a4d-074b9f2bc1bf&displaylang=en>`_.
**The command line shows many error messages**
The command line shows many error messages
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
When running OpenLP from the command line, you might get something like this::
@ -435,7 +468,8 @@ When running OpenLP from the command line, you might get something like this::
These error messages indicate that you need to install an appropriate backend
for Phonon.
**Linux/FreeBSD**
Linux/FreeBSD
^^^^^^^^^^^^^
If you're using Gnome, you need to install the GStreamer backend for Phonon. On
Ubuntu you would install the <code>phonon-backend-gstreamer</code> package::
@ -452,37 +486,44 @@ backend.
phonon-backend-vlc may also be worth trying on some systems.
**Windows & Mac OS X**
Windows & Mac OS X
^^^^^^^^^^^^^^^^^^
Phonon should already be set up properly. If you're still having issues, let the
developers know.
**I've upgraded from 1.9.2 to a newer version, and now OpenLP crashes at start**
I've upgraded from 1.9.2 to a newer version, and now OpenLP crashes at start
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
You need to upgrade your song database.
See this `blog post <http://openlp.org/en/users/jt/blog/2010-07-20-flag_day_database_schema_changes_in_trunk_revision_956.html>`_ for information on how to do this.
**I've upgraded to 1.9.5, and now OpenLP has duplicates of many songs in the Media Manager**
I've upgraded to 1.9.5, and now OpenLP has duplicates of many songs in the Media Manager
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
You need to run the :menuselection:`Tools --> Re-index Songs`.
**There are no menu icons in OpenLP**
There are no menu icons in OpenLP
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
This may affect (only) linux users with xfce. To solve the problem, follow the
description `here <https://bugs.launchpad.net/ubuntu/+source/qt4-x11/+bug/501468/comments/3>`_.
**JPG images don't work**
JPG images don't work
^^^^^^^^^^^^^^^^^^^^^
This is a known issue on some Mac OS X 10.5 systems, and has also been seen on
Windows XP too. The solution is to convert the image into another format such as
PNG.
**MP3's and other audio formats don't work**
MP3's and other audio formats don't work
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
This is a known issue on some systems, including some XP machines, and we have
no solution at the moment.
**Videos can be slow or pixelated. Background Videos are very slow**
Videos can be slow or pixelated. Background Videos are very slow
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
If playing video by themselves, try selecting the
:menuselection:`Settings --> Configure OpenLP --> Media`, Use Phonon for Video
@ -492,27 +533,31 @@ help. We are hoping a future release of the toolkit we are using (QtWebKit) will
help improve this, but there is no timeframe at present.
Features
^^^^^^^^
========
**What new features will I find in v2?**
What new features will I find in v2?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Since v2 was a rewrite from the ground up, you won't find a great deal of new
features since initially we want to ensure all the v1.2 features are included.
However the developers have managed to sneak a few in. Take a look at the
[[Version 2 Features|Complete list]].
`Complete list <http://wiki.openlp.org/Version_2_Features>`_.
**Why hasn't popular feature request X been implemented?**
Why hasn't popular feature request X been implemented?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
We made a decision to first implement v1.2 features, before going wild on new
features. There are only a handful of developers working in their spare time. If
we were to try and include everything we wanted to implement, then v2 would not
likely ever get released.
**I have a great idea for a new feature, where should I suggest it?**
I have a great idea for a new feature, where should I suggest it?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
First of all check it isn't on the [[Feature Requests|Feature Requests]] page.
If it is, then you need to say no more, it's already been suggested! If it isn't
on the list, then head to the `feature request forum <http://openlp.org/en/forums/openlp_20/feature_requests.html>`_
First of all check it isn't on the `Feature Requests <http://wiki.openlp.org/Feature_Requests>`_
page. If it is, then you need to say no more, it's already been suggested! If it
isn't on the list, then head to the
`feature request forum <http://openlp.org/en/forums/openlp_20/feature_requests.html>`_
and post the idea there.
`Help <http://wiki.openlp.org/Help:Contents>`_

1
documentation/manual/source/index.rst
View File

@ -21,4 +21,5 @@ Contents:
mediamanager
songs
alert
faq
troubleshooting