Skip to main content

PDF Document Properties and Metadata

PDFs have document properties that, when viewed in Adobe® Acrobat®, are shown on the Document Properties dialog.

Document Properties in Adobe Acrobat. The dialog has many tabs with metadata about the document.

To include this information in the PDFs you publish in Paligo, you will need to set up the publication topic and make some choices in the PDF layout.

Note

When you publish to PDF, you choose a PDF layout to use. Paligo creates the PDF document properties based on your choices in the PDF layout settings. But these properties may not be used by all PDF viewers. For example, copyright information is included in the full Adobe Acrobat, but may not appear in other PDF viewer applications.

PDF document properties include a title, subject, keywords, and author information. In Paligo, this information is taken from specific elements that you can add to your publication topic. (Unlike many of the other document properties, which you can set in the PDF layout).

Note

The structures for author, subject, and keywords are optional. You do not have to include them.

To add the appropriate elements and structure in the publication topic:

Note

You can have other elements in the Publication Topic, such as copyright, but these are not used for the PDF document properties. For copyright details, Set PDF Copyright Metadata and Set the PDF Version.

  1. Select the Dotted Menu (...) for the publication in Content Manager.

    OpenInEditor_small.png
  2. Select Edit and choose Open in editor.

    Publication topic. It contains certain info elements by default.

    Paligo opens the publication topic.

  3. Define the title.

    The title for your PDF properties comes from the title inside the info element, for example:

      <info>
        <title>Acme 200X User Guide</title>

    Enter the text you want for the title inside the title element.

    Note

    If the document is translated into other languages, translations of the title will also appear. They are separated by a bullet point.

  4. Define the subject.

    Select the position after the title but before the next element.

    Close up of the Paligo editor for the publication page. The element structure menu shows article > info and an arrow points at the space between the title and the first line.

    Use the element context menu to add the subjectset element.

    When you have added the subjectset element, select it and then use the element context menu to add the subject element. Then select the subject element and add the subjectterm element. Enter your subject text inside the subjectterm element.

     <subjectset>
          <subject>
            <subjectterm>User guide for the Acme 200X series</subjectterm>
          </subject>
     </subjectset>

    Note

    You can add multiple subject elements inside a subjectset, if required. The subjects will all be shown in the PDF document properties, separated by a comma.

  5. Define the keywords.

    Select the position after the closing subjectset element. In the element structure menu, you should see that the cursor is positioned at article > info.

    Close up of Paligo editor. The element structure menu shows article > info. An arrow points to the cursor position which is after the closing subjectset element.

    Use the element context menu to add the keywordset element. Then select the keywordset element and add the keyword element.

    Enter the text for the keyword. This text should describe one of the main concepts covered in the content.

    To add more keywords, select the position below the keyword, but above the next element. Then use the element context menu to add another keyword element.

    Close up of Paligo editor. The element structure menu shows article > info > keywordset. An arrow points to the cursor position between a keyword and the next element.
     <keywordset>
          <keyword>Acme 200X</keyword>
          <keyword>Acme 200Xe</keyword>
          <keyword>Acme 200Xs</keyword>
        </keywordset>
  6. Define the author.

    Select the position after the last element, so that the element structure menu shows the position as article > info. Then use the element context menu to add either the author element or the editor element. Paligo will use the first one of these it finds in the publication topic and map it to the author property of the PDF.

    Select the author or editor element and then add the personname, honorific, firstname, surname, and othernameelements.

    The following examples show the correct structure and order for these elements:

     <author>
          <personname>
            <honorific>Dr</honorific>
            <firstname>Sergio</firstname>
            <surname>Alvarez</surname>
            <othername>F</othername>
          </personname>
    </author>
    <editor>
          <personname>
            <honorific>Dr</honorific>
            <firstname>Sergio</firstname>
            <surname>Alvarez</surname>
            <othername>F</othername>
          </personname>
    </editor>
  7. Select Save. Save icon.

