Fix raw image plugin installation docs [#5523].

Dependencies need to be installed from PyPI in Debian 10/11 due to missing
python3-py3exiv2 package.

Dockerfile-debian-python3-sqlite

@@ -98,6 +98,15 @@ gir1.2-gstreamer-1.0 \
 gstreamer1.0-tools \
 python3-gi
 
+# Install raw image dependencies.
+#
+# Currently (March 2021), python3-py3exiv2 is only available in Debian Sid, so
+# we need to install py3exiv2 from PyPI (later on in this Dockerfile). These are
+# the build depedencies for py3exiv2.
+RUN apt-get install -y \
+libexiv2-dev \
+libboost-python-dev
+
 # Install document (PDF-only) dependencies.
 # TODO: Check that PDF tests aren't skipped.
 RUN apt-get install -y \
@@ -154,6 +163,9 @@ RUN ./bootstrap.sh
 RUN VIRTUALENV_FLAGS='--system-site-packages' ./configure
 RUN make
 
+# Install raw image library from PyPI.
+RUN ./bin/pip install py3exiv2
+
 # Run the tests.
 RUN ./bin/python -m pytest ./mediagoblin/tests --boxed
 
@@ -161,6 +173,7 @@ RUN ./bin/python -m pytest ./mediagoblin/tests --boxed
 # customised mediagoblin.ini to already install these.
 RUN echo '[[mediagoblin.media_types.audio]]' >> mediagoblin.ini
 RUN echo '[[mediagoblin.media_types.video]]' >> mediagoblin.ini
+RUN echo '[[mediagoblin.media_types.raw_image]]' >> mediagoblin.ini
 
 # Prepare the SQLite database.
 #

docs/source/siteadmin/media-types.rst

@@ -178,9 +178,17 @@ Configuring video
 Raw image
 =========
 
-To enable raw image you need to install pyexiv2::
+MediaGoblin can extract and display the JPEG preview from RAW images.
 
-    # Debian and co.
+To enable raw image you need to install the Python library ``py3exiv2``. This
+library is not currently available for Debian 10 or 11 but can be installed from
+the Python Package Index after installing the build dependencies::
+
+    # Debian 10/11
+    sudo apt install libexiv2-dev libboost-python-devn
+    ./bin/pip install py3pyexiv2
+
+    # Debian 12 (currently not released)
     sudo apt install python3-pyexiv2
 
 Add ``[[mediagoblin.media_types.raw_image]]`` under the ``[plugins]``
@@ -188,10 +196,10 @@ section in your ``mediagoblin.ini`` and restart MediaGoblin.
 
 Run::
 
-    $ ./bin/gmg dbupdate
+    ./bin/gmg dbupdate
 
-Restart MediaGoblin (and Celery if applicable). Now you should be able to submit
+Restart MediaGoblin (and Celery if applicable). You should now be able to submit
-raw images, and MediaGoblin should extract the JPEG preview from them.
+raw images.
 
 
 ASCII art

docs/source/siteadmin/relnotes.rst

@@ -34,6 +34,7 @@ carefully, or at least skim over it.
 
 **Bug fixes:**
 
+- Fix raw image plugin installation instruction [#5523] (Ben Sturmfels)
 - Pin sqlalchemy to fix due to changed internals [#5624] (Charlotte Koch)
 - Fix test suite to pass 100% (Ben Sturmfels)
 - Make LDAP plugin Python 3 compatible [#5607] (Olivier Mehani)