Příručka k rozšířením MediaWiki

PdfHandler Stav rozšíření: stabilníCategory:Stable extensions/cs
Implementace	MédiaCategory:Media handling extensions/cs
Popis	Allows to handle PDF files like multipage DJVU
Autoři	Martin Seidel (xarax)
Zásady kompatibility	Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
Změny v databázi	Ne
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball Category:Extensions in Wikimedia version control/cs
Příklad	commons.wikimedia.org sandbox.semantic-mediawiki.org
Parametry $wgPdfHandlerJpegQuality $wgPdfOutputExtension $wgPdfInfo $wgPdfProcessor $wgPdftoText $wgPdfPostProcessor $wgPdfHandlerDpi
Čtvrtletní stahování	131 (Ranked 31st)
Veřejné wiki používající rozšíření	3,575 (Ranked 185th)
Přeložte rozšíření PdfHandler, používá-li lokalizaci z translatewiki.net
Vagrant role	pdfhandler
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření PdfHandler zobrazuje nahrané soubory PDF ve vícestránkovém náhledu.^[1]

Together with the Proofread Page extension, PDF files can be displayed side-by-side with text. This allows users to transcribe books and other documents.^[2]

• A user can display PDF files as an image, showing a single page at a time, like so: [[File:myPdfFile.pdf|page=1|600px]]. The page and size parameters are optional; the default page is page #1. Instead of a size-parameter, you can also use the thumb-parameter, with or without captions: [[File:myPdfFile.pdf|page=1|thumb|My PDF]].^[3]
• Because PdfHandler extends ImageHandler, you can use all the arguments that you would for an Image -- for example: thumb, right/left, caption, border, link, etc.

If you would like to present a 2-page pdf, for example, do the following: [[File:myPdfFile.pdf|page=1]] [[File:myPdfFile.pdf|page=2]]

• The main usage of the PdfHandler extension is without user interaction. If you upload a new pdf file, the metadata will be stored in the database, and then this file can be shown in a multipage preview layout like the djvu handler does. Without this extension, pdfs will not display properly when uploaded.
• Additionally, this extension allows Extension:ProofreadPage to handle pdfs in side-by-side view for transcribing/proofreading, as is done on Wikisource

This extension requires the following packages to be installed first:

Type the following in your shell to see if you have the above installed first (it should list 4 rows):

which gs convert pdfinfo pdftotext

sudo apt install ghostscript imagemagick xpdf-utils

• Make sure that the required software is installed before you continue!
• Stáhněte soubor/y a vložte je do adresáře pojmenovaného PdfHandler ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/PdfHandler
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'PdfHandler' );
  

• Configure as required. (see also the examples provided)
• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

You can (or, depending on the operating system of the server, will have to) set some variables in the "LocalSettings.php" file:

$wgPdfProcessor (default = "gs")

path to your ghostscript implementation

$wgPdfPostProcessor (default = "convert")

path to your imagemagick convert

$wgPdfInfo (default = "pdfinfo")

path to your pdfinfo

$wgPdftoText (default = "pdftotext")

path to your pdftotext

$wgPdfOutputExtension (default = "jpg")

preferred output format^[4]

$wgPdfHandlerDpi (default = "150" )

resolution in dpi

The extension extracts a bitmap image for each page of the PDF, using this resolution (dpi = dots per inch). For example, a PDF page with the European size A4 is 210 mm wide, corresponding to 595 points (at 72 dpi). This yields an image 1240 pixels wide (at 150 dpi). If instead this parameter is set to 300 dpi, the width will be 2480 pixels.

$wgPdfHandlerJpegQuality (default = "95" / since MW 1.24+ )

Quality level, which the post processor should use.

Variables below are not specific to this extension

• Enable PDF uploads, if you haven't already: $wgFileExtensions [] = 'pdf';
• Enable ImageMagick, if you haven't already: $wgUseImageMagick = true;
• $wgMaxShellMemory - memory limit for gs, convert and pdfinfo. The default value might be too low.

