Add page_num to the commons() Twig function

* Add an optional `page_num` argument to the `commons()` Twig function.
* Switch from teatimeguest/setup-texlive-action to zauguin/install-texlive as the former no longer exists.

Author: samwilson

.github/workflows/ci.yml

@@ -28,7 +28,7 @@ jobs:
         extensions: fileinfo, json, pdo, mbstring, gd, ast, sqlite, pdo_sqlite
 
     - name: Set up TeXLive
-      uses: teatimeguest/setup-texlive-action@v3
+      uses: zauguin/install-texlive@v4
       with:
         packages: scheme-basic latexmk listings float
 

docs/content/templates.md

@@ -22,7 +22,8 @@ these are explained on this page.
 
 ## Functions
 
-1. `commons(file_name)` – Get information about a [Wikimedia Commons](https://commons.wikimedia.org/) file.
+1. `commons(file_name, [page_num])` – Get information about a [Wikimedia Commons](https://commons.wikimedia.org/) file.
+   The optional `page_num` parameter is used to get the thumnail URLs of a PDF's page.
 2. `flickr(photo_id)` – Get information about a [Flickr](https://www.flickr.com/) photo.
    To use this, you need to set the `flickr.api_key` and `flickr.api_secret` values
    in your site's `basildon.local.yaml` file.

example/templates/recent.html.twig

@@ -23,4 +23,9 @@
     {% endfor %}
     </ol>
 
+    <p>
+        Page 3 of a PDF with <code>commons('example.pdf', 3).imageinfo.0.thumburl</code>:
+        <img src="{{ commons('example.pdf', 3).imageinfo.0.thumburl }}">
+    </p>
+
 {% endblock %}

src/Twig.php

@@ -357,7 +357,7 @@ public function functionFlickr(string $photoId): array
     /**
      * @return mixed[]
      */
-    public function functionCommons(string $filename): array
+    public function functionCommons(string $filename, ?int $pageNum = null): array
     {
         if (isset(self::$data['commons'][$filename])) {
             return self::$data['commons'][$filename];
@@ -368,14 +368,18 @@ public function functionCommons(string $filename): array
             return $cacheItem->get();
         }
         $api = $this->site->getMediawikiApi('https://commons.wikimedia.org/w/api.php');
-        $fileInfoResponse = $api->request(ActionRequest::simpleGet('query')
-            ->addParams([
-                'prop' => 'imageinfo',
-                'iiprop' => 'url',
-                'iiurlwidth' => $this->site->getConfig()->embedWidth ?? 800,
-                'titles' => 'File:' . $filename,
-                'redirects' => true,
-            ]));
+        $urlWidth = $this->site->getConfig()->embedWidth ?? 800;
+        $params = [
+            'prop' => 'imageinfo',
+            'iiprop' => 'url',
+            'iiurlwidth' => $urlWidth,
+            'titles' => 'File:' . $filename,
+            'redirects' => true,
+        ];
+        if ($pageNum) {
+            $params['iiurlparam'] = "page$pageNum-{$urlWidth}px";
+        }
+        $fileInfoResponse = $api->request(ActionRequest::simpleGet('query', $params));
         $fileInfo = array_shift($fileInfoResponse['query']['pages']);
         if (!isset($fileInfo['pageid'])) {
             throw new Exception('Commons file does not exist: ' . $filename);