DW2PDF для «ДокуВики»

Экспортирует страницы вики в формат PDF.

Задача плагина - создать простой и готовый работе конвертер PDF, который почти точно копирует экранное изображение ваших вики-страниц (то есть не конвертирует их в формат печатного документа, как плагин Latex). Он также объединяет в себе необходимые шрифты и библиотеки (отсюда размер 48 МБ), поэтому вам не нужно выполнять какие-либо настройки, чтобы запустить его.

• Релиз: 2019-06-19.
• Репозиторий:https://github.com/splitbrain/dokuwiki-plugin-dw2pdf
• Совместимость с «Докувики»: 04.04.2023 «Джек Джекрам»

Плагин не может быть установлен через менеджер плагинов в версиях вики, предшествующих Angua, потому что он слишком много весит, и менеджер плагинов потерпит неудачу при загрузке. Пожалуйста, установите его вручную и убедитесь, что установленный каталог называется dw2pdf.

Поддерживается только PHP 5.6 и новее для dw2pdf plugin.

Чтобы экспортировать изображения с альфа-каналом (используется для прозрачности), вам необходимо установить библиотеку GD для PHP. Пример для Debian:

sudo apt-get install php5-gd

Также смотри PHP with gd.

• Используйте менеджер плагинов для установки или…

1. скачать zip-файл
2. распаковать его в<dokuwiki>/lib/plugins/
3. войдите как администратор и измените плагин в менеджере конфигурации

• По ссылке:

Скопируйте адрес из ссылки «Скачать» из формы вверху этой страницы. Вставьте его в Менеджере Плагинов вашего сайта во вкладке «Ручная установка» в первое поле. Нажмите кнопку «Установить».

Существует три способа экспорта:

• Экспорт одной страницы
  Вам нужно открыть страницу с дополнительным параметром в URL: do=export_pdf. Начнется экспорт страницы в PDF. Некоторые вики-шаблоны позволяют плагину автоматически расширять pagetools. Для других шаблонов вам нужно самостоятельно добавлять кнопку или что-то подобное для быстрого вызова плагина.

• Экспорт всего пространства имен
  Существует параметр URL do=export_pdfns, который позволяет экспортировать выбранное целое пространство имен как один PDF (например, используйте &do=export_pdfns&book_ns=my:namespace&book_title=Mytitle (См. Параметры конфигурации о том, как исключить определенные страницы. Или создайте ссылку с синтаксисом).

• Экспорт выбранных страниц
  Если вам нужно выбрать только несколько страниц для экспорта в один PDF, вы можете использовать плагин Bookcreator, который предлагает интерфейс для плагина dw2pdf.

Использует PHP-библиотекуmPDF. Обрабатывает разные языки (в плагин входит большой, но относительно полный шрифт Unicode). Простая настройка верхних и нижних колонтитулов и CSS Автоматический индекс закладок Работает с плагином BookCreator для создания PDF из набора выбранных страниц.

Пожалуйста, ознакомьтесь со следующими страницами, чтобы узнать, как использовать или поддерживать плагин:

• Установите Опции конфигурации через URL или через Менеджер конфигурации
• Как добавить кнопку экспорта в pagetools/menu's
• Макет и настройка экспортированного PDF для вашего (корпоративного) шаблона
• Разработчики плагинов: Как поддерживать экспорт в PDF в вашем плагине

Чтобы создать ссылку на любой вики-странице для экспорта любого пространства имен, вы можете использовать следующий синтаксис:

~~PDFNS>namespace|pdftitle~~

• namespace - это пространство имен, которое вы хотите экспортировать
• pdftitle - заголовок будущего PDF
• Вы можете добавить дополнительные параметры (например, &book_order=pagename) просто добавив их в pdftitle.

Обработка startpages: Если страницы <namespace>:start нет, то проверяется, существует ли пространство имен с названием <namespace>, и добавляет его в PDF.

Пожалуйста, сообщайте о проблемах и запросах в трекере:
https://github.com/splitbrain/dokuwiki-plugin-dw2pdf/issues/

Если вы используете плагин dw2pdf и не получаете желаемый результат, вы можете исследовать данные во время его работы. Плагин dw2pdf использует HTML-код печатной версии статьи вики (стиль которого более скромный, чем у экранной версии) и преобразует этот код с библиотекой mPDF в pdf-файл.

Вот варианты работы с промежуточными результатами плагина:    - Используйте предпросмотр статьи через функцию предварительного просмотра вашего браузера.    - Выведите простой HTML для ручного тестирования или чтения.

Как вывести простой HTML (непосредственно перед его подачей в библиотеку mPDF):

1. Включите режим отладки вики с помощью настройки Параметр конфигурации: разрешенный отладка (также см. debugging)
2. Добавьте параметр url к URL-адресу, используемому для запуска экспорта в PDF-файл (скопируйте и измените ссылку на кнопку или URL-адрес, который вы используете):
   • При добавлении &debughtml=text HTML отображается в виде обычного текста в браузере.
   • При добавлении &debughtml=html отображается HTML, отрендеренный браузером.

См. Параметры отладки библиотеки mPDF, связанные с изображениями в mPDF: images documentation.

Картинки не всех форматов успешно встраиваются в PDF, даже если они отображаются в DokuWiki. Если в PDF отсутствуют изображения, попробуйте удалить альфа-канал из ваших (например, PNG) изображений.

   * Библиотека mPDF, используемая этим плагином для построения PDF, требует библиотеки GD для обработки изображений .png с альфа-каналами.

Если вы размещаете изображения через полные ссылки http, то убедитесь, что права доступа настроены для непосредственного получения изображения (тест в браузере). DokuWiki может запретить внешний доступ к изображениям в каталоге data/media.

Чтобы установить фиксированный пароль для сгенерированных документов, отредактируйте:

dokuwiki/lib/plugins/dw2pdf/mpdf/config.php

и добавьте следующие строки:

$this->setUserRights();
$this->SetProtection(array('print','copy', 'modify'),'password','password');

где password - ваш пароль :) (filips)

Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.

dokuwiki-plugin-dw2pdf-master.zip

• Author: Andreas Gohr and Gerrit Uitslag
• License: GNU GPL v2

Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на эту страницу с вашего сайта, если вам нравится этот продукт.