This specification describes the CUPS banner file format (application/vnd.cups-banner) which is used to generate print job cover pages and the CUPS test page. The format itself consists of a header followed by lines of UTF-8 text containing comments or keywords and values:
#CUPS-BANNER # What to show on the cover page Show job-id job-name job-originating-user-name time-at-creation # The header and footer text Header Cover Page Footer Cover Page # Arbitrary "notice" text Notice All work and no play makes Johnny a dull boy. Notice All work and no play makes Johnny a dull boy. Notice All work and no play makes Johnny a dull boy. Notice All work and no play makes Johnny a dull boy. # Images to place below the rest Image /usr/share/doc/cups/images/cups-icon.png Image /usr/share/doc/cups/images/smiley.jpg
Footer text for footer
Footer key defines the text that is centered at the bottom
of the page. Only one
Footer key can be specified.
Header text for Header
Header key defines the text that is centered at the top
of the page. Only one
Header key can be specified.
Image key defines images that are centered above the footer
text. Multiple images are centered as a group from left to right. Images are
scaled as needed to fit on the page with a nominal size of 1"/25cm.
Notice Text to display below the job information.
Notice More text to display below the job information.
Notice key defines lines of text that are centered below
the job information.
Show value value ... value
Show key lists the job information that is shown. The
following values are supported:
imageable-area: The imageable area of the current page size
job-billing: Billing information for the job
job-id: The job ID
job-name: The title of the job
job-originating-host-name: The computer that printed the job
job-originating-user-name: The user that printed the job
job-uuid: The job UUID
options: The options that were provided with the job
paper-name: The name of the paper size used
paper-size: The dimensions of the paper size used.
printer-driver-name: The printer driver used
printer-driver-version: The driver version
printer-info: The printer description
printer-location: The location of the printer
printer-make-and-model: The make and model strings reported by the printer driver
printer-name: The printer used
time-at-creation: When the job was submitted
time-at-processing: The current date and time