Extension:PdfHandler

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

PdfHandler Stav rozšíření: stabilní
Implementace	Média
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
Příklad	commons.wikimedia.org sandbox.semantic-mediawiki.org
Parametry $wgPdfHandlerJpegQuality $wgPdfOutputExtension $wgPdfInfo $wgPdfProcessor $wgPdftoText $wgPdfPostProcessor $wgPdfHandlerDpi
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.

Spolu s rozšířením Proofread Page lze soubory PDF zobrazit s textem vedle sebe. To umožňuje uživatelům přepisovat knihy a další dokumenty.

Použití

• Uživatel může zobrazit soubory PDF jako obrázek, přičemž se zobrazí jedna stránka po druhé, například takto: [[File:myPdfFile.pdf|page=1|600px]]. Parametry page a size jsou volitelné. Výchozí stránkou je stránka č. 1. Místo parametru size můžete také použít parametr thumb, s popisky nebo bez nich: [[File:myPdfFile.pdf|page=1|thumb|My PDF]].
• Protože PdfHandler rozšiřuje ImageHandler, můžete použít všechny argumenty, které byste použili pro Image – například: thumb, right/left, caption, border, link atd.

Pokud chcete například prezentovat dvoustránkový PDF soubor, postupujte takto: [[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

Předpoklady

Toto rozšíření vyžaduje nejprve instalaci následujících balíčků:

Balík	Popis	Odkaz
ghostscript	Vykreslí obrázky stránky. Poskytuje příkaz gs.	www.ghostscript.com
imagemagick	Provádí dynamickou změnu velikosti a zobrazování miniatur obrázků. It provides the command convert.	www.imagemagick.org
xpdf-utils poppler-utils	Extracts metadata from PDF files. If you see "0 × 0 pixel" on the file description of a PDF, you lack this package. Poskytuje příkaz pdfinfo.	www.xpdfreader.com On Ubuntu and Debian, the "poppler-utils" package can be used instead of "xpdf-utils".

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

Pokud něco chybí, nainstalujte související balíčky. Příklad v Debianu a Ubuntu:

sudo apt install ghostscript imagemagick xpdf-utils

Pokud se vám tyto balíčky nedaří nainstalovat, obraťte se prosím na správce serveru ve vašem prostředí.

Instalace

Toto rozšíření je součástí MediaWiki 1.21 a vyšší. Zbývající konfigurační pokyny je stále nutné dodržovat.

• Před pokračováním se ujistěte, že je nainstalován požadovaný software!
• 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' );
  

• Vyžaduje nastavení v konfiguračním souboru. (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.

Konfigurace

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

Name	Default	Description
$wgPdfProcessor	"gs"	path to your ghostscript implementation
$wgPdfPostProcessor	"convert"	path to your imagemagick convert
$wgPdfInfo	"pdfinfo"	path to your pdfinfo
$wgPdftoText	"pdftotext"	path to your pdftotext
$wgPdfOutputExtension	"jpg"	preferred output format
$wgPdfHandlerDpi	"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	"95" (zavedeno od 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.

Ubuntu

This is identical to the default settings for this extension.

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

Debian

$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';

Windows

$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';

macOS

$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';

Řešení problémů

• 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, showing "0 × 0 pixels") you may need to use the PříručkaːÚdržbářské skripty refreshImageMetadata.php and/or rebuildImages.php. For example:

  $ php ./maintenance/run.php refreshImageMetadata --mime application/pdf --force
  

  Also try to purge the page of the file. See Příručka:Pročištění databáze .

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

Související odkazy

• http://wiki.4intra.net/PdfHandler — fork s mnohem rychlejším generováním miniatur pomocí pdftocairo místo ghostscriptu+imagemagick
• Extension:Proofread Page — lze použít ve spojení s PdfHandlerem
• Jak používat DjVu s MediaWiki
• Rozšíření PDFEmbde