worldwide open-source software

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
======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:
<code>
sudo apt-get install php5-gd
</code>
Также смотри [[https://www.dokuwiki.org/tips:phpwithgd|PHP with gd.]]
=====Монтаж=====
  * Используйте менеджер плагинов для установки или…
  - скачать zip-файл
  - распаковать его в<dokuwiki>/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]]: Если страницы ''<namespace>:start'' нет, то проверяется, существует ли пространство имен с названием ''<namespace>'', и добавляет его в 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''

и добавьте следующие строки:
<code php>
$this->setUserRights();
$this->SetProtection(array('print','copy', 'modify'),'password','password');
</code>

где ''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|эту страницу]] с вашего сайта, если вам нравится этот продукт.