Added documentation for Fedora and Arch Linux installation.

bzr-revno: 2

manual/source/installation.rst

@@ -63,4 +63,116 @@ Applications folder.
 Linux
 -----
 
-Installation process on Linux distributions vary by distribution. See the OpenLP `download page <http://www.openlp.org/en/download.html>`_ for distribution specific instructions.
+Setting up OpenLP varies by distribution. We have included documentation on
+popular distributions or distributions that have OpenLP available from their
+package managers. It should be possible to get OpenLP running on 
+nearly any Linux distribution.
+
+Ubuntu
+^^^^^^
+
+Installation of OpenLP on Ubuntu can either be done through the Software Center
+or the command line. Command line instructions will be included at the end of
+this section on Ubuntu and its variants.
+
+Open up the software center by clicking on the :guilabel:`Software Center` icon
+in the Launcher if you are using the Unity desktop, or if you are using an 
+older version of Ubuntu, or the Classic Desktop go to :menuselection:`Applications`
+and select the Software Center from the bottom of the menu. You will need to 
+be the administrator of the system to install OpenLP and will be asked for the
+administrator password several times through this process.
+
+First you will need to add the OpenLP Personal Package Archive (PPA) to
+your system. Go to :menuselection:`Edit --> Software Sources`
+
+.. image:: pics/1softwaresources.png
+
+Click on the :menuselection:`Other Software` tab then click on the 
+:guilabel:`Add...` button to add the new software source.
+
+.. image:: pics/2othersoftware.png
+
+Add the APT line::
+
+  ppa:openlp-core/release
+  
+Click :guilabel:`Add Source`
+  
+.. image:: pics/3aptline.png
+
+You now need to restart the Software Center to refresh the package list. When
+you have the Software Center running simply search for OpenLP and click 
+:guilabel:`Install`.
+
+.. image:: pics/4searchopenlp.png
+
+You will see the install progress as OpenLP and the dependencies required for
+it to run are downloaded.
+
+.. image:: pics/5installprogressubuntu.png
+
+After installation you should see that OpenLP is installed.
+
+.. image:: pics/6installcompleteubuntu.png
+
+You can now run OpenLP by either searching for it in the *Dash*, or clicking on
+the category *Media Apps* in Unity. If you are running the Classic Desktop you 
+will have OpenLP available by clicking 
+:menuselection:`Applications --> Sound and Video --> OpenLP`
+
+Ubuntu Command Line Install
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The following install procedure should work across all Ubuntu variants. You
+will need to add the Personal Package Archive (PPA) to Ubuntu's software 
+sources. From a terminal type::
+
+  user@ubuntu:~$ sudo add-apt-repository ppa:openlp-core/release
+  
+Now you need to refresh the package list::
+
+  user@ubuntu:~$ sudo apt-get update
+  
+Install OpenLP::
+
+  user@ubuntu:~$ sudo apt-get install openlp
+
+OpenLP should now be available in your desktops menu system, but if you wish 
+to run OpenLP from the command line type::
+
+  user@ubuntu:~$ openlp
+
+Fedora (GNOME)
+^^^^^^^^^^^^^^
+
+Installing with Fedora you will use the default Add/Remove Programs available
+from :menuselection:`System --> Administration --> Add/Remove Programs` in 
+Fedora 14 and below or in :menuselection:`Applications --> System Tools --> 
+Add/Remove Programs`
+
+.. image:: pics/1fedoraaddremove.png
+
+Search for OpenLP in the search box
+
+.. image:: pics/2fedoraaddremove.png
+
+Check the check box for OpenLP then click :guilabel:`Apply`
+
+.. image:: pics/3fedoraaddremove.png
+
+Click :guilabel:`Continue` to confirm installing any additional software.
+
+.. image:: pics/4fedoraadditionalconfirm.png
+
+You should now see the packages downloading in the lower left corner.
+
+.. image:: pics/5fedoraaddremove.png
+
+Click :guilabel:`Run` to run OpenLP now, or :guilabel:`Close` to run OpenLP
+later.
+
+.. image:: pics/6fedoracomplete.png
+
+OpenLP will be available in :menuselection:`Applications --> Sound & Video --> OpenLP`
+
+