forked from openlp/openlp
further corrections to troubleshooting.rst
This commit is contained in:
Wesley Stout
commit
af17cbc8c2
57
documentation/manual/source/alert.rst
Normal file
57
documentation/manual/source/alert.rst
Normal file
@ -0,0 +1,57 @@
|
||||
=====
|
||||
Alert
|
||||
=====
|
||||
|
||||
From time to time it may be necessary to display a small unobtrusive message to
|
||||
the congregation. In OpenLP this is known as an `Alert`. Examples could be a car
|
||||
with the headlights left on, a parent needed in nursery, or anything else
|
||||
somebody may need notified about. This is easily accomplished using the Alert,
|
||||
which is accessible from the top Menu under :menuselection:`Tools --> Alert`.
|
||||
|
||||
.. image:: pics/alert.png
|
||||
|
||||
:guilabel:`Alert text:` Enter the message you want displayed in this box.
|
||||
|
||||
:guilabel:`Parameter:` This box is used for words you want to insert into the
|
||||
alert text.
|
||||
|
||||
You will add the Parameter text into the alert text using “<>” (without
|
||||
quotations). Anywhere in the Alert text that you add these two symbols, <> side
|
||||
by side, will insert any text you have in the parameter box into the Alert
|
||||
message.
|
||||
|
||||
Examples of use
|
||||
---------------
|
||||
|
||||
:guilabel:`Alert text:` The owner of the vehicle with license plate number <>
|
||||
your lights are on.
|
||||
|
||||
:guilabel:`Parameter:` HNN432
|
||||
|
||||
These two settings will display like this:
|
||||
|
||||
The owner of the vehicle with the license plate number HNN432 your lights are on.
|
||||
|
||||
You could also reverse this example:
|
||||
|
||||
:guilabel:`Alert text:` HNN432 <>
|
||||
|
||||
:guilabel:`Parameter:` left their lights on.
|
||||
|
||||
`Will display like this:` HNN432 left their lights on.
|
||||
|
||||
If you use the same alerts on a regular basis, Save your Alert and you will have
|
||||
access to the alert with a click of the mouse. You may also click on `New` to
|
||||
make a new alert or `Delete` an alert you do not need.
|
||||
|
||||
When you are ready to Display your Alert you have two options. Clicking on
|
||||
Display will display the Alert and the Alert Message window will remain open.
|
||||
Clicking Display & Close will display the alert and close the Alert Message
|
||||
window.
|
||||
|
||||
All details of the display, font, color, size and position are adjusted from the
|
||||
top Menu item :menuselection:`Settings --> Configure OpenLP`, Alert tab and the
|
||||
instructions here. :doc:`configure`
|
||||
|
||||
**Please note:** Alert Message is a Plugin that needs to be Active in the Plugin
|
||||
List for use.
|
||||
598
documentation/manual/source/faq.rst
Normal file
598
documentation/manual/source/faq.rst
Normal file
@ -0,0 +1,598 @@
|
||||
==========================
|
||||
Frequently Asked Questions
|
||||
==========================
|
||||
|
||||
General Questions
|
||||
=================
|
||||
|
||||
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
|
||||
projection needs of a typical act of Worship. First created in 2004, it has
|
||||
steadily grown in features and maturity such that is it now a mainstay in
|
||||
hundreds of churches around the world.
|
||||
|
||||
It can hold a searchable database of song lyrics and Bible verses allowing them
|
||||
to be projected instantly or saved in a pre-prepared order of service file.
|
||||
Themes allow song backgrounds to be changed instantly. PowerPoint presentations,
|
||||
videos and audio files can be run from within the program removing the need to
|
||||
switch between different programs. Alert messages can be displayed so the
|
||||
Nursery or Car park stewards can notify the congregation easily. Remote
|
||||
capability allows the worship leader to change songs, or for alert messages to
|
||||
be sent from anywhere on the network, even via a phone.
|
||||
|
||||
Being free, this software can be installed on as many computers as required,
|
||||
even on the home computers of worship leaders without additional cost. Compared
|
||||
to the expensive site licenses or restrictions of commercial software we believe
|
||||
OpenLP 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?
|
||||
----------------------------------------
|
||||
|
||||
*It will be ready when it's ready!* We do not have fixed dates, but we have
|
||||
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?
|
||||
-----------------------
|
||||
|
||||
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?
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
A variety of places!
|
||||
|
||||
* Are you on facebook? Then `become a fan <http://www.facebook.com/openlp>`_
|
||||
* Are you on twitter? Then `follow openlp <http://twitter.com/openlp>`_, and
|
||||
retweet the announcements.
|
||||
* Give us a thumbs up on the
|
||||
`SourceForge project page <http://www.sourceforge.net/projects/openlp>`_
|
||||
* If you have a website or blog, then link to our site http://www.openlp.org
|
||||
with a few words saying what the software is and why you like it.
|
||||
* Add a placemark on our `Worldwide Usage map <http://maps.google.com/maps/ms?ie=UTF8&source=embed&msa=0&msid=113314234297482809599.00047e88b1985e07ad495&ll=13.923404,0&spn=155.179835,316.054688&z=2>`_,
|
||||
so others in your locality can see someone close by is using it.
|
||||
* 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.
|
||||
`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?
|
||||
-----------------------------------------------
|
||||
|
||||
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 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?
|
||||
--------------------------------------------
|
||||
|
||||
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 `Getting started page <http://wiki.openlp.org/Translation:Getting_Started>`_.
|
||||
|
||||
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 `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?
|
||||
---------------------------------------------------------------
|
||||
|
||||
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
|
||||
team believes that OpenLP 2.0 beta 1 is stable enough to be used in Sunday
|
||||
services. As of beta 1, there are a good number of churches already using
|
||||
version 2.0 successfully. The OpenLP team works hard to make sure each release
|
||||
is solid, but cannot yet guarantee that everything works perfectly, or even
|
||||
correctly.
|
||||
|
||||
If however your congregation is made up of 85 year old women who snarl when you
|
||||
suggest replacing the gas lamps with electric light bulbs and consider the pipe
|
||||
organ too loud and modern, then we recommend sticking with version 1.2 for now.
|
||||
|
||||
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?
|
||||
------------------------------------------------------
|
||||
|
||||
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
|
||||
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?
|
||||
---------------------------
|
||||
|
||||
No. However imports exist to transfer your data to the new version.
|
||||
|
||||
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?
|
||||
---------------------------------------------------------
|
||||
|
||||
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 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?
|
||||
---------------------------------------
|
||||
|
||||
In OpenLP 2.0, go to the :menuselection:`File --> Import --> Song` menu.
|
||||
In the Wizard that appears, click Next and choose "openlp.org v1.x" from the
|
||||
Format list. Click the search button on the Filename prompt, and at the bottom
|
||||
of the dialog, copy the following into the File name prompt::
|
||||
|
||||
%ALLUSERSPROFILE%\Application Data\openlp.org\Data\songs.olp
|
||||
|
||||
*(This must be in the popup file chooser dialog. Don't enter it directly into
|
||||
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?
|
||||
--------------------------------
|
||||
|
||||
In OpenLP 2.0, go to the :menuselection:`File --> Import --> Bible` menu.
|
||||
In the Wizard that appears, click Next and choose "openlp.org v1.x" from the
|
||||
Format list.
|
||||
Click the search button on the Filename prompt, and at the bottom of the dialog,
|
||||
copy the following into the File name prompt::
|
||||
|
||||
%ALLUSERSPROFILE%\Application Data\openlp.org\Data\Bibles
|
||||
|
||||
*(This must be in the popup file chooser dialog. Don't enter it directly into
|
||||
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?
|
||||
--------------------------------
|
||||
|
||||
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
|
||||
------------------------------------------------
|
||||
|
||||
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
|
||||
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?
|
||||
-----------------------------------------------
|
||||
|
||||
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,
|
||||
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
|
||||
-------------------------------------------------------------------------------------
|
||||
|
||||
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 <http://wiki.openlp.org/Bug#How_do_I_activate_.2F_deactivate_a_plugin.3F>`_
|
||||
for instructions.
|
||||
|
||||
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?
|
||||
----------------------------------------------------
|
||||
|
||||
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?
|
||||
-----------------------------------------------------
|
||||
|
||||
First of all ensure that the presentation plugin is enabled (see above).
|
||||
Then to enable a presentation application, go to the `Settings` dialog, switch
|
||||
to the `Presentations` tab and check one of the enabled checkboxes. OpenLP will
|
||||
automatically detect which of the three you have installed, and enable the
|
||||
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 `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?
|
||||
-------------------------------------------------------
|
||||
|
||||
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
|
||||
the (more exact: does only contain a broken) interoperability component (the so
|
||||
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?
|
||||
-----------------------------------
|
||||
|
||||
The Bible plugin has a much improved `Import Wizard` which can import Bibles
|
||||
from a variety of sources. The following sources are supported:
|
||||
|
||||
CSV
|
||||
The same format as documented for `openlp.org 1.x <http://www.openlp.org/en/documentation/importing_exporting_data/bibles/importing_comma_delimited_files.html>`_.
|
||||
|
||||
OSIS
|
||||
An XML format for Bible. You can export Bibles from the `Sword Project <http://www.crosswire.org/sword/software/>`_
|
||||
into OSIS using the ``mod2osis`` tool. After using the Sword software Media
|
||||
Manager (or other Sword frontend, like BibleTime or Xiphos) to download the
|
||||
required Bible, run the following command from the command line (works on
|
||||
Windows and Linux)::
|
||||
|
||||
mod2osis <name> > <name>.osis
|
||||
|
||||
The ``<name>`` parameter is the name of your Bible, as you see it in Sword.
|
||||
Note that the ``<name>`` is case sensitive on all environments. Once you
|
||||
have exported your Bible to OSIS, the Bible import wizard will the read
|
||||
``<name>.osis`` file and import your Bible.
|
||||
|
||||
OpenSong
|
||||
OpenSong have a good selection of Bibles on their
|
||||
`download page <http://www.opensong.org/d/downloads#bible_translations>`_.
|
||||
|
||||
Web Download
|
||||
OpenLP can download Bibles on demand from the following 3 sites:
|
||||
|
||||
* `Crosswalk <http://biblestudy.crosswalk.com/bibles/>`_
|
||||
* `BibleGateway <http://www.biblegateway.com/versions/>`_
|
||||
* `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
|
||||
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?
|
||||
---------------------------------------------------------------------------------------------------
|
||||
|
||||
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
|
||||
is also true for bibles. What this means is you can create the service on your
|
||||
home computer, insert a Bible passage from the web, save it and then open the
|
||||
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
|
||||
-----------------------
|
||||
|
||||
If your distribution supports the XDG standard, you'll find OpenLP's
|
||||
configuration file in::
|
||||
|
||||
/home/<user>/.config/OpenLP/OpenLP.conf
|
||||
|
||||
If that file and/or directory does not exist, look for::
|
||||
|
||||
/home/<user>/.openlp/openlp.conf
|
||||
|
||||
``<user>`` is your username.
|
||||
|
||||
OS X
|
||||
----
|
||||
|
||||
You'll find your configuration file here::
|
||||
|
||||
/Users/<user>/Library/Preferences/org.openlp.OpenLP.plist
|
||||
|
||||
``<user>`` is your username.
|
||||
|
||||
Windows
|
||||
-------
|
||||
|
||||
On Windows, OpenLP does not use a configuration file, it uses the Windows
|
||||
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?
|
||||
----------------------------------------------------------------
|
||||
|
||||
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
|
||||
first make sure that there isn't already a bug report about your problem:
|
||||
|
||||
#. Check the `Launchpad bug list <https://bugs.launchpad.net/openlp>`_
|
||||
#. `OpenLP support System <http://www.support.openlp.org/projects/openlp>`_
|
||||
#. Check the `bug reports <http://openlp.org/en/forums/openlp_20/bug_reports.html>`_ forum
|
||||
|
||||
If there **is already a bug report**, you may be able to help by providing
|
||||
further information. However, **if no one else has reported** it yet, then
|
||||
please post a new bug report.
|
||||
|
||||
#. The **preferred place** for reporting bugs is the
|
||||
`bugs list <https://bugs.launchpad.net/openlp>`_ on Launchpad.
|
||||
#. Alternatively, if you don't have a Launchpad account and don't want to sign
|
||||
up for one, you can post in the
|
||||
`bug reports forum <http://openlp.org/en/forums/openlp_20/bug_reports.html>`_.
|
||||
#. 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?
|
||||
==================================================
|
||||
|
||||
Since OpenLP 1.9.4, there is a bug report dialog which automatically opens when
|
||||
OpenLP hits a serious bug. However, this doesn't appear all the time, and in
|
||||
some behavioural bugs, you'll have to file a bug report yourself. The following
|
||||
items are information the developers need in order to reproduce the bug.
|
||||
|
||||
Operating System
|
||||
Include information such as the version of your operating system, the
|
||||
distribution (e.g. Ubuntu, Fedora, etc.) if you're using Linux, or the
|
||||
edition (e.g. Home, Basic, Business, etc.) if you're using Windows.
|
||||
|
||||
Version of OpenLP
|
||||
You can find out the version of OpenLP by going to :menuselection:`Help --> About`
|
||||
|
||||
Steps to Reproduce
|
||||
The exact steps the developers need to follow in order to reproduce the bug.
|
||||
|
||||
Version of MS Office or OpenOffice
|
||||
If you're using the song imports or the presentation plugin, you'll need to
|
||||
supply the version of Office, OpenOffice.org or LibreOffice.
|
||||
|
||||
Bible Translation and Source
|
||||
If the bug occurred while you were working with Bibles, specify the
|
||||
translation of the Bible, and the source format if you imported it yourself.
|
||||
|
||||
**Any** Other Information
|
||||
Often bugs are caused by something that might not seem to be directly
|
||||
related to the bug itself. If you have any other information with regards to
|
||||
actions you performed or other activities when the bug occurred, it would be
|
||||
welcomed by the developers.
|
||||
|
||||
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?
|
||||
-----------------------------------------------------------
|
||||
|
||||
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
|
||||
time. On Windows a Debug option is available in the start menu. On other systems,
|
||||
you will need to run OpenLP from the command line, with the following
|
||||
option: ```-l debug```. Please note, that is a lowercase **L**.
|
||||
|
||||
If you haven't been given a specific email address to send it to, then please do
|
||||
not paste the log contents straight into a forum post. Instead, open the log
|
||||
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
|
||||
^^^^^^^
|
||||
|
||||
Find the OpenLP 2.0 folder in your Start menu. Choose the "OpenLP (Debug)" option.
|
||||
|
||||
OpenLP will start up. Go to the :menuselection:`Tools --> Open Data Folder` menu
|
||||
option, and an Explorer window will appear containing folders such as alerts,
|
||||
bibles, custom etc. Keep this Explorer window open.
|
||||
|
||||
Now repeat the steps you need to take in OpenLP to reproduce the problem you had,
|
||||
and then close down OpenLP.
|
||||
|
||||
In the Explorer window you left open, navigate up one level into the openlp
|
||||
folder. You will see the ``openlp.log`` file. This is the file to e-mail.
|
||||
|
||||
Linux/FreeBSD
|
||||
^^^^^^^^^^^^^
|
||||
|
||||
If you installed OpenLP from a package::
|
||||
|
||||
@:~$ openlp -l debug
|
||||
|
||||
Alternately, if you're running OpenLP from source::
|
||||
|
||||
@:~$ ./openlp.pyw -l debug
|
||||
|
||||
If your Linux distribution supports the XDG standard, you'll find the log in::
|
||||
|
||||
~/.cache/openlp/openlp.log
|
||||
|
||||
Otherwise, you'll find the log file in::
|
||||
|
||||
~/.openlp/openlp.log
|
||||
|
||||
Mac OS X
|
||||
^^^^^^^^
|
||||
|
||||
Open Terminal.app and navigate to where you installed OpenLP, usually
|
||||
``/Applications``::
|
||||
|
||||
@:~$ cd /Applications
|
||||
|
||||
Then go into the OpenLP.app directory, down to the OpenLP executable::
|
||||
|
||||
@:~$ cd OpenLP.app/Contents/MacOS
|
||||
|
||||
And then run OpenLP in debug mode::
|
||||
|
||||
@:~$ ./openlp -l debug
|
||||
|
||||
Once you've done that, you need to get the log file. In your home directory,
|
||||
open the Library directory, and the Application Support directory within that.
|
||||
Then open the openlp directory, and you should find the openlp.log file in that
|
||||
directory::
|
||||
|
||||
/Users/<username>/Library/Application Support/openlp/openlp.log
|
||||
|
||||
``<username>`` is your username.
|
||||
|
||||
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
|
||||
------------------------------------------
|
||||
|
||||
When running OpenLP from the command line, you might get something like this::
|
||||
|
||||
WARNING: bool Phonon::FactoryPrivate::createBackend() phonon backend plugin could not be loaded
|
||||
WARNING: bool Phonon::FactoryPrivate::createBackend() phonon backend plugin could not be loaded
|
||||
WARNING: Phonon::createPath: Cannot connect Phonon::MediaObject ( no objectName ) to VideoDisplay ( no objectName ).
|
||||
WARNING: Phonon::createPath: Cannot connect Phonon::MediaObject ( no objectName ) to Phonon::AudioOutput ( no objectName ).
|
||||
WARNING: bool Phonon::FactoryPrivate::createBackend() phonon backend plugin could not be loaded
|
||||
|
||||
These error messages indicate that you need to install an appropriate backend
|
||||
for Phonon.
|
||||
|
||||
Linux/FreeBSD
|
||||
^^^^^^^^^^^^^
|
||||
|
||||
If you're using Gnome, you need to install the GStreamer backend for Phonon. On
|
||||
Ubuntu you would install the ```phonon-backend-gstreamer``` package::
|
||||
|
||||
@:~$ sudo aptitude install phonon-backend-gstreamer
|
||||
|
||||
If you're using KDE, you need to install the Xine backend for Phonon. On Kubuntu
|
||||
you would install the ```phonon-backend-xine``` package::
|
||||
|
||||
@:~$ sudo aptitude install phonon-backend-xine
|
||||
|
||||
If you know which audiovisual system you're using, then install the appropriate
|
||||
backend.
|
||||
|
||||
phonon-backend-vlc may also be worth trying on some systems.
|
||||
|
||||
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 on load
|
||||
---------------------------------------------------------------------------
|
||||
|
||||
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
|
||||
----------------------------------------------------------------------------------------
|
||||
|
||||
You need to run :menuselection:`Tools --> Re-index Songs`.
|
||||
|
||||
There are no menu icons in OpenLP
|
||||
---------------------------------
|
||||
|
||||
This may affect (only) Linux users with XFCE or Gnome. To solve the problem,
|
||||
follow the instructions on `this bug report <https://bugs.launchpad.net/ubuntu/+source/qt4-x11/+bug/501468/comments/3>`_.
|
||||
|
||||
JPEG 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
|
||||
----------------------------------------
|
||||
|
||||
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
|
||||
----------------------------------------------------------------
|
||||
|
||||
If you are just playing videos from the Media plugin, try selecting the
|
||||
:guilabel:`Use Phonon for Video playback` option in the Media configuration,
|
||||
accessible by going to :menuselection:`Settings --> Configure OpenLP --> Media`.
|
||||
As for text over video, we have no solution for speeding this up. Reducing the
|
||||
monitor resolution and avoiding shadows and outline text will 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 2.0?
|
||||
-------------------------------------
|
||||
|
||||
Since 2.0 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 1.2 features are included.
|
||||
However the developers have managed to sneak a few in. Take a look at the
|
||||
`complete list <http://wiki.openlp.org/Version_2_Features>`_.
|
||||
|
||||
Why hasn't popular feature request X been implemented?
|
||||
------------------------------------------------------
|
||||
|
||||
We made a decision to first implement 1.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 2.0 would not
|
||||
likely ever get released.
|
||||
|
||||
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 <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.
|
||||
@ -13,10 +13,13 @@ Contents:
|
||||
|
||||
introduction
|
||||
glossary
|
||||
wizard
|
||||
dualmonitors
|
||||
configure
|
||||
bibles
|
||||
themes
|
||||
mediamanager
|
||||
songs
|
||||
alert
|
||||
faq
|
||||
troubleshooting
|
||||
|
||||
@ -99,6 +99,7 @@ You will type your search query in this box for the following two searches.
|
||||
Book Chapter
|
||||
Book Chapter-Chapter
|
||||
Book Chapter:Verse-Verse
|
||||
Book Chapter:Verse-End (this will display verses to the end of the chapter)
|
||||
Book Chapter:Verse-Verse, Verse-Verse
|
||||
Book Chapter:Verse-Verse,Chapter:Verse-Verse
|
||||
Book Chapter:Verse-Chapter:Verse
|
||||
|
||||
BIN
documentation/manual/source/pics/001-first-time-language.png
Normal file
BIN
documentation/manual/source/pics/001-first-time-language.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 15 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 111 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 30 KiB |
BIN
documentation/manual/source/pics/004-first-time-wizard-songs.png
Normal file
BIN
documentation/manual/source/pics/004-first-time-wizard-songs.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 17 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 35 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 113 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 24 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 18 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 19 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 5.4 KiB |
BIN
documentation/manual/source/pics/012-openlp-main-window.png
Normal file
BIN
documentation/manual/source/pics/012-openlp-main-window.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 138 KiB |
BIN
documentation/manual/source/pics/alert.png
Normal file
BIN
documentation/manual/source/pics/alert.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 17 KiB |
@ -160,8 +160,8 @@ format. We would suggest using PNG images when possible with OpenLP.
|
||||
I am running a Linux Distro and can not see the menus
|
||||
-----------------------------------------------------
|
||||
|
||||
This only seems to be a problem with only XFCE the following commands have been
|
||||
known to resolve the problem::
|
||||
This seems to be a problem with XFCE and some versions of Gnome too. To correct
|
||||
this problem, open a terminal and type in the following commands::
|
||||
|
||||
gconftool-2 --type boolean --set /desktop/gnome/interface/buttons_have_icons true
|
||||
|
||||
@ -172,6 +172,5 @@ I chose to use a web Bible but it did not download the entire Bible
|
||||
|
||||
Due to copyright restrictions OpenLP cannot download an entire Bible. It can
|
||||
only download the section you search for. If you do not have an internet
|
||||
connection where you intend to use OpenLP you will need to have another source
|
||||
for scripture. For more information and options on acquiring bibles please see
|
||||
:ref:`bibleimporter`.
|
||||
connection where you intend to use OpenLP you will need another scripture
|
||||
source. For more information about acquiring bibles please see :ref:`bibleimporter`.
|
||||
|
||||
102
documentation/manual/source/wizard.rst
Normal file
102
documentation/manual/source/wizard.rst
Normal file
@ -0,0 +1,102 @@
|
||||
================
|
||||
First Run Wizard
|
||||
================
|
||||
|
||||
When using OpenLP for the first time, the **First Run Wizard** will help you
|
||||
with setting up your installation. This wizard is not intended to be a
|
||||
comprehensive setup but will help you with the basics.
|
||||
|
||||
Select Translation
|
||||
------------------
|
||||
|
||||
.. image:: pics/001-first-time-language.png
|
||||
|
||||
You can choose the translation you want to use or let OpenLP
|
||||
automatically select it based on your operating system locale. Click
|
||||
:guilabel:`OK` to continue.
|
||||
|
||||
The "Welcome to the First Time Wizard" dialog box will appear next. Click
|
||||
:guilabel:`Next`.
|
||||
|
||||
.. image:: pics/002-first-time-wizard-welcome.png
|
||||
|
||||
Activate required Plugins
|
||||
-------------------------
|
||||
|
||||
.. image:: pics/003-first-time-wizard-plugins.png
|
||||
|
||||
OpenLP has several plugins to choose from. By default, all plugins are enabled,
|
||||
except the *Remote Access* plugin. For more information on these plugins, please
|
||||
read the :doc:`mediamanager` section in the manual. If you are not sure of which
|
||||
plugins to enable or disable, leave the selection as is. You can easily activate
|
||||
or deactivate plugins later, when OpenLP is running, by going to
|
||||
:menuselection:`Settings --> Plugin List`. Click :guilabel:`Next` to continue.
|
||||
|
||||
Sample Songs
|
||||
------------
|
||||
|
||||
.. image:: pics/004-first-time-wizard-songs.png
|
||||
|
||||
OpenLP provides some sample songs in a few languages for downloading and
|
||||
importing into your new song database. This is convenient for new users who do
|
||||
not have any songs yet. If you already have songs in your database, OpenLP will
|
||||
simply add these sample songs to your database, leaving your existing songs
|
||||
intact. Once you are happy with which songs you'd like, click :guilabel:`Next`.
|
||||
|
||||
Sample Bibles
|
||||
-------------
|
||||
|
||||
.. image:: pics/005-first-time-wizard-bibles.png
|
||||
|
||||
There are also a number of free Bibles that you can download and install. Using
|
||||
the check box next to each Bible, select each Bible that you would like
|
||||
installed. If you do not wish to install any Bibles, simply leave them all
|
||||
unchecked. Once you are happy with your selection, click :guilabel:`Next` to
|
||||
continue.
|
||||
|
||||
Sample Themes
|
||||
-------------
|
||||
|
||||
.. image:: pics/006-first-time-wizard-themes.png
|
||||
|
||||
Some sample themes are also available for download and installation into OpenLP.
|
||||
As with the Bibles, simply check the check box next to each theme to select it.
|
||||
If you are a new user, these themes can help you understand how themes work. If
|
||||
you are happy with your selected themes, click :guilabel:`Next` to continue.
|
||||
|
||||
Default Settings
|
||||
----------------
|
||||
|
||||
.. image:: pics/007-first-time-wizard-settings.png
|
||||
|
||||
Default Display Monitor
|
||||
^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
Screen 2. If you are installing OpenLP but are not connected to a second output
|
||||
at the time, you can set this up later by going to
|
||||
:menuselection:`Settings --> Configure OpenLP`.
|
||||
|
||||
Default Theme
|
||||
^^^^^^^^^^^^^
|
||||
|
||||
If you have selected one or more themes on the themes page of the wizard, you
|
||||
can select which theme you'd like to be the default theme.
|
||||
|
||||
If you are happy with the selections you have made, click :guilabel:`Next` to
|
||||
continue to the next page.
|
||||
|
||||
.. image:: pics/009-first-time-wizard-progress.png
|
||||
|
||||
Making progress.
|
||||
|
||||
.. image:: pics/010-first-time-wizard-finished.png
|
||||
|
||||
On the last page of the wizard, OpenLP will download the sample songs, Bibles
|
||||
and themes, and set up OpenLP for you. Click :guilabel:`Finish` and OpenLP will
|
||||
start.
|
||||
|
||||
.. image:: pics/011-first-time-wizard-song-import.png
|
||||
|
||||
The main window.
|
||||
|
||||
.. image:: pics/012-openlp-main-window.png
|
||||
@ -121,6 +121,7 @@ class OpenLP(QtGui.QApplication):
|
||||
if show_splash:
|
||||
# now kill the splashscreen
|
||||
self.splash.finish(self.mainWindow)
|
||||
log.debug(u'Splashscreen closed')
|
||||
self.mainWindow.repaint()
|
||||
self.processEvents()
|
||||
if not has_run_wizard:
|
||||
|
||||
@ -166,7 +166,7 @@ def build_icon(icon):
|
||||
QtGui.QIcon.Normal, QtGui.QIcon.Off)
|
||||
return button_icon
|
||||
|
||||
def context_menu_action(base, icon, text, slot):
|
||||
def context_menu_action(base, icon, text, slot, shortcuts=None):
|
||||
"""
|
||||
Utility method to help build context menus for plugins
|
||||
|
||||
@ -186,6 +186,8 @@ def context_menu_action(base, icon, text, slot):
|
||||
if icon:
|
||||
action.setIcon(build_icon(icon))
|
||||
QtCore.QObject.connect(action, QtCore.SIGNAL(u'triggered()'), slot)
|
||||
if shortcuts:
|
||||
action.setShortcuts(shortcuts)
|
||||
return action
|
||||
|
||||
def context_menu(base, icon, text):
|
||||
|
||||
@ -101,6 +101,7 @@ class MediaManagerItem(QtGui.QWidget):
|
||||
self.toolbar = None
|
||||
self.remoteTriggered = None
|
||||
self.singleServiceItem = True
|
||||
self.quickPreviewAllowed = False
|
||||
self.pageLayout = QtGui.QVBoxLayout(self)
|
||||
self.pageLayout.setSpacing(0)
|
||||
self.pageLayout.setMargin(0)
|
||||
@ -266,23 +267,25 @@ class MediaManagerItem(QtGui.QWidget):
|
||||
context_menu_action(
|
||||
self.listView, u':/general/general_delete.png',
|
||||
self.plugin.getString(StringContent.Delete)[u'title'],
|
||||
self.onDeleteClick))
|
||||
self.onDeleteClick, [QtCore.Qt.Key_Delete]))
|
||||
self.listView.addAction(context_menu_separator(self.listView))
|
||||
self.listView.addAction(
|
||||
context_menu_action(
|
||||
self.listView, u':/general/general_preview.png',
|
||||
self.plugin.getString(StringContent.Preview)[u'title'],
|
||||
self.onPreviewClick))
|
||||
self.onPreviewClick, [QtCore.Qt.Key_Enter]))
|
||||
self.listView.addAction(
|
||||
context_menu_action(
|
||||
self.listView, u':/general/general_live.png',
|
||||
self.plugin.getString(StringContent.Live)[u'title'],
|
||||
self.onLiveClick))
|
||||
self.onLiveClick, [QtCore.Qt.ShiftModifier + \
|
||||
QtCore.Qt.Key_Enter, QtCore.Qt.ShiftModifier + \
|
||||
QtCore.Qt.Key_Return]))
|
||||
self.listView.addAction(
|
||||
context_menu_action(
|
||||
self.listView, u':/general/general_add.png',
|
||||
self.plugin.getString(StringContent.Service)[u'title'],
|
||||
self.onAddClick))
|
||||
self.onAddClick, [QtCore.Qt.Key_Plus, QtCore.Qt.Key_Equal]))
|
||||
if self.addToServiceItem:
|
||||
self.listView.addAction(
|
||||
context_menu_action(
|
||||
@ -293,6 +296,9 @@ class MediaManagerItem(QtGui.QWidget):
|
||||
QtCore.QObject.connect(self.listView,
|
||||
QtCore.SIGNAL(u'doubleClicked(QModelIndex)'),
|
||||
self.onClickPressed)
|
||||
QtCore.QObject.connect(self.listView,
|
||||
QtCore.SIGNAL(u'itemSelectionChanged()'),
|
||||
self.onSelectionChange)
|
||||
|
||||
def initialise(self):
|
||||
"""
|
||||
@ -411,7 +417,16 @@ class MediaManagerItem(QtGui.QWidget):
|
||||
else:
|
||||
self.onPreviewClick()
|
||||
|
||||
def onPreviewClick(self):
|
||||
def onSelectionChange(self):
|
||||
"""
|
||||
Allows the change of current item in the list to be actioned
|
||||
"""
|
||||
if QtCore.QSettings().value(u'advanced/single click preview',
|
||||
QtCore.QVariant(False)).toBool() and self.quickPreviewAllowed \
|
||||
and self.listView.selectedIndexes():
|
||||
self.onPreviewClick(True)
|
||||
|
||||
def onPreviewClick(self, keepFocus=False):
|
||||
"""
|
||||
Preview an item by building a service item then adding that service
|
||||
item to the preview slide controller.
|
||||
@ -426,6 +441,8 @@ class MediaManagerItem(QtGui.QWidget):
|
||||
if serviceItem:
|
||||
serviceItem.from_plugin = True
|
||||
self.parent.previewController.addServiceItem(serviceItem)
|
||||
if keepFocus:
|
||||
self.listView.setFocus()
|
||||
|
||||
def onLiveClick(self):
|
||||
"""
|
||||
|
||||
@ -67,6 +67,10 @@ class AdvancedTab(SettingsTab):
|
||||
self.doubleClickLiveCheckBox = QtGui.QCheckBox(self.uiGroupBox)
|
||||
self.doubleClickLiveCheckBox.setObjectName(u'doubleClickLiveCheckBox')
|
||||
self.uiLayout.addRow(self.doubleClickLiveCheckBox)
|
||||
self.singleClickPreviewCheckBox = QtGui.QCheckBox(self.uiGroupBox)
|
||||
self.singleClickPreviewCheckBox.setObjectName(
|
||||
u'singleClickPreviewCheckBox')
|
||||
self.uiLayout.addRow(self.singleClickPreviewCheckBox)
|
||||
self.expandServiceItemCheckBox = QtGui.QCheckBox(self.uiGroupBox)
|
||||
self.expandServiceItemCheckBox.setObjectName(
|
||||
u'expandServiceItemCheckBox')
|
||||
@ -130,6 +134,8 @@ class AdvancedTab(SettingsTab):
|
||||
'Remember active media manager tab on startup'))
|
||||
self.doubleClickLiveCheckBox.setText(translate('OpenLP.AdvancedTab',
|
||||
'Double-click to send items straight to live'))
|
||||
self.singleClickPreviewCheckBox.setText(translate('OpenLP.AdvancedTab',
|
||||
'Preview items when clicked in Media Manager'))
|
||||
self.expandServiceItemCheckBox.setText(translate('OpenLP.AdvancedTab',
|
||||
'Expand new service items on creation'))
|
||||
self.enableAutoCloseCheckBox.setText(translate('OpenLP.AdvancedTab',
|
||||
@ -164,6 +170,9 @@ class AdvancedTab(SettingsTab):
|
||||
self.doubleClickLiveCheckBox.setChecked(
|
||||
settings.value(u'double click live',
|
||||
QtCore.QVariant(False)).toBool())
|
||||
self.singleClickPreviewCheckBox.setChecked(
|
||||
settings.value(u'single click preview',
|
||||
QtCore.QVariant(False)).toBool())
|
||||
self.expandServiceItemCheckBox.setChecked(
|
||||
settings.value(u'expand service item',
|
||||
QtCore.QVariant(False)).toBool())
|
||||
@ -193,6 +202,8 @@ class AdvancedTab(SettingsTab):
|
||||
QtCore.QVariant(self.mediaPluginCheckBox.isChecked()))
|
||||
settings.setValue(u'double click live',
|
||||
QtCore.QVariant(self.doubleClickLiveCheckBox.isChecked()))
|
||||
settings.setValue(u'single click preview',
|
||||
QtCore.QVariant(self.singleClickPreviewCheckBox.isChecked()))
|
||||
settings.setValue(u'expand service item',
|
||||
QtCore.QVariant(self.expandServiceItemCheckBox.isChecked()))
|
||||
settings.setValue(u'enable exit confirmation',
|
||||
|
||||
@ -1125,6 +1125,9 @@ class ServiceManager(QtGui.QWidget):
|
||||
-1 is passed if the value is not set
|
||||
"""
|
||||
item, child = self.findServiceItem()
|
||||
# No items in service
|
||||
if item == -1:
|
||||
return
|
||||
if row != -1:
|
||||
child = row
|
||||
if self.serviceItems[item][u'service_item'].is_valid:
|
||||
|
||||
@ -46,6 +46,7 @@ class CustomMediaItem(MediaManagerItem):
|
||||
self.IconPath = u'custom/custom'
|
||||
MediaManagerItem.__init__(self, parent, self, icon)
|
||||
self.singleServiceItem = False
|
||||
self.quickPreviewAllowed = True
|
||||
# Holds information about whether the edit is remotly triggered and
|
||||
# which Custom is required.
|
||||
self.remoteCustom = -1
|
||||
|
||||
@ -46,6 +46,7 @@ class ImageMediaItem(MediaManagerItem):
|
||||
def __init__(self, parent, plugin, icon):
|
||||
self.IconPath = u'images/image'
|
||||
MediaManagerItem.__init__(self, parent, self, icon)
|
||||
self.quickPreviewAllowed = True
|
||||
QtCore.QObject.connect(Receiver.get_receiver(),
|
||||
QtCore.SIGNAL(u'live_theme_changed'), self.liveThemeChanged)
|
||||
|
||||
|
||||
@ -73,6 +73,7 @@ class SongMediaItem(MediaManagerItem):
|
||||
self.remoteSong = -1
|
||||
self.editItem = None
|
||||
self.whitespace = re.compile(r'\W+', re.UNICODE)
|
||||
self.quickPreviewAllowed = True
|
||||
|
||||
def addEndHeaderBar(self):
|
||||
self.addToolbarSeparator()
|
||||
|
||||
@ -69,6 +69,7 @@ Source: ..\..\dist\OpenLP\*; DestDir: {app}; Flags: ignoreversion recursesubdirs
|
||||
[Icons]
|
||||
Name: {group}\{#AppName}; Filename: {app}\{#AppExeName}
|
||||
Name: {group}\{#AppName} (Debug); Filename: {app}\{#AppExeName}; Parameters: -l debug
|
||||
Name: {group}\{#AppName} Help; Filename: {app}\{#AppName}.chm
|
||||
Name: {group}\{cm:ProgramOnTheWeb,{#AppName}}; Filename: {#AppURL}
|
||||
Name: {group}\{cm:UninstallProgram,{#AppName}}; Filename: {uninstallexe}
|
||||
Name: {commondesktop}\{#AppName}; Filename: {app}\{#AppExeName}; Tasks: desktopicon
|
||||
|
||||
@ -94,6 +94,10 @@ from subprocess import Popen, PIPE
|
||||
python_exe = sys.executable
|
||||
innosetup_exe = os.path.join(os.getenv(u'PROGRAMFILES'), 'Inno Setup 5',
|
||||
u'ISCC.exe')
|
||||
sphinx_exe = os.path.join(os.path.split(python_exe)[0], u'Scripts',
|
||||
u'sphinx-build.exe')
|
||||
hhc_exe = os.path.join(os.getenv(u'PROGRAMFILES'), 'HTML Help Workshop',
|
||||
u'hhc.exe')
|
||||
|
||||
# Base paths
|
||||
script_path = os.path.split(os.path.abspath(__file__))[0]
|
||||
@ -109,6 +113,7 @@ i18n_utils = os.path.join(script_path, u'translation_utils.py')
|
||||
|
||||
# Paths
|
||||
source_path = os.path.join(branch_path, u'openlp')
|
||||
manual_path = os.path.join(branch_path, u'documentation', u'manual')
|
||||
i18n_path = os.path.join(branch_path, u'resources', u'i18n')
|
||||
winres_path = os.path.join(branch_path, u'resources', u'windows')
|
||||
build_path = os.path.join(branch_path, u'build', u'pyi.win32', u'OpenLP')
|
||||
@ -132,21 +137,6 @@ def update_code():
|
||||
print output
|
||||
raise Exception(u'Error updating the code')
|
||||
|
||||
def clean_build_directories():
|
||||
dist_dir = os.path.join(build_path, u'dist')
|
||||
build_dir = os.path.join(build_path, u'build')
|
||||
if os.path.exists(dist_dir):
|
||||
for root, dirs, files in os.walk(dist_dir, topdown=False):
|
||||
print root
|
||||
for file in files:
|
||||
os.remove(os.path.join(root, file))
|
||||
os.removedirs(dist_dir)
|
||||
if os.path.exists(build_dir):
|
||||
for root, dirs, files in os.walk(build_dir, topdown=False):
|
||||
for file in files:
|
||||
os.remove(os.path.join(root, file))
|
||||
os.removedirs(build_dir)
|
||||
|
||||
def run_pyinstaller():
|
||||
print u'Running PyInstaller...'
|
||||
os.chdir(branch_path)
|
||||
@ -240,6 +230,31 @@ def compile_translations():
|
||||
if code != 0:
|
||||
raise Exception('Error running lconvert on %s' % source_path)
|
||||
|
||||
def run_sphinx():
|
||||
print u'Running Sphinx...'
|
||||
os.chdir(manual_path)
|
||||
sphinx = Popen((sphinx_exe, u'-b', u'htmlhelp', u'-d', u'build/doctrees',
|
||||
u'source', u'build/htmlhelp'), stdout=PIPE)
|
||||
output, error = sphinx.communicate()
|
||||
code = sphinx.wait()
|
||||
if code != 0:
|
||||
print output
|
||||
raise Exception(u'Error running Sphinx')
|
||||
|
||||
def run_htmlhelp():
|
||||
print u'Running HTML Help Workshop...'
|
||||
os.chdir(os.path.join(manual_path, u'build', u'htmlhelp'))
|
||||
hhc = Popen((hhc_exe, u'OpenLP.chm'), stdout=PIPE)
|
||||
output, error = hhc.communicate()
|
||||
code = hhc.wait()
|
||||
if code != 1:
|
||||
print u'Exit code:', code
|
||||
print output
|
||||
raise Exception(u'Error running HTML Help Workshop')
|
||||
else:
|
||||
copy(os.path.join(manual_path, u'build', 'htmlhelp', u'OpenLP.chm'),
|
||||
os.path.join(dist_path, u'OpenLP.chm'))
|
||||
|
||||
def run_innosetup():
|
||||
print u'Running Inno Setup...'
|
||||
os.chdir(winres_path)
|
||||
@ -260,7 +275,6 @@ def main():
|
||||
print "Inno Setup path:", innosetup_path
|
||||
print "Windows resources:", winres_path
|
||||
update_code()
|
||||
#clean_build_directories()
|
||||
run_pyinstaller()
|
||||
write_version_file()
|
||||
copy_enchant()
|
||||
@ -268,6 +282,8 @@ def main():
|
||||
copy_windows_files()
|
||||
update_translations()
|
||||
compile_translations()
|
||||
run_sphinx()
|
||||
run_htmlhelp()
|
||||
run_innosetup()
|
||||
print "Done."
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user