Предыдущий разработчик: Luigi Micco

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

Подробности

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

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

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

sudo apt-get install php5-gd

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

• Merge pull request #505 from dokuwiki-translate/lang_update_820_17078… (2024-03-05 09:15)
• translation update (2024-02-13 13:40)
• Version upped (2023-11-25 23:50)
• Merge pull request #500 from splitbrain/bot/autofix (2023-11-25 15:28)
• 🤖 Automatic code style fixes (2023-11-25 13:42)
• Version upped (2023-11-08 23:50)
• Merge pull request #499 from eduardomozart/master (2023-11-08 21:17)
• Replace mPDF ImageProcessor with DW2PDF one (2023-11-07 15:34)

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

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

С июля 2017 года включена версия 7.0-бета библиотеки mPDF, которая поддерживает PHP7, но не PHP 5.4 и старше.

В качестве (временного) отступления могут быть найдены следующие старые релизы:

• С 11 июня 2015 года была включена версия 6.0 библиотеки mPDF. Это должно значительно улучшить возможности рендера. Однако могут быть и регрессии.
  Релиз основан на предыдущей версии mPDF 6.0 – dw2pdf Plugin with mPDF 6.0.0.zip (50 MB)
• Релиз основан на предыдущей версии mPDF 5.7.4 – dw2pdf Plugin with mPDF 5.7.4.zip (12 MB)

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

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

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

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

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

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

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

Не стесняйтесь добавлять свои сайты тоже

• BLËSK User Guide (English)
• Financial accounting - webshop - interface (German)
• Handbuch HiOrg-Server (German)
• LaCie user manuals
• Mundoaz - Satellite Decoders (Portuguese)
• PKUinfo: Informazioni, domande e risposte sulla fenilchetonuria
• Prinz Eisenherz - Prince Valiant - Lexikon - Encyclopedia
• QEM srl manuals (Italian)
• Wiki Kantuz

Not all image format variations are successfully embedded in the PDF, even if they are properly displayed in DokuWiki. If you get missing images in your output, try stripping the Alpha channel of your (e.g. PNG) images.

• The mPDF library used by this plugin for building the pdf requires the GD library for processing .png images with alpha channels.

If using full http links, make sure the permissions are set up for retrieving the image directly (test in a browser). DokuWiki may prevent outside access to images in the data/media directory.

Картинки не всех форматов успешно встраиваются в 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)