Paligo supports many different PDF standards. For your publications, you can use the PDF Layout to choose which PDF standard Paligo should use.

  1. Select Layout in the top menu.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.

  2. Select the PDF Layout you are going to use for publishing. Alternatively, create a new one (see Create a Layout).

  3. Select General in the sidebar.

  4. Select PDF Properties.

  5. Use the PDF Version setting to choose the PDF standard.

    PDF Layout. PDF Version setting. It has a drop-down menu for choosing one of the PDF versions. The default is PDF 1.7, unless the Layout is inheriting a value from another Layout.

    Choose from:

    • PDF 1.3

    • PDF 1.4

    • PDF 1.5

    • PDF 1.6

    • PDF 1.7

    • PDF 1.5 UA-1:2014

    • PDF 1.6 UA-1:2014

    • PDF 1.7 UA-1:2014

    For an output that complies with accessibility standards, choose a version that ends with UA-1:2014. You will also need to enable Generate Tagged PDF, which is in the General category's Misc settings.

    There are many online resources that provide information about the different standards, such as https://www.prepressure.com/pdf/basics/version and https://pdfa.org/pdfx-and-the-other-pdf-standards.

    Note

    Choosing the Default option means you will get PDF 1.7 unless your Layout is a "child" to a "parent" Layout. If it is a "child" and has the Default setting, it will inherit the PDF Version from its "parent" Layout. To learn more, see Layout Relationships - Base, New, Duplicate.

  6. Select Save.

When you publish with this PDF Layout, Paligo will publish a PDF that complies with your chosen PDF standard.

Use the General > PDF Properties settings to control the PDF page mode, page layout, and UI preferences such as whether the toolbar is shown. These settings affect how the PDF is presented in the initial view when it is first opened.

  1. Select Layout in the top menu.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.

  2. Select the Layout you want to update or Create a Layout.

    Tip

    You can copy the URL of the Layout Editor and paste it into a new tab in your browser. This can be useful if you frequently switch between your Paligo content and the Layout settings.

  3. Select General > PDF properties.

    PDF Layout. The General > PDF properties are shown and there are fields and drop-down lists to make selections.
  4. Set the Page Mode that will be used when the document is first opened.

    Choose from:

    • UseNone - The document outline and thumbnail images are hidden.

    • UseOutlines - The document outline is shown.

    • UseThumbs - Thumbnail images are shown.

    • FullScreen - The document is shown at full screen size, with no visible menu bar or window controls.

  5. Set the Page Layout that will be used when the document is first opened.

    Choose from:

    • SinglePage - Show one page at a time.

    • OneColumn - Show the pages in one column.

    • TwoColumnLeft - Show the pages in two columns, with odd-numbered pages on the left

    • TwoColumnRight - Show the pages in two columns, with odd-numbered pages on the right

    • TwoPageLeft - Show two pages at the same time, with odd-numbered pages on the left

    • TwoPageRight - Show two pages at the same time, with odd-numbered pages on the right.

  6. Use Hide Toolbar to choose whether the toolbar is visible when the document is first opened.

  7. Use Hide Menubar to choose whether the menu is visible when the document is first opened.

  8. Use Hide window UI to choose whether the UI elements, such as the scrollbar, are visible when the document is first opened.

  9. Use Fit window to choose whether the document window is sized to fit the page size when it is first opened.

  10. Use Center window to choose whether the document is shown in the center of the display area when it is first opened.

  11. Select Save.

Use the General > PDF Properties > Display title feature to control whether the PDF view shows the filename of the PDF or the title. By default, PDFs will show the filename but showing the title can be better for accessibility.

  1. Select Layout in the top menu.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo displays a list of Layouts. The list is empty if there are no custom Layouts in your Paligo instance.

  2. Select the Layout you want to update or Create a Layout.

    Tip

    You can copy the URL of the Layout Editor and paste it into a new tab in your browser. This can be useful if you frequently switch between your Paligo content and the Layout settings.

  3. Select General > PDF properties.

    PDF Layout. The General > PDF properties are shown and there are fields and drop-down lists to make selections.
  4. Set Display title to:

    • Yes to display the title instead of the filename

    • No to display the filename instead of the title.

  5. Select Save.