diff --git a/manual/source/installation.rst b/manual/source/installation.rst index 21fcfec..32cda07 100644 --- a/manual/source/installation.rst +++ b/manual/source/installation.rst @@ -63,4 +63,116 @@ Applications folder. Linux ----- -Installation process on Linux distributions vary by distribution. See the OpenLP `download page `_ 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` + + diff --git a/manual/source/pics/1fedoraaddremove.png b/manual/source/pics/1fedoraaddremove.png new file mode 100644 index 0000000..52df6ba Binary files /dev/null and b/manual/source/pics/1fedoraaddremove.png differ diff --git a/manual/source/pics/1softwaresources.png b/manual/source/pics/1softwaresources.png new file mode 100644 index 0000000..26f5c47 Binary files /dev/null and b/manual/source/pics/1softwaresources.png differ diff --git a/manual/source/pics/2fedoraaddremove.png b/manual/source/pics/2fedoraaddremove.png new file mode 100644 index 0000000..d70c1c8 Binary files /dev/null and b/manual/source/pics/2fedoraaddremove.png differ diff --git a/manual/source/pics/2othersoftware.png b/manual/source/pics/2othersoftware.png new file mode 100644 index 0000000..937960b Binary files /dev/null and b/manual/source/pics/2othersoftware.png differ diff --git a/manual/source/pics/3aptline.png b/manual/source/pics/3aptline.png new file mode 100644 index 0000000..1611e02 Binary files /dev/null and b/manual/source/pics/3aptline.png differ diff --git a/manual/source/pics/3fedoraaddremove.png b/manual/source/pics/3fedoraaddremove.png new file mode 100644 index 0000000..c26512a Binary files /dev/null and b/manual/source/pics/3fedoraaddremove.png differ diff --git a/manual/source/pics/4fedoraadditionalconfirm.png b/manual/source/pics/4fedoraadditionalconfirm.png new file mode 100644 index 0000000..d59c1e8 Binary files /dev/null and b/manual/source/pics/4fedoraadditionalconfirm.png differ diff --git a/manual/source/pics/4searchopenlp.png b/manual/source/pics/4searchopenlp.png new file mode 100644 index 0000000..61798d8 Binary files /dev/null and b/manual/source/pics/4searchopenlp.png differ diff --git a/manual/source/pics/5fedoraaddremove.png b/manual/source/pics/5fedoraaddremove.png new file mode 100644 index 0000000..646df6a Binary files /dev/null and b/manual/source/pics/5fedoraaddremove.png differ diff --git a/manual/source/pics/5installprogressubuntu.png b/manual/source/pics/5installprogressubuntu.png new file mode 100644 index 0000000..6fd0dcb Binary files /dev/null and b/manual/source/pics/5installprogressubuntu.png differ diff --git a/manual/source/pics/6fedoracomplete.png b/manual/source/pics/6fedoracomplete.png new file mode 100644 index 0000000..35a2001 Binary files /dev/null and b/manual/source/pics/6fedoracomplete.png differ diff --git a/manual/source/pics/6installcompleteubuntu.png b/manual/source/pics/6installcompleteubuntu.png new file mode 100644 index 0000000..ad442e5 Binary files /dev/null and b/manual/source/pics/6installcompleteubuntu.png differ