From 7ac8722969dbdcafe6aeae4eb7b82e31faa3bef2 Mon Sep 17 00:00:00 2001
From: Lucas Cimon <925560+Lucas-C@users.noreply.github.com>
Date: Sat, 18 Oct 2025 10:33:06 +0200
Subject: [PATCH] Adding some docs

---
 .github/workflows/python-tests.yml  | 4 ++--
 src/sigal/plugins/nonmedia_files.py | 3 +++
 tox.ini                             | 2 ++
 3 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/python-tests.yml b/.github/workflows/python-tests.yml
index 0e34c89..f49506d 100644
--- a/.github/workflows/python-tests.yml
+++ b/.github/workflows/python-tests.yml
@@ -26,10 +26,10 @@ jobs:
       uses: actions/setup-python@v6
       with:
         python-version: ${{ matrix.python-version }}
-    - name: Install FFmpeg
+    - name: Install FFmpeg & Poppler 
       run: |
         sudo apt update
-        sudo apt install ffmpeg
+        sudo apt install ffmpeg poppler-utils
         ffmpeg -version
     - name: Install Tox
       run: python -m pip install tox tox-gh-actions coverage
diff --git a/src/sigal/plugins/nonmedia_files.py b/src/sigal/plugins/nonmedia_files.py
index ec5acdb..91a0dc6 100644
--- a/src/sigal/plugins/nonmedia_files.py
+++ b/src/sigal/plugins/nonmedia_files.py
@@ -4,6 +4,9 @@ This plugin will copy the files into the build tree and generate generic
 thumbnails for the files.  In-browser previews will likely fail, and
 it is up to the theme to provide correct support for downloads.
 
+If the `pdf2image <https://pypi.org/project/pdf2image/>`_ optional dependency is installed,
+it will be used to generate thumbnails for PDF files.
+
 Settings available as dictionary in ``nonmedia_files_options``:
 
 - ``ext_as_thumb``: Enable simple thumbnail showing ext. Default to ``True``
diff --git a/tox.ini b/tox.ini
index a8c1ea7..fb0449e 100644
--- a/tox.ini
+++ b/tox.ini
@@ -17,6 +17,8 @@ deps =
     pillow10: Pillow==10.0.1
     pillow11: Pillow==11.0.0
     pillow12: Pillow==12.0.0
+    # We only install the pdf2image package in one environement:
+    pillow-latest: pdf2image
 extras =
     all
     tests