PdfHandler/ru

From Wiki4Intranet
Jump to: navigation, search

PdfHandler — расширение MediaWiki.

  • Назначение: Медиаобработчик для PDF-файлов. То есть, поддержка загрузки PDF’ок, их постраничного просмотра и вставки страниц PDF как изображений.
  • Репозиторий: https://github.com/mediawiki4intranet/PdfHandler
  • Домашняя страница: PdfHandler на mediawiki.org
  • Лицензия: GPLv2.0+ 
  • Дата создания: 2007-08-18 
  • Оценка расширения: Очень полезное (5)

Включение в сборку Mediawiki4Intranet:

  • Дата включения: 2009-10-25
  • Включённая версия: последняя
  • Состояние доработок: Значительно доработано в сборке MediaWiki4Intranet

Использование

PdfHandler — медиаобработчик для PDF-файлов. После установки PDF-ки становится можно загружать в вики так же, как обычные картинки. При этом работает постраничный просмотр, а также любую страницу можно вставить как изображение с помощью синтаксиса [[File:Book.pdf|page=2]].

В нашей сборке можно вставить всю PDF’ку в уменьшенном варианте разом, с помощью [[File:Book.pdf|page=-]]. Полезно, например, для вставки презентаций, сохранённых в PDF.

Наши доработки

  • Использование Poppler вместо GhostScript для отрисовки PDF — Poppler работает на порядок (примерно в 8-10 раз) быстрее, а также гораздо качественнее сглаживает шрифты. Кроме того,
  • Поддержка корректного определения ориентации страницы (с poppler >= 0.20 или патчем).
  • Вставка миниатюр для диапазона страниц или для всей PDF’ки разом.

TODO

  • При вставке диапазона страниц проверяется наличие только первой. Из-за этого, если вставить сначала меньший диапазон страниц, а потом больший, но начинающийся с той же страницы, часть страниц не будет отображена. Нужно добавить проверку наличия всех файлов.

Установка

Нужно установить Poppler, он же бывший Xpdf (windows).

От poppler должны быть установлены утилиты pdfinfo и pdftocairo. Возможно, в вашем дистрибутиве Linux они выделены в отдельный пакет, например, в Debian это poppler-utils.

Далее, как обычно, прописать в LocalSettings.php:

require_once "$IP/extensions/PdfHandler/PdfHandler.php";