This Polarion extension provides possibility to convert Polarion Documents to PDF files.
-This is an alternative to native Polarion's solution.
-The extension uses WeasyPrint as a PDF engine and requires it either to be installed as a system's command-line tool or to run from Docker container (as CLI or as Service, see below).
- -To run WeasyPrint as a system's command-line tool specify following properties in file <POLARION_HOME>/etc/polarion.properties:
-
-ch.sbb.polarion.extension.pdf-exporter.weasyprint.connector=cli
-ch.sbb.polarion.extension.pdf-exporter.weasyprint.executable=weasyprint
-ch.sbb.polarion.extension.pdf-exporter.weasyprint.pdf.variant=pdf/a-2b
-
-
-
-And then install WeasyPrint. On Linux system it can be done following way:
-
-
-pip install weasyprint
-
-
-For more information on WeasyPrint Installation see these instructions
- -This extension supports using WeasyPrint running in Docker container. This feature can be switched on with help of following properties in file <POLARION_HOME>/etc/polarion.properties:
-
-ch.sbb.polarion.extension.pdf-exporter.weasyprint.connector=cli
-ch.sbb.polarion.extension.pdf-exporter.weasyprint.executable=docker run --interactive --rm docker.io/library/weasyprint:61.2
-ch.sbb.polarion.extension.pdf-exporter.weasyprint.pdf.variant=pdf/a-2b
-
-
-
-This extension supports using WeasyPrint running as a REST Service in Docker container. This feature can be switched on with help of following properties in file <POLARION_HOME>/etc/polarion.properties:
-
-ch.sbb.polarion.extension.pdf-exporter.weasyprint.connector=service
-ch.sbb.polarion.extension.pdf-exporter.weasyprint.service=http://localhost:9080
-ch.sbb.polarion.extension.pdf-exporter.weasyprint.pdf.variant=pdf/a-2b
-
-
-
-The converting HTML can contain some external CSS links referencing Polarion Server, like:
-
-
-<link rel="stylesheet" href="/polarion/diff-tool-app/ui/app/_next/static/css/3c374f9daffd361a.css" data-precedence="next">
-
-
-In case the Polarion Server is not reachable from the Weasyprint service, such links cannot be successfully resolved during the Weasyprint PDF transformation.
- The solution is to replace external CSS <link> elements with internal CSS <style> tags containing the CSS content embedded into the HTML document.
- By default, CSS link internalization is disabled. To enable internalization of CSS links, it is necessary to activate the following property in file <POLARION_HOME>/etc/polarion.properties:
-
-ch.sbb.polarion.extension.pdf-exporter.internalizeExternalCss=true
-
-
-
-
-sections-element:
-
-
-…
-<sections>
- <section id="fields"/>
- …
-</sections>
-…
-
-
-
-
-…
-<extension id="pdf-exporter" label="PDF Exporter" />
-…
-
-
- Alternatively you can configure PDF Exporter such a way that additional toolbar will appear in document's editor with a button to open a popup with PDF Exporter view.
-
-
-scriptInjection.dleEditorHead=<script src="/polarion/pdf-exporter/js/starter.js"></script><script>PdfExporterStarter.injectToolbar();</script>
-
-
- There's an alternate approach adding PDF Exporter button into native Polarion's toolbar, which has a drawback at the moment -
- button disappears in some cases (for example when document is saved), so using this approach is not advisable:
-
-
-scriptInjection.dleEditorHead=<script src="/polarion/pdf-exporter/js/starter.js"></script><script>PdfExporterStarter.injectToolbar({alternate: true});</script>
-
-
- Live Reports also can be converted to PDF with help of this extension.
-First of all you need to inject appropriate JavaScript code into Polarion:
-
-
-scriptInjection.mainHead=<script src="/polarion/pdf-exporter/js/starter.js"></script>
-
-
- Then open a project, its Live Report you wish to export, and click "Expand Tools" on top of the page. - As a result report's toolbar will appear. Click "Edit" button in a toolbar, as a result the report will be switched into an edit mode. Add an empty region on top - of the report, place cursor there, choose "Generic" tag on "Widgets" sidebar on right hand side of the page, find "Export to PDF Button" widget there and click it - to add to the report. Then save a report clicking 💾 in a toolbar and then return to a view mode clicking "Back" button. When you click "Export to PDF" button just added - to the report, PDF Exporter view will be opened in a popup and you will be able to proceed with exporting the report to PDF. Be aware that in report's context limited - set of properties are available for configuration in PDF popup, the rest of them are relevant only in Live Document context.
- -For better problem analyses extended logging can be configured in Polarion. By default, Polarion log level is set to INFO. It can be changed to debug in log4j2.xml file.
- Find /opt/polarion/polarion/plugins/com.polarion.core.util_<version>/log4j2.xml file and add the following line into Loggerssection:
-
-<Logger name="ch.sbb.polarion.extension" level="debug"/>
-
-
-
-It is also possible to write all messages of SBB extensions info separate log file which can be useful to report a problem. In this case new Appender should be added:
-
-<RollingFile name="SBB" fileName="${sys:logDir}/log4j-sbb${fileNameSuffix}" filePattern="${sys:logDir}/log4j-sbb${filePatternSuffix}">
- <PatternLayout pattern="${layoutPattern}"/>
- <Policies>
- <TimeBasedTriggeringPolicy interval="1"/>
- </Policies>
-</RollingFile>
-
-
-and the following Logger:
-
-<Logger name="ch.sbb.polarion.extension" level="debug">
- <AppenderRef ref="SBB"/>
-</Logger>
-
-
-
-Cross-Origin Resource Sharing could be enabled using standard configuration of Polarion REST API. In <POLARION_HOME>/etc/polarion.properties the following lines should be added:
-
-com.siemens.polarion.rest.enabled=true
-com.siemens.polarion.rest.cors.allowedOrigins=http://localhost:8888,https://anotherdomain.com
-
-
-
-This extension makes intensive HTML processing to extend similar standard Polarion functionality. There is a possibility to log
- original and resulting HTML to see potential problems in this processing. This logging can be switched on (true value)
- and off (false value) with help of following property in file <POLARION_HOME>/etc/polarion.properties:
-
-ch.sbb.polarion.extension.pdf-exporter.debug=true
-
-
-
-If HTML logging is switched on, then in standard polarion log file there will be following lines:
-
-
-2023-09-20 08:42:13,911 [ForkJoinPool.commonPool-worker-2] INFO ch.sbb.polarion.extension.pdf.exporter.util.HtmlLogger - Original HTML fragment provided by Polarion was stored in file /tmp/pdf-exporter10000032892830031969/original-4734772539141140796.html
-2023-09-20 08:42:13,914 [ForkJoinPool.commonPool-worker-2] INFO ch.sbb.polarion.extension.pdf.exporter.util.HtmlLogger - Final HTML page obtained as a result of PDF exporter processing was stored in file /tmp/pdf-exporter10000032892830031969/processed-5773281490308773124.html
-
-
-Here you can find out in which files HTML was stored.
- -PDF Export. There are 5 sub-menus with different configuration options for PDF Exporter.Quick Help section available with option short description. For the rest 2
- (Style package, Stylesheets) there's no Quick Help section, but their content is self-evident.
- Save button.PDF Exporter block and click Export to PDF.
- For the options details please refer plugin documentation.
- Weasyprint doesn't fully support all SVG features. One of the most frequently used feature by Polarion which isn't supported by Weasyprint is 'foreignObject' - element. This leads to some visual bugs in resulting pdf (missing font colors, rich text formatting etc.)
- -Usage of WeasyPrint as Service in Docker (see above) is suggested. It has built-in SVG to PNG images conversion using Chromium browser (which supports more SVG features, including foreignObjects).
- In version 5.0.0 not only label of configuration parameter "Fit images and tables to page width" was modified to be "Fit images and tables to page", - but also underlying parameter was renamed to reflect this change. As a result if you had "Fit images and tables to page width" ticked in your configuration prior to version 5.0.0, - after installation of this version you will have to go to configuration again and re-tick property "Fit images and tables to page", both on global repository level and on level of projects. -
-- Another change is default CSS which was modified to reflect different possible paper sizes as well as additional styling for images to jump into next page if they can't be fully displayed on current one. - Thus please either reset your saved CSS into last version if you didn't have your own CSS definitions or merge your saved version with new default version. -
\ No newline at end of file diff --git a/src/main/resources/webapp/pdf-exporter-admin/pages/about.jsp b/src/main/resources/webapp/pdf-exporter-admin/pages/about.jsp index 7371b4b..20834f8 100644 --- a/src/main/resources/webapp/pdf-exporter-admin/pages/about.jsp +++ b/src/main/resources/webapp/pdf-exporter-admin/pages/about.jsp @@ -28,7 +28,7 @@