$wgPdfProcessor = 'gs';
$wgPdfPostProcessor = $wgImageMagickConvertCommand; // if defined via ImageMagick
// $wgPdfPostProcessor = 'convert'; // if not defined via ImageMagick
$wgPdfInfo = 'pdfinfo';
$wgPdftoText = 'pdftotext';

$wgPdfProcessor = '/usr/bin/gs';
$wgPdfPostProcessor = $wgImageMagickConvertCommand; // if defined via ImageMagick
// $wgPdfPostProcessor = '/usr/bin/convert';  // if not defined via ImageMagick
$wgPdfInfo = '/usr/bin/pdfinfo';
$wgPdftoText = '/usr/bin/pdftotext';

$wgPdfProcessor = 'C:\Program Files\gs\gs8.60\bin\gswin32.exe';
$wgPdfPostProcessor = $wgImageMagickConvertCommand; // if defined via ImageMagick
// $wgPdfPostProcessor = 'C:\Program Files\ImageMagick-6.6.2-Q16\convert.exe'; // if not defined via ImageMagick
$wgPdfInfo = 'C:\Program Files\xpdf-3.02pl1-win32\pdfinfo.exe';
$wgPdftoText = 'C:\Program Files\xpdf-3.02pl1-win32\pdftotext.exe';

$wgPdfProcessor = '/usr/local/bin/gs';
$wgPdfPostProcessor = $wgImageMagickConvertCommand; // if defined via ImageMagick
// $wgPdfPostProcessor = '/usr/local/bin/convert'; // if not defined via ImageMagick
$wgPdfInfo = '/usr/local/bin/pdfinfo';
$wgPdftoText = '/usr/local/bin/pdftotext';

• If PDF files do not display after upload, make sure that MediaWiki can execute the pdfinfo command and that configuration parameter $wgPdfInfo is set properly. Also check your error log, and make sure that your host hasn't disabled running external commands.
• If PDF files do not show properly after installation (for example saying 0 height and width) you may need to use the maintenance scripts "refreshImageMetadata.php -f" and "rebuildImages.php"

  Example:

  php refreshImageMetadata.php --mime application/pdf --force

  Also try to purge the page of the file. See Manual:Purge.

• If PDF files are rendered randomly check if the "C.UTF-8" locale is available on your server by running locale -a.

• http://wiki.4intra.net/PdfHandler — a fork with much faster thumbnail generation by using pdftocairo instead of ghostscript+imagemagick
• Extension:Proofread Page — may be used in conjunction with PdfHandler
• How to use DjVu with MediaWiki
• Extension PDFEmbed

Toto rozšíření se používá na jednom nebo více projektech Wikimedia. Pravděpodobně to znamená, že rozšíření je stabilní a funguje dostatečně dobře, aby jej mohly používat weby s tak vysokou návštěvností. Vyhledejte tento název rozšíření v konfiguračních souborech CommonSettings.php a InitialiseSettings.php Wikimedie, abyste viděli, kde je nainstalováno. Úplný seznam rozšíření nainstalovaných na konkrétní wiki lze vidět na stránce wiki Special:Version.

Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích: BlueSpice Category:Extensions included in BlueSpice/cs Canasta Category:Extensions included in Canasta/cs Debian Category:Extensions available as Debian packages/cs Fandom Category:Extensions included in Fandom/cs Miraheze Category:Extensions included in Miraheze/cs MyWikisCategory:Extensions included in MyWikis/cs ProWikiCategory:Extensions included in ProWiki/cs semantic::coreCategory:Extensions included in semantic::core/cs ShoutWiki Category:Extensions included in ShoutWiki/cs TelepediaCategory:Extensions included in Telepedia/cs wiki.gg Category:Extensions included in wiki.gg/cs WikiForgeCategory:Extensions included in WikiForge/cs Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček.