Fixed up Fedora images, fiddled with image sizes, started on a pre-processing script.

user-guide/make.bat

@@ -187,4 +187,11 @@ results in %BUILDDIR%/doctest/output.txt.
     goto end
 )
 
+if "%1" == "pdf" (
+    %SPHINXBUILD% -b pdf %ALLSPHINXOPTS% %BUILDDIR%/pdf
+    echo.
+    echo.Build finished. The PDF files are in %BUILDDIR%/pdf
+    goto end
+)
+
 :end

user-guide/pdf_optimise.py

@@ -0,0 +1,46 @@
+#!/usr/bin/env python
+import os
+import sys
+from tempfile import mkdtemp
+import re
+import shutil
+
+IMAGE_WIDTH = re.compile(r'^   :width: ([\d]+)px', re.UNICODE)
+
+def restore_files(temp_dir, restore_dir):
+    shutil.copytree(
+    shutil.rmtree(temp_dir)
+
+def adjust_image(match):
+    try:
+        width = int(match.group(1))
+        width = int(round(width * 2.4))
+        return str(width)
+    except:
+        return match.group(1)
+
+def process_images(filename):
+    contents = open(filename, 'rb').read()
+    contents = IMAGE_WIDTH.sub(adjust_image, contents)
+    fd = open(filename, 'wb')
+    fd.write(contents)
+    fd.close()
+
+def find_files(base_dir):
+    for root, dirs, files in os.walk(top, topdown=False):
+        for name in files:
+            if name.endswith(u'.rst'):
+                process_images(os.path.join(root, name))
+
+def main():
+    here = os.path.abspath(os.path.split(__file__)[0])
+    if len(sys.argv) > 1 and sys.argv[1] == 'restore':
+        temp_dir = os.path.abspath(sys.argv[2])
+        restore_files(temp_dir, here)
+        return
+    temp_dir = mkdtemp()
+    shutile.copytree(here, temp_dir)
+    find_files(here)
+
+if __name__ == '__main__':
+    main()

user-guide/source/getting-started/fedora.rst

@@ -0,0 +1,30 @@
+.. _fedora:
+
+Fedora(KDE)
+===========
+
+**Note** when installing OpenLP you will need to have administrator privileges.
+You will be asked for the administrator password to install.
+
+From the KickOff open *Software Management*. Type OpenLP into the search
+box. Then click :guilabel:`Find by name` or press :kbd:`Enter`.
+
+.. image:: ../screenshots/install/fedora/1-software-management.png
+   :width: 1995px
+
+Select OpenLP from the search results. Next, click :guilabel:`Apply`
+
+.. image:: ../screenshots/install/fedora/2-search-results.png
+   :width: 831px
+
+Now give permission to install other software dependencies that are needed by
+clicking :guilabel:`Continue`
+
+.. image:: ../screenshots/install/fedora/3-additional-software.png
+   :width: 566px
+
+Once completed you can run OpenLP by clicking on its logo in the completed
+install notification, or from the KickOff menu.
+
+.. image:: ../screenshots/install/fedora/4-installation-complete.png
+   :width: 521px

user-guide/source/getting-started/index.rst

@@ -5,8 +5,8 @@ Getting Started
 In this section we'll  be taking you through the first steps to getting OpenLP
 up and running on your computer.
 
-Downloading & Installing
+Installing
-------------------------
+----------
 Follow the instructions below to download and install OpenLP on your operating
 system.
 
@@ -14,13 +14,9 @@ system.
    windows
    mac-os-x
    ubuntu
+   fedora
    :maxdepth: 2
 
-
-Fedora
-******
-Open your package manager. Enable extras. Search for OpenLP. Click Install.
-
 Running for the First Time
 --------------------------
 When OpenLP starts up for the first time, it may take a little while to get started due to the fact that it needs to perform some initial setup.

user-guide/source/getting-started/ubuntu.rst

@@ -46,7 +46,10 @@ Then click on the :guilabel:`Updates` tab and make sure the checkbox next to
 :guilabel:`Backports` is checked. Click OK and then close and open *Software
 Center* to refresh the software list.
 
+.. image:: ../screenshots/install/ubuntu/5-updates-backports.png
+
 Other Ubuntu Releases
 ---------------------
 For information on how to install OpenLP in older Ubuntu releases, and in
-Ubuntu derivatives like Kubuntu and Xubuntu, please see the Reference Manual.
+Ubuntu derivatives like Kubuntu and Xubuntu, please see the relevaant section
+in the `Reference Manual <http://manual.openlp.org/>`_.