The config file (.prefs) of an annotated report

The config file allows you to configure the variable elements in the preflight report such as the way the bookmarks are organized (sorted per page or per item), whether or not a summary annotation should be displayed (and how it should look like), how the report should be secured, etc.

About the configuration file

  • The file has the extension .prefs and it is crucial that this extension, thus the format remains!
  • Preferably you open the config file with the following application:
    • Mac: TextEdit (preference set to .txt format)
    • Windows: Notepad or Notepad++
  • The location (for customized reports):
    • On Mac: HD/Library/Preferences/Enfocus Prefs Folder/Report Templates/Custom/
    • On Windows XP and 2003: HD\Documents and Settings\All Users\Application data (this is a hidden folder)\Enfocus Prefs folder\Report Templates\Custom
    • On Windows 7, 2008 and newer versions: ..\ProgramData\Enfocus Prefs Folder\Report Templates\Custom

About the structure of the configuration file

  • A .prefs file always starts with #BEGINPREFS and ends with #ENDPREFS.
  • A .prefs file of an annotated report can contain only two sections ("dictionaries"), each starting with #BEGINDICT and ending with #ENDDICT:
    • PitStopReport
    • AnnotatedReportSettings
  • Each section contains a number of settings or tags, as explained further in this document. See PitStopReport and AnnotatedReportSettings.
  • The order in which the sections and the tags (within a section) appear in the .prefs file is not important.
Note: For an example file, refer to Example of an annotated report template (.prefs file).

Colors and units

  • Colors are specified by a string consisting of 1, 3 or 4 numbers. Each number represents a color component percentage value:
    • 1 value: grayscale
    • 3 values: RGB
    • 4 values: CMYK
    Note:
    • Remember the color value is a percentage (%) value (i.e. a number in the range from 0 - 100).
    • You are free to configure color values in RGB, CMYK or grayscale, except for the SummaryAnnotationColor tag which should be defined in RGB (See AnnotatedReportSettings).
  • The unit used in the .prefs file is ‘Points’.