John Cegalis has proposed merging lp:~jseagull1/openlp/documentation into lp:openlp.
Requested reviews: John Cegalis (jseagull1) Jon Tibble (meths) Raoul Snyman (raoul-snyman) Andreas Preikschat (googol-hush) For more details, see: https://code.launchpad.net/~jseagull1/openlp/documentation/+merge/55993 First Run Wizard changed wording around fixed Alert Jon, some of your requested numbers didn't match up since I pushed after you remarked. -- https://code.launchpad.net/~jseagull1/openlp/documentation/+merge/55993 Your team OpenLP Core is subscribed to branch lp:openlp.
=== added file 'documentation/manual/source/alert.rst' --- documentation/manual/source/alert.rst 1970-01-01 00:00:00 +0000 +++ documentation/manual/source/alert.rst 2011-04-01 19:36:33 +0000 @@ -0,0 +1,60 @@ +===== +Alert +===== + +:menuselection:`Tools --> 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. \ No newline at end of file === added file 'documentation/manual/source/faq.rst' --- documentation/manual/source/faq.rst 1970-01-01 00:00:00 +0000 +++ documentation/manual/source/faq.rst 2011-04-01 19:36:33 +0000 @@ -0,0 +1,518 @@ +====== +F.A.Q. +====== + +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 PC's as required, even on +the home PC's 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 [[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. + +**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. +[[Help:Contents|Please let us know]] 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 [[Bug|bugs]] 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 [[Translation:Getting_Started|Getting started page]]. + +**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>`_. + +**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_2_Milestones#Version_1.9.6_.28beta_2.29|Version 1.9.6 (beta 2)]]. + +**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 +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 v2, 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?|How do I activate / deactivate a plugin]] +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 [[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?]] + +**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 (in the same format as `openlp.org 1.x <http://www.openlp.org/en/documentation/importing_exporting_data/bibles/importing_comma_delimited_files.html>`_) + +* OSIS (export from the `Sword Project <http://www.crosswire.org/sword/software/>`_ using the mod2osis tool) + + * After using the Sword software Media Manager to download the required bible. + + * From the command line (works on Windows and Linux):<br /><code>modernist <name> > name.osis</code><br />`Note the <name> is case sensitive on all environments and should be the name of your bible, e.g. ESV.` + + * 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 + + * `Crosswalk <http://biblestudy.crosswalk.com/bibles/>`_ + + * `BibleGateway <http://www.biblegateway.com/versions/>`_ + +**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 + +**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** + +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? +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +* Operating System + + * Version + * Distribution - Ubuntu, Fedora, etc (if you're using Linux) + * Edition \- Home, Basic, Business, etc (if you're using Windows) + +* Version of OpenLP (:menuselection:`Help --> About`) +* The exact steps to take in order to reproduce the error +* Version of MS Office or OpenOffice (if you're using the song imports or the presentation plugin) +* What Bible translation and type you are importing (if you're using the Bible importer) +* `Any` other information that might remotely be related or useful. + +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: <code>-l debug</code>. 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 <code>openlp.log</code> file. This is the file to e-mail. + +**Linux** + +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 +<code>/Applications</code>:: + + @:~$ 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 + +**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:: + + Logging to: /home/<User>/.config/openlp/openlp.log + +* 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 <code>phonon-backend-gstreamer</code> 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 <code>phonon-backend-xine</code> 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 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** + +You need to run the :menuselection:`Tools --> Re-index Songs`. + +**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** + +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 playing video by themselves, try selecting the +:menuselection:`Settings --> Configure OpenLP --> Media`, Use Phonon for Video +playback option. As for text over video, we have no solution for speeding these +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 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]]. + +**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?** + +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>`_ +and post the idea there. + +`Help <http://wiki.openlp.org/Help:Contents>`_ \ No newline at end of file === modified file 'documentation/manual/source/index.rst' --- documentation/manual/source/index.rst 2011-03-28 21:54:49 +0000 +++ documentation/manual/source/index.rst 2011-04-01 19:36:33 +0000 @@ -13,10 +13,12 @@ introduction glossary + wizard dualmonitors configure bibles themes mediamanager songs + alert troubleshooting === added file 'documentation/manual/source/mediamanager.rst' --- documentation/manual/source/mediamanager.rst 1970-01-01 00:00:00 +0000 +++ documentation/manual/source/mediamanager.rst 2011-04-01 19:36:33 +0000 @@ -0,0 +1,250 @@ +============= +Media Manager +============= + +Once you get your system set up for OpenLP you will be ready to add content to +your Service Manager. This will all happen through the **Media Manager**. The +`Media Manager` contains all the Bibles, Songs, Presentations, Media, and +everything else that you will project through OpenLP. + +Enabling the Plugins +-------------------- + +You may need to enable the plugins that came with OpenLP. As you can see below +this is what the `Media Manager` looks like with all the plugins enabled. + +.. image:: pics/mediamanager.png + +To enable the plugins navigate to :menuselection:`Settings --> Plugins` or +press :kbd:`Alt+F7`. You will want to click on the plugin to the left that you +would like to enable and select **active** from the drop down box to the right. + +.. image:: pics/plugins.png + + +You are now ready to add content for your service. + +Adding Media Content +-------------------- + +This section will describe how to add the different types of media OpenLP is +capable of displaying. + +Songs +^^^^^ +Clicking on Songs in the Media Manager will display all of the songs you have +added by Title and Author/Authors. + +Using the buttons you can: + +`Add a song:` Brings up the dialog box to add a new song + +`Edit the selected song:` Brings up the dialog box to make changes to the song + +`Delete the selected song:` Removes the song from your song list + +`Preview the selected song:` Lets you see what your song will look like +displayed live + +`Send the selected song live:` This option will immediately display your song +live. + +`Add the selected Song to the service:` This will enter your song in the Service +Manager. You may also drag your song over to the Service Manager. + +`Maintain the list of authors, topics and books:` Brings up a dialog box to edit +Authors, Topics or Song Books. +Note: Right clicking on a song file will bring up some of the same options. + +Bibles +^^^^^^ +Clicking on Bibles in the Media Manager will display your options for searching +and adding chapters and verses to the Service Manager. + +Using the buttons you can: + +`Import a Bible:` This is discussed in detail on the Bible Importer page in the +manual. + +`Preview the selected Bible:` Sends your selected verses to the Preview window + +`Send the selected Bible live:` This option will immediately display your +selected verses live. + +`Add the selected Bible to the service:` This will enter your verses into the +Service Manager. You may also click and drag your verses over to the Service +Manager. + +**Quick tab** + +`Version:` Once you have imported a Bible, it will be displayed in the Version +drop down box. Select the version of the Bible you want to use here. + +**Second** + +If you have âDisplay second Bible versesâ selected in Configure OpenLP, Bibles +tab, this choice will be visible. This option is for displaying another version +of the Bible for comparison. Both versions will be displayed. If there is not +enough space on one slide, the Second version will be displayed on the next +slide. + +Use the `Search` button to display your results in the box below. + +**Find** + +You will type your search query in this box for the following two searches. + +`Search type:` You may search for a specific verse using this format below. + +Book Chapter +Book Chapter-Chapter +Book Chapter:Verse-Verse +Book Chapter:Verse-Verse, Verse-Verse +Book Chapter:Verse-Verse,Chapter:Verse-Verse +Book Chapter: Verse-Chapter:Verse + +`Text Search:` + +You may also search by a keyword or words. The more words you use for the +search, the more you will narrow down your results. + +**Results** `Clear and Keep.` + +Each search you make will display your verses below. If you would like to +display verses that are out of sequence you may select `Keep` in the drop down +box and continue your search for the next verse or verses. All searches will be +shown and kept below. +If you select `Clear` from the drop down box, each new search clears the +previous search from the list below. + +**Advanced tab** + +This tab is convenient for selecting book, chapter and verse by name and number. +Version and Second are the same as in Quick tab above. Click on each box and +select the version you wish to display and Second version if you wish to display +an alternative version. + +Use the `Search` button to display your results in the box below. + +`Book:` Click on the drop down box and select the book you want to display. +`Chapter: Verse:` Select your chapter From and To and Verse From and To + +Results will work the same as the Quick tab above. + +Presentations +^^^^^^^^^^^^^ +Using the buttons you can: + +`Load a new presentation:` This brings up a dialog box to find your presentation +and list it in OpenLP. + +`Delete the selected Presentation:` This removes your Presentation from the list. +Please note: this will not delete the presentation from your computer, only from +the OpenLP list. + +`Preview the selected Presentation:` Sends your selected Presentation to the +Preview window + +`Send the selected Presentation live:` This option will immediately display your +selected Presentation live. + +`Add the selected Presentation to the service:` This will enter your +Presentation into the Service Manager. You may also click and drag your +Presentation over to the Service Manager. + +Right clicking on a Presentation file will bring up some of the same options. + +Images +^^^^^^ +Using the buttons you can: + +`Load a new Image:` This brings up a dialog box to find your Image and list it +in OpenLP. + +`Delete the selected Image:` This removes your Image from the list. Please note: +this will not delete the Image from your computer, just the OpenLP list. + +`Preview the selected Image:` Sends your selected Image to the Preview window + +`Send the selected Image live:` This option will immediately display your +selected Image live. + +`Add the selected Image to the service:` This will enter your Image into the +Service Manager. You may also click and drag your Image over to the Service +Manager. + +`Replace Live Background:` With an Image selected, clicking this button will +immediately replace the live background being displayed with your selection. +The Image will replace the theme background until the theme changes or the +"Remove Background" button is pressed. + + +Right clicking on an Image file will bring up some of the same options. + +Media +^^^^^ + +Media is an audio or video file. Generally if you can play or view your media +on your computer without OpenLP, you can also play it in OpenLP. + +Using the buttons you can: +`Load a new Media:` This brings up a dialog box to find your Media and list it +in OpenLP. + +`Delete the selected Media:` This removes your Media from the list. Please note: +this will not delete the Media from your computer, just the OpenLP list. + +`Preview the selected Media:` Sends your selected Media to the Preview window + +`Send the selected Media live:` This option will immediately display your +selected Media live. + +`Add the selected Media to the service:` This will enter your Media into the +Service Manager. You may also click and drag your Media over to the Service +Manager. + +`Replace Live Background:` With a Media file selected, clicking this button will +immediately replace the live background being displayed with your selection. + +Right clicking on a Media file will bring up some of the same options. + +Custom +^^^^^^ + +Custom gives you the option of creating your own slide. This could be useful for +displaying readings, liturgy or any text that may not be found in Songs or +Bibles. + +`Add a new Custom:` Brings up the dialog box to add a new Custom display. +`Edit the selected Custom:` Brings up the dialog box to make changes to the +Custom display. + +`Delete the selected Custom:` Remove the Custom from your list + +`Preview the selected Custom:` Lets you see what your Custom will look like +displayed live + +`Send the selected Custom live:` This option will immediately display your +Custom live + +`Add the selected Custom to the service:` This will enter your Custom in the +Service Manager. You may also drag your Custom over to the Service Manager. + +Right clicking on a Custom file will bring up some of the same options. + +When you Add a new Custom slide a dialog box will appear. + +`Title:` Name of your Custom slide. + +`Add:` After clicking on Add you will enter your text you want to display in +this box. To create multiple slides, click the Split Slide button. When you have +finished adding your text, click on the Save button. + +`Theme:` Select the theme you want to use for your Custom slide from this drop +down box. +`Credits:` Anything typed in this box will be displayed in the footer +information on the display. When you are finished, click the Save button. + +To Edit your slide, click on the Edit button to edit part of it or the Edit All +if you need to make multiple changes. Use the Up and Down arrows to change the +arrangement of your Custom slide. === removed file 'documentation/manual/source/mediamanager.rst' --- documentation/manual/source/mediamanager.rst 2011-03-31 14:44:42 +0000 +++ documentation/manual/source/mediamanager.rst 1970-01-01 00:00:00 +0000 @@ -1,250 +0,0 @@ -============= -Media Manager -============= - -Once you get your system set up for OpenLP you will be ready to add content to -your Service Manager. This will all happen through the **Media Manager**. The -`Media Manager` contains all the Bibles, Songs, Presentations, Media, and -everything else that you will project through OpenLP. - -Enabling the Plugins --------------------- - -You may need to enable the plugins that came with OpenLP. As you can see below -this is what the `Media Manager` looks like with all the plugins enabled. - -.. image:: pics/mediamanager.png - -To enable the plugins navigate to :menuselection:`Settings --> Plugins` or -press :kbd:`Alt+F7`. You will want to click on the plugin to the left that you -would like to enable and select **active** from the drop down box to the right. - -.. image:: pics/plugins.png - - -You are now ready to add content for your service. - -Adding Media Content --------------------- - -This section will describe how to add the different types of media OpenLP is -capable of displaying. - -Songs -^^^^^ -Clicking on Songs in the Media Manager will display all of the songs you have -added by Title and Author/Authors. - -Using the buttons you can: - -`Add a song:` Brings up the dialog box to add a new song - -`Edit the selected song:` Brings up the dialog box to make changes to the song - -`Delete the selected song:` Removes the song from your song list - -`Preview the selected song:` Lets you see what your song will look like -displayed live - -`Send the selected song live:` This option will immediately display your song -live. - -`Add the selected Song to the service:` This will enter your song in the Service -Manager. You may also drag your song over to the Service Manager. - -`Maintain the list of authors, topics and books:` Brings up a dialog box to edit -Authors, Topics or Song Books. -Note: Right clicking on a song file will bring up some of the same options. - -Bibles -^^^^^^ -Clicking on Bibles in the Media Manager will display your options for searching -and adding chapters and verses to the Service Manager. - -Using the buttons you can: - -`Import a Bible:` This is discussed in detail on the Bible Importer page in the -manual. - -`Preview the selected Bible:` Sends your selected verses to the Preview window - -`Send the selected Bible live:` This option will immediately display your -selected verses live. - -`Add the selected Bible to the service:` This will enter your verses into the -Service Manager. You may also click and drag your verses over to the Service -Manager. - -**Quick tab** - -`Version:` Once you have imported a Bible, it will be displayed in the Version -drop down box. Select the version of the Bible you want to use here. - -**Second** - -If you have âDisplay second Bible versesâ selected in Configure OpenLP, Bibles -tab, this choice will be visible. This option is for displaying another version -of the Bible for comparison. Both versions will be displayed. If there is not -enough space on one slide, the Second version will be displayed on the next -slide. - -Use the `Search` button to display your results in the box below. - -**Find** - -You will type your search query in this box for the following two searches. - -`Search type:` You may search for a specific verse using this format below. - -Book Chapter -Book Chapter-Chapter -Book Chapter:Verse-Verse -Book Chapter:Verse-Verse, Verse-Verse -Book Chapter:Verse-Verse,Chapter:Verse-Verse -Book Chapter: Verse-Chapter:Verse - -`Text Search:` - -You may also search by a keyword or words. The more words you use for the -search, the more you will narrow down your results. - -**Results** `Clear and Keep.` - -Each search you make will display your verses below. If you would like to -display verses that are out of sequence you may select `Keep` in the drop down -box and continue your search for the next verse or verses. All searches will be -shown and kept below. -If you select `Clear` from the drop down box, each new search clears the -previous search from the list below. - -**Advanced tab** - -This tab is convenient for selecting book, chapter and verse by name and number. -Version and Second are the same as in Quick tab above. Click on each box and -select the version you wish to display and Second version if you wish to display -an alternative version. - -Use the `Search` button to display your results in the box below. - -`Book:` Click on the drop down box and select the book you want to display. -`Chapter: Verse:` Select your chapter From and To and Verse From and To - -Results will work the same as the Quick tab above. - -Presentations -^^^^^^^^^^^^^ -Using the buttons you can: - -`Load a new presentation:` This brings up a dialog box to find your presentation -and list it in OpenLP. - -`Delete the selected Presentation:` This removes your Presentation from the list. -Please note: this will not delete the presentation from your computer, only from -the OpenLP list. - -`Preview the selected Presentation:` Sends your selected Presentation to the -Preview window - -`Send the selected Presentation live:` This option will immediately display your -selected Presentation live. - -`Add the selected Presentation to the service:` This will enter your -Presentation into the Service Manager. You may also click and drag your -Presentation over to the Service Manager. - -Right clicking on a Presentation file will bring up some of the same options. - -Images -^^^^^^ -Using the buttons you can: - -`Load a new Image:` This brings up a dialog box to find your Image and list it -in OpenLP. - -`Delete the selected Image:` This removes your Image from the list. Please note: -this will not delete the Image from your computer, just the OpenLP list. - -`Preview the selected Image:` Sends your selected Image to the Preview window - -`Send the selected Image live:` This option will immediately display your -selected Image live. - -`Add the selected Image to the service:` This will enter your Image into the -Service Manager. You may also click and drag your Image over to the Service -Manager. - -`Replace Live Background:` With an Image selected, clicking this button will -immediately replace the live background being displayed with your selection. -The Image will replace the theme background until the theme changes or the -"Remove Background" button is pressed. - - -Right clicking on an Image file will bring up some of the same options. - -Media -^^^^^ - -Media is an audio or video file. Generally if you can play or view your media -on your computer without OpenLP, you can also play it in OpenLP. - -Using the buttons you can: -`Load a new Media:` This brings up a dialog box to find your Media and list it -in OpenLP. - -`Delete the selected Media:` This removes your Media from the list. Please note: -this will not delete the Media from your computer, just the OpenLP list. - -`Preview the selected Media:` Sends your selected Media to the Preview window - -`Send the selected Media live:` This option will immediately display your -selected Media live. - -`Add the selected Media to the service:` This will enter your Media into the -Service Manager. You may also click and drag your Media over to the Service -Manager. - -`Replace Live Background:` With a Media file selected, clicking this button will -immediately replace the live background being displayed with your selection. - -Right clicking on a Media file will bring up some of the same options. - -Custom -^^^^^^ - -Custom gives you the option of creating your own slide. This could be useful for -displaying readings, liturgy or any text that may not be found in Songs or -Bibles. - -`Add a new Custom:` Brings up the dialog box to add a new Custom display. -`Edit the selected Custom:` Brings up the dialog box to make changes to the -Custom display. - -`Delete the selected Custom:` Remove the Custom from your list - -`Preview the selected Custom:` Lets you see what your Custom will look like -displayed live - -`Send the selected Custom live:` This option will immediately display your -Custom live - -`Add the selected Custom to the service:` This will enter your Custom in the -Service Manager. You may also drag your Custom over to the Service Manager. - -Right clicking on a Custom file will bring up some of the same options. - -When you Add a new Custom slide a dialog box will appear. - -`Title:` Name of your Custom slide. - -`Add:` After clicking on Add you will enter your text you want to display in -this box. To create multiple slides, click the Split Slide button. When you have -finished adding your text, click on the Save button. - -`Theme:` Select the theme you want to use for your Custom slide from this drop -down box. -`Credits:` Anything typed in this box will be displayed in the footer -information on the display. When you are finished, click the Save button. - -To Edit your slide, click on the Edit button to edit part of it or the Edit All -if you need to make multiple changes. Use the Up and Down arrows to change the -arrangement of your Custom slide. === added file 'documentation/manual/source/pics/001-first-time-language.png' Binary files documentation/manual/source/pics/001-first-time-language.png 1970-01-01 00:00:00 +0000 and documentation/manual/source/pics/001-first-time-language.png 2011-04-01 19:36:33 +0000 differ === added file 'documentation/manual/source/pics/002-first-time-wizard-welcome.png' Binary files documentation/manual/source/pics/002-first-time-wizard-welcome.png 1970-01-01 00:00:00 +0000 and documentation/manual/source/pics/002-first-time-wizard-welcome.png 2011-04-01 19:36:33 +0000 differ === added file 'documentation/manual/source/pics/003-first-time-wizard-plugins.png' Binary files documentation/manual/source/pics/003-first-time-wizard-plugins.png 1970-01-01 00:00:00 +0000 and documentation/manual/source/pics/003-first-time-wizard-plugins.png 2011-04-01 19:36:33 +0000 differ === added file 'documentation/manual/source/pics/004-first-time-wizard-songs.png' Binary files documentation/manual/source/pics/004-first-time-wizard-songs.png 1970-01-01 00:00:00 +0000 and documentation/manual/source/pics/004-first-time-wizard-songs.png 2011-04-01 19:36:33 +0000 differ === added file 'documentation/manual/source/pics/005-first-time-wizard-bibles.png' Binary files documentation/manual/source/pics/005-first-time-wizard-bibles.png 1970-01-01 00:00:00 +0000 and documentation/manual/source/pics/005-first-time-wizard-bibles.png 2011-04-01 19:36:33 +0000 differ === added file 'documentation/manual/source/pics/006-first-time-wizard-themes.png' Binary files documentation/manual/source/pics/006-first-time-wizard-themes.png 1970-01-01 00:00:00 +0000 and documentation/manual/source/pics/006-first-time-wizard-themes.png 2011-04-01 19:36:33 +0000 differ === added file 'documentation/manual/source/pics/007-first-time-wizard-settings.png' Binary files documentation/manual/source/pics/007-first-time-wizard-settings.png 1970-01-01 00:00:00 +0000 and documentation/manual/source/pics/007-first-time-wizard-settings.png 2011-04-01 19:36:33 +0000 differ === added file 'documentation/manual/source/pics/009-first-time-wizard-progress.png' Binary files documentation/manual/source/pics/009-first-time-wizard-progress.png 1970-01-01 00:00:00 +0000 and documentation/manual/source/pics/009-first-time-wizard-progress.png 2011-04-01 19:36:33 +0000 differ === added file 'documentation/manual/source/pics/010-first-time-wizard-finished.png' Binary files documentation/manual/source/pics/010-first-time-wizard-finished.png 1970-01-01 00:00:00 +0000 and documentation/manual/source/pics/010-first-time-wizard-finished.png 2011-04-01 19:36:33 +0000 differ === added file 'documentation/manual/source/pics/011-first-time-wizard-song-import.png' Binary files documentation/manual/source/pics/011-first-time-wizard-song-import.png 1970-01-01 00:00:00 +0000 and documentation/manual/source/pics/011-first-time-wizard-song-import.png 2011-04-01 19:36:33 +0000 differ === added file 'documentation/manual/source/pics/012-openlp-main-window.png' Binary files documentation/manual/source/pics/012-openlp-main-window.png 1970-01-01 00:00:00 +0000 and documentation/manual/source/pics/012-openlp-main-window.png 2011-04-01 19:36:33 +0000 differ === added file 'documentation/manual/source/pics/alert.png' Binary files documentation/manual/source/pics/alert.png 1970-01-01 00:00:00 +0000 and documentation/manual/source/pics/alert.png 2011-04-01 19:36:33 +0000 differ === added file 'documentation/manual/source/wizard.rst' --- documentation/manual/source/wizard.rst 1970-01-01 00:00:00 +0000 +++ documentation/manual/source/wizard.rst 2011-04-01 19:36:33 +0000 @@ -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
_______________________________________________ Mailing list: https://launchpad.net/~openlp-core Post to : openlp-core@lists.launchpad.net Unsubscribe : https://launchpad.net/~openlp-core More help : https://help.launchpad.net/ListHelp