Difference between revisions of "PdfHandler/ru"

From Wiki4Intranet
Jump to: navigation, search
(TODO)
(Установка)
Line 22: Line 22:
 
== Установка ==
 
== Установка ==
  
* Нужно установить [http://pages.cs.wisc.edu/~ghost/ GhostScript] и [http://poppler.freedesktop.org/ Poppler] — бывший [http://www.foolabs.com/xpdf/ Xpdf] ([http://gnuwin32.sourceforge.net/packages/xpdf.htm windows)]
+
* Нужно установить [http://pages.cs.wisc.edu/~ghost/ GhostScript] и [http://poppler.freedesktop.org/ Poppler] бывший [http://www.foolabs.com/xpdf/ Xpdf] ([http://gnuwin32.sourceforge.net/packages/xpdf.htm windows)]
 +
** Ghostscript версии >= 8.70
 +
** От <tt>poppler</tt> должна быть утилита <tt>pdfinfo</tt> (возможно в вашем дистрибутиве она в отдельном пакете, например <tt>poppler-utils</tt>).
 
* Далее, как обычно, прописать {{cmd|require_once "$IP/extensions/PdfHandler/PdfHandler.php";}} в LocalSettings.php.
 
* Далее, как обычно, прописать {{cmd|require_once "$IP/extensions/PdfHandler/PdfHandler.php";}} в LocalSettings.php.

Revision as of 20:02, 15 February 2013

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.

Иногда (редко) может создавать проблемы — замечено, что ghostscript обрабатывает некоторые PDF’ки с большим трудом, потреблением дискового пространства на /tmp и процессорного времени. В нашей сборке это частично устранено.

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

  • Поддержка корректного определения ориентации страницы (с poppler >= 0.20).
  • Вставка миниатюр для всей PDF’ки разом.
  • Подкручены опции GhostScript для более качественного рендеринга.
  • Прямой выхлоп картинок из GhostScript без необходимости последующего масштабирования — улучшает производительность и уменьшает вероятность проблем с местом на диске и процессорным временем.

TODO

  • Доработки не оформлены в виде патчей. Нужно это исправить.

Установка

  • Нужно установить GhostScript и Poppler — бывший Xpdf (windows)
    • Ghostscript версии >= 8.70
    • От poppler должна быть утилита pdfinfo (возможно в вашем дистрибутиве она в отдельном пакете, например poppler-utils).
  • Далее, как обычно, прописать require_once "$IP/extensions/PdfHandler/PdfHandler.php"; в LocalSettings.php.