.. /* * This file is part of the SavaPage project . * Copyright (c) 2026 Datraverse B.V. * Author: Rijk Ravestein. * * SPDX-FileCopyrightText: (c) 2020 Datraverse B.V. * SPDX-License-Identifier: CC-BY-SA-4.0 * * For more information, please contact Datraverse B.V. at this * address: info@datraverse.com */ .. _ch-webapp-user-main-pdf: PDF --- .. contents:: Table of Contents :depth: 2 :local: Overview ~~~~~~~~ A *tap* on the |RST_BUTTON_PDF| button in the main SafePages view shows a dialog with PDF properties and export actions. See :ref:`SafePages `. .. note:: All PDF properties (except Passwords) are preserved when the dialog is closed or a PDF is generated, and are re-used when needed in current or future sessions. .. figure:: ../images/manual/screenshots/user/sp-01-02-user-pdf.png :width: 400 User Web App: PDF - Overview This screenshot above shows the full PDF dialog. - The |RST_GUILABEL_AUTHOR| defaults to the name of the authenticated user at login, and can be edited. - Details are discussed at: - :ref:`PDF Filters ` - :ref:`Links ` - :ref:`Document Scope `. - :ref:`Description ` - :ref:`Security ` - :ref:`Passwords ` - :ref:`Letterhead ` - :ref:`Download ` - :ref:`Send ` - A selection of SafePages to incorporate into the PDF output can be entered as a range of |RST_GUILABEL_PAGES|. For example: ``1-4,6,8-10``. The value can be a single page, a range of pages, or a collection of page numbers and ranges separated by commas. The pages will always be exported in ascending order, regardless of the order of the pages in the page-ranges option. The page range is automatically emptied after printing. Be aware that the page ordinals are related to the :ref:`Document Scope `. - Check one of the :ref:`PDF Filters ` |RST_CHECKBOX_ECOPRINT| or |RST_CHECKBOX_REMOVE_GRAPHICS|. Additionally check |RST_CHECKBOX_GRAYSCALE| and/or |RST_CHECKBOX_RASTERIZE|. - You can activate a |RST_CHECKBOX_DESCRIPTION|, |RST_CHECKBOX_SECURITY| and |RST_CHECKBOX_PASSWORDS| setting by toggling the corresponding button in the so-called **Apply** section. A toggle button is disabled if no setting is specified. .. note:: SavaPage tries to translate URL formatted text like *www.example.com* and *info@example.com* to PDF links. Implicit URLs in the source document, such as those contained in text like *click here*, are not sent to the SavaPage printer, and therefore not preserved in the PDF document. .. _ch-webapp-user-main-pdf-filters: PDF Filters ~~~~~~~~~~~ Activate *either* the |RST_CHECKBOX_ECOPRINT| or |RST_CHECKBOX_REMOVE_GRAPHICS| filter option. The last option removes all graphic images from the PDF. When choosing |RST_CHECKBOX_ECOPRINT| the selected SafePages will be ad-hoc converted in the background. While conversion is busy a message box will tell you to wait a while and retry later. Take about 3 seconds per page waiting time into consideration. Automatic filtering may help to diminish waiting times: see :ref:`Eco Print Settings `. |RST_CHECKBOX_GRAYSCALE| and |RST_CHECKBOX_RASTERIZE| filters can be selected as extra. The |RST_CHECKBOX_RASTERIZE| filter creates an image of each PDF page. The DPI can be set with the following configuration properties: .. list-table:: PDF Rasterize Filter: Configuration Properties :width: 100% :header-rows: 1 * - Configuration property - Description * - pdf-out.convert.rasterize.dpi.download - | DPI of rasterized PDF for |RST_BUTTON_DOWNLOAD| . Enum values: | ``DPI_100``, ``DPI_150``, ``DPI_200``, ``DPI_300`` (default), ``DPI_600`` * - pdf-out.convert.rasterize.dpi.email - | DPI of rasterized PDF Send by email. Enum values: | see above. See |RST_LINK_CONFIG_EDITOR| on how to change these properties. .. _ch-webapp-user-main-pdf-links: Links ~~~~~ If the |RST_CHECKBOX_LINKS| option is checked, PDF text recognized as URI is annotated as PDF link and optionally underlined with a thickness and color of your choice. Select “Invisible” to hide underlining. .. figure:: ../images/manual/screenshots/user/sp-01-02-user-pdf-links.png :width: 400 User Web App: PDF - Links .. _ch-webapp-user-main-pdf-scope: Document Scope ~~~~~~~~~~~~~~ .. figure:: ../images/manual/screenshots/user/sp-01-02-user-pdf-scope.png :width: 400 User Web App: PDF - Document Scope - When pressing the |RST_GUILABEL_DOCUMENT| dropdown you get a selection pop-up with titles of acquired SavaPage print jobs. *Tap* a job title to restrict the scope of the PDF output to that job. Select the top item All Documents to activate *full* scope. - If *full* scope is selected the |RST_GUILABEL_PAGES| ordinals are related to the SafePages total. When a job is selected as scope, the page ordinals are related to the page total of the job. - Selecting a scope initializes the |RST_GUILABEL_TITLE| text with the job name, or clears it when you choose full scope. You can edit the |RST_GUILABEL_TITLE| if you wish. - If there is just a *single* acquired SavaPage print job, this job is shown as only option. .. note:: If a user :ref:`rearranged or deleted ` any SafePages the scope is confined to *full* scope. .. _ch-webapp-user-main-pdf-description: Description ~~~~~~~~~~~ .. figure:: ../images/manual/screenshots/user/sp-01-02-user-pdf-description.png :width: 400 User Web App: PDF - Description - Press the |RST_COLLAPSIBLE_HEADING_DESCRIPTION| button to expand the section. - Enter the |RST_GUILABEL_SUBJECT| and (space separated) |RST_GUILABEL_KEYWORDS| of the PDF document. .. note:: If a |RST_GUILABEL_SUBJECT| or |RST_GUILABEL_KEYWORDS| are entered, the |RST_CHECKBOX_DESCRIPTION| toggle in the **Apply** section will be enabled. Use this toggle to apply (or deny) the |RST_GUILABEL_SUBJECT| to the generated PDF. .. _ch-webapp-user-main-pdf-security: Security ~~~~~~~~ Press the Security button to expand the section. .. figure:: ../images/manual/screenshots/user/sp-01-02-user-pdf-security.png :width: 400 User Web App: PDF - Security If the :ref:`OpenPGP Key Pair ` is present on the server, users who have the :ref:`Privilege to Sign ` will see the |RST_CHECKBOX_SIGN| option, When selected, an :ref:`OpenPGP Signature ` is applied to the generated PDF. If the |RST_CHECKBOX_ENCRYPTION| option is selected the Actions allowed for the generated PDF are shown. Use the Allow all or Allow none buttons to select the actions in one go. Or select each allowed action separately. This is a list with the allowed actions, each with a short description: - *Printing*: Printing the document. - *Degraded Printing*: same as *Printing*, but with a lower quality. - *Page Extraction*: Modifying the contents. For example, changing the contents of a page, or inserting or removing a page. - *Commenting*: Adding or modifying text annotations. - *Document Assembly*: Inserting, removing, rotating and bookmarking pages. The content can't be changed, unless *Page Extraction* is also selected. - *Content Copying*: Copying or otherwise extracting text and graphics from the document, This also applies for screen readers or other accessibility devices. - *Content Copying for Accessibility*: Extracting text and graphics for use by accessibility devices. .. note:: SavaPage uses 128-bit PDF encryption. If |RST_CHECKBOX_SIGN| or |RST_CHECKBOX_ENCRYPTION| is selected, the |RST_CHECKBOX_SECURITY| toggle in the **Apply** section will be enabled. Use this toggle to apply (or deny) the security settings to the generated PDF. .. _ch-webapp-user-main-pdf-passwords: Passwords ~~~~~~~~~ .. figure:: ../images/manual/screenshots/user/sp-01-02-user-pdf-passwords.png :width: 400 User Web App: PDF - Passwords - The *User* password (also known as the *open password*) locks the PDF file for anyone who doesn't know the password. - The *Owner* password (also known as the *permissions password*) is needed to read the PDF file in order to change the permissions. - The maximum password length is 32 characters. - If you don't enter a user password, all users will be able to open the PDF document without being prompted for a password. However, the security settings will remain in place. - If both PDF user and owner password are entered they must be different. .. important:: If a User password is set or Security settings are active, and the Owner password is *not* set, SavaPage will replace it with a random string. .. warning:: Security settings *without* a User password aren't really secure, since the encryption key is derived from the User password. If the User password is omitted, the content is encrypted as described in the public PDF reference, so decryption is also known in this case (although illegal to practice). .. note:: If a User or Owner password is entered, the |RST_CHECKBOX_PASSWORDS| toggle in the **Apply** section will be enabled. Use this toggle to apply (or deny) the passwords to the generated PDF. .. note:: Passwords are **not** preserved when the dialog is closed or a PDF is generated, so they can **not** be re-used in current or future sessions. .. _ch-webapp-user-main-pdf-letterhead: Letterhead ~~~~~~~~~~ .. _ss-user-pdf-letterhead: .. figure:: ../images/manual/screenshots/user/sp-01-02-user-pdf-letterhead.png :alt: User Web App: PDF - Letterhead :width: 400 User Web App: PDF - Letterhead - When pressing the |RST_GUILABEL_LETTERHEAD| dropdown you get a selection pop-up with available Letterheads. - *Tap* on a letterhead title to select it, or select the top item *dash* to deselect a letterhead. .. note:: - Depending on :ref:`User Privileges ` the Letterhead section might not be shown. - Letterheads are not subjected to :ref:`PDF Filters ` but are applied to the filtered result. .. _ch-webapp-user-main-pdf-download: Download ~~~~~~~~ - Press the |RST_BUTTON_DOWNLOAD| button to download the SafePages as PDF file, with the properties set in this dialog. - Your browser will present a Save dialog so you can save the PDF file in the location of your choice. - The default PDF file name will be identical to the |RST_GUILABEL_TITLE| you entered as PDF property. .. note:: Depending on :ref:`User Privileges ` the |RST_BUTTON_DOWNLOAD| button might not be shown. .. _ch-webapp-user-main-pdf-send: Send ~~~~ A *tap* on the |RST_BUTTON_SEND| button in the PDF dialog, shows this Send dialog. See :ref:`PDF `. .. figure:: ../images/manual/screenshots/user/sp-01-02-user-pdf-send.png :width: 400 User Web App: PDF - Send - Enter the Email address of the recipient. - The last used Email address is shown. Press the |RST_BUTTON_DEFAULT| button to reset the address to the one that belongs to the logged in user. - Press the |RST_BUTTON_SEND| button to generate the PDF document and send it as attachment to the recipient. .. note:: Depending on :ref:`User Privileges ` the |RST_BUTTON_SEND| button might not be shown.