Reference:BlueSpiceUEModuleBookPDF: Difference between revisions

hw>Mlink-rodrigue
No edit summary
 
m (1 revision imported)

Revision as of 11:34, 20 December 2021

Extension: BlueSpiceUEModuleBookPDF

all extensions

Overview
Description:

Enables BlueSpice export hierarchical collections of articles to Adobe® Portable Document Format (PDF).

State: stable Dependency: BlueSpice
Developer: HalloWelt License: GPL-3.0-only
Type: BlueSpice Category: Book
Edition: BlueSpice pro, BlueSpice Farm"BlueSpice Farm" is not in the list (BlueSpice free, BlueSpice free (deactivated), BlueSpice pro, BlueSpice pro (deactivated), BlueSpice farm, BlueSpice farm (deactivated), BlueSpice cloud, BlueSpice cloud (deactivated)) of allowed values for the "BSExtensionInfoEdition" property., BlueSpice Cloud"BlueSpice Cloud" is not in the list (BlueSpice free, BlueSpice free (deactivated), BlueSpice pro, BlueSpice pro (deactivated), BlueSpice farm, BlueSpice farm (deactivated), BlueSpice cloud, BlueSpice cloud (deactivated)) of allowed values for the "BSExtensionInfoEdition" property. Version: 4.1+

Features

UEModuleBookPDF export books to PDF format.

  • Creates a PDF book based on the data from the Universal Export.
  • Underlying is an HTML / PHP template, which is also customizable by the user.
  • Metadata is embedded in the PDF.
  • Numbering of chapters and the table of contents is generated.
  • Files are attached.
  • The pages of the PDF Book are printed on the model of the PDF single pages.
  • When exporting a title page and a table of contents should be generated.
    • The cover sheet contains company logo and date of creation and is freely designable.
    • The table of contents is generated automatically, is clickable and allows the direct jump to the desired position within the document.
  • In addition, a summary of the changes under the term "last changes" will appear. It contains the relevant changes (ie not minor changes in the system) of the articles within the last two years. If required, the date (format: dd.mm.yyyy, sort order descending), article name and change note of the released statuses should appear.
  • References to uploaded documents are included in the PDF book as an attachment ("merge" in the sense of readable articles and non-attachment). Footnotes from wiki articles should be placed at the end of the PDF page and should not appear at the end of the article.
  • Breakthroughs of text, tables and images are intelligent to implement (not a single line of a new paragraph as the last line of a page, on the following page continuous tables get the table header again, images are only on one page to represent).
  • As the chapter numbering is shown in the header, a page break is required when changing to another chapter.
  • Hyperlinks are clickable and refer to the desired position within the document (also applies to attachments), external links are included in the pdf as a hyperlink.

Some aspects of this extension can be configured on Special:BlueSpiceConfigManager, under section "Universal export PDF module". Here wiki administrators can configure:

  • How Table of content should be shown.

Technical Information

This information applies to BlueSpice 4. Technical details for BlueSpice cloud can differ in some cases.

Requirements

  • MediaWiki: 1.39.0
  • BlueSpiceBookshelf: 4.3

BlueSpiceFoundation: 4.3 BlueSpiceUEModulePDF: 4.3 BlueSpiceUniversalExport: 4.3

Integrates into

  • BlueSpiceBookshelf
  • BlueSpiceUniversalExport

Special pages

Permissions

Name Description Role
uemodulebookpdf-export Export a page to PDF as part of a book reader

Configuration

Name Value
UEModuleBookPDFBookExportTOC 'only-articles'
UEModuleBookPDFDefaultTemplate 'BlueSpice Book'
UEModuleBookPDFExportDialogExcludeTemplates array ( )
UEModuleBookPDFTemplatePath 'extensions/BlueSpiceUEModuleBookPDF/data/PDFTemplates'

Hooks