Editing Wiki.tetrain.com Runbook (section)

=== 9.1 PDF uploads ===

<pre>
<nowiki>
cp /var/www/wiki/LocalSettings.php /var/www/wiki/LocalSettings.php.bak.$(date +%Y%m%d%H%M%S)
</nowiki>
</pre>

Add to <code><nowiki>LocalSettings.php</nowiki></code>, right after <code><nowiki>$wgEnableUploads = true;</nowiki></code>:

<pre>
<nowiki>
$wgFileExtensions = array_merge( $wgFileExtensions ?? [ 'png', 'gif', 'jpg', 'jpeg' ], [ 'pdf' ] );
</nowiki>
</pre>

Add after the other <code><nowiki>wfLoadExtension()</nowiki></code> calls:

<pre>
<nowiki>
wfLoadExtension( 'PdfHandler' );
</nowiki>
</pre>

<code><nowiki>PdfHandler</nowiki></code> ships bundled inside the 1.43.9 tarball already on disk (Phase 5) — it just isn't loaded by default, no separate download needed.

<code><nowiki>PdfHandler</nowiki></code> needs four system binaries it depends on for rendering/thumbnailing/text-indexing, none of which were present on the box:

<pre>
<nowiki>
dnf install -y ghostscript poppler-utils ImageMagick
# provides: gs ($wgPdfProcessor), convert ($wgPdfPostProcessor),
#           pdfinfo ($wgPdfInfo), pdftotext ($wgPdftoText) — all four are MediaWiki defaults,
#           no explicit $wgPdf* overrides were needed once the binaries existed on PATH
</nowiki>
</pre>

(This <code><nowiki>dnf install</nowiki></code> hit the 60s SSH command timeout mid-transaction — verified separately via <code><nowiki>rpm -qa | grep -iE 'ghostscript|poppler-utils|ImageMagick'</nowiki></code> and <code><nowiki>which gs convert pdfinfo pdftotext</nowiki></code> that it had actually completed; not re-run.)

'''Verify''':

<pre>
<nowiki>
curl -s 'https://wiki.tetrain.com/api.php?action=query&meta=siteinfo&siprop=fileextensions&format=json'
# confirm "pdf" present in the list
</nowiki>
</pre>

Also checked <code><nowiki>Special:Version</nowiki></code> on the live wiki — confirms "PDF Handler" registered as a loaded extension.