======DW2PDF для «ДокуВики»======
{{:wiki:plugin:dwplugin.png?70 |}} Экспортирует страницы вики в формат 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
Также смотри [[https://www.dokuwiki.org/tips:phpwithgd|PHP with gd.]]
=====Монтаж=====
* Используйте менеджер плагинов для установки или…
- скачать zip-файл
- распаковать его в/lib/plugins/
- войдите как администратор и измените плагин в менеджере конфигурации
* По ссылке:
Скопируйте адрес из ссылки «Скачать» из формы вверху этой страницы. Вставьте его в Менеджере Плагинов вашего сайта во вкладке «Ручная установка» в первое поле. Нажмите кнопку «Установить».
=====Применение=====
Существует три способа экспорта:
* **Экспорт одной страницы** \\ Вам нужно открыть страницу с дополнительным параметром в URL: ''do=export_pdf''. Начнется экспорт страницы в PDF. Некоторые вики-шаблоны позволяют плагину автоматически расширять [[plugin:dw2pdf:pagetools]]. Для других шаблонов вам нужно самостоятельно добавлять кнопку или что-то подобное для быстрого вызова плагина.
* **Экспорт всего пространства имен** \\ Существует параметр URL ''do=export_pdfns'', который позволяет экспортировать выбранное целое пространство имен как один PDF (например, используйте ''&do=export_pdfns&book_ns=my:namespace&book_title=Mytitle'' (См. [[wiki:plugin:dw2pdf:configuration|Параметры конфигурации]] о том, как исключить определенные страницы. Или создайте ссылку с [[#Syntax|синтаксисом]]).
* **Экспорт выбранных страниц** \\ Если вам нужно выбрать только несколько страниц для экспорта в один PDF, вы можете использовать плагин [[plugin:Bookcreator]], который предлагает интерфейс для плагина dw2pdf.
=====Практические рекомендации=====
=====Особенности=====
Использует PHP-библиотеку[[http://www.mpdf1.com/|mPDF]].
Обрабатывает разные языки (в плагин входит большой, но относительно полный шрифт Unicode).
Простая настройка верхних и нижних колонтитулов и CSS
Автоматический индекс закладок
Работает с плагином [[https://www.dokuwiki.org/plugin:bookcreator|BookCreator]] для создания PDF из набора выбранных страниц.
=====Конфигурация и настройки=====
Пожалуйста, ознакомьтесь со следующими страницами, чтобы узнать, как использовать или поддерживать плагин:
* Установите [[plugin:dw2pdf:configuration|Опции конфигурации]] через URL или через Менеджер конфигурации
* [[plugin:dw2pdf:pagetool|Как добавить кнопку экспорта в pagetools/menu's]]
* [[plugin:dw2pdf:pdftemplates|Макет и настройка экспортированного PDF для вашего (корпоративного) шаблона]]
* Разработчики плагинов: [[plugin:dw2pdf:exportsupport|Как поддерживать экспорт в PDF в вашем плагине]]
===== Синтаксис =====
Чтобы создать ссылку на любой вики-странице для экспорта любого пространства имен, вы можете использовать следующий синтаксис:
''%%~~PDFNS>namespace|pdftitle~~%%''
* ''namespace'' - это пространство имен, которое вы хотите экспортировать
* ''pdftitle'' - заголовок будущего PDF
* Вы можете добавить дополнительные параметры (например, ''%%&book_order=pagename%%'') просто добавив их в pdftitle.
Обработка [[config:startpages]]: Если страницы '':start'' нет, то проверяется, существует ли пространство имен с названием '''', и добавляет его в PDF.
===== Проблемы и запросы =====
Пожалуйста, сообщайте о проблемах и запросах в трекере: \\ https://github.com/splitbrain/dokuwiki-plugin-dw2pdf/issues/
==== Как собрать больше информации для отладки? ====
Если вы используете плагин dw2pdf и не получаете желаемый результат, вы можете исследовать данные во время его работы. Плагин dw2pdf использует HTML-код печатной версии статьи вики (стиль которого более скромный, чем у экранной версии) и преобразует этот код с библиотекой mPDF в pdf-файл.
Вот варианты работы с промежуточными результатами плагина:
- Используйте предпросмотр статьи через функцию предварительного просмотра вашего браузера.
- Выведите простой HTML для ручного тестирования или чтения.
**Как** вывести простой HTML (непосредственно перед его подачей в библиотеку mPDF):
- Включите режим отладки вики с помощью настройки [[config:allowdebug]] (также см. [[devel:debugging]])
- Добавьте параметр url к URL-адресу, используемому для запуска экспорта в PDF-файл (скопируйте и измените ссылку на кнопку или URL-адрес, который вы используете):
* При добавлении ''&debughtml=text'' HTML отображается в виде обычного текста в браузере.
* При добавлении ''&debughtml=html'' отображается HTML, отрендеренный браузером.
См. Параметры отладки библиотеки mPDF, связанные с изображениями в mPDF: [[https://mpdf.github.io/what-else-can-i-do/images.html|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 и установите новую версию, как указано выше.
=====Файл для загрузки=====
{{ :wiki:plugin:dokuwiki-plugin-dw2pdf-master.zip |}}
=====Лицензия=====
* **Author:** [[andi@splitbrain.org, klapinklapin@gmail.com |Andreas Gohr and Gerrit Uitslag]]
* **License:** [[http://www.opensource.org/licenses/gpl-license.php|GNU GPL v2]]
Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на [[https://www.dokuwiki.org/plugin:links4pages#links4pages_plugin|эту страницу]] с вашего сайта, если вам нравится этот продукт.