media-types.rst: clarify the pdf media type requirements
authorAlon Levy <alevy@redhat.com>
Thu, 13 Jun 2013 02:42:58 +0000 (22:42 -0400)
committerChristopher Allan Webber <cwebber@dustycloud.org>
Thu, 13 Jun 2013 02:56:25 +0000 (21:56 -0500)
Explain that it works fine without libreoffice, just with reduced
functionality.

Signed-off-by: Alon Levy <alevy@redhat.com>
docs/source/siteadmin/media-types.rst

index 210094b9a232e85d5a20c53884e388d57c2efcec..1527bc70528616e8cd2ff4123b149a012134b799 100644 (file)
@@ -199,8 +199,16 @@ will be able to present them to your wide audience of admirers!
 PDF and Document
 ================
 
-To enable the "PDF and Document" support plugin, you need pdftocairo, pdfinfo,
-unoconv with headless support.  All executables must be on your execution path.
+To enable the "PDF and Document" support plugin, you need:
+
+1. pdftocairo and pdfinfo for pdf only support.
+
+2. unoconv with headless support to support converting libreoffice supported
+   documents as well, such as doc/ppt/xls/odf/odg/odp and more.
+   For the full list see mediagoblin/media_types/pdf/processing.py,
+   unoconv_supported.
+
+All executables must be on your execution path.
 
 To install this on Fedora:
 
@@ -208,6 +216,9 @@ To install this on Fedora:
 
     sudo yum install -y poppler-utils unoconv libreoffice-headless
 
+Note: You can leave out unoconv and libreoffice-headless if you want only pdf
+support. This will result in a much smaller list of dependencies.
+
 pdf.js relies on git submodules, so be sure you have fetched them:
 
 .. code-block:: bash