blob: 855a569efc29093a2d4f21cf6809b17470009cd0 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- SECTION: Specifications -->
<head>
<title>CUPS Banner File Format</title>
<meta name='keywords' content='job-sheets'>
<link rel='stylesheet' type='text/css' href='../cups-printable.css'>
</head>
<body>
<!--
Banner file format specification for CUPS.
Copyright © 2008-2011 by Apple Inc.
Licensed under Apache License v2.0. See the file "LICENSE" for more
information.
-->
<H1 CLASS="title">CUPS Banner File Format</H1>
<h2 class='title'><a name='INTRODUCTION'>Introduction</a></h2>
<p>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:</p>
<pre class='command'>
#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
</pre>
<h2 class='title'><a name='KEYWORDS'>Standard Keywords</a></h2>
<h3><a name='Footer'>Footer</a></h3>
<p class='summary'>
Footer text for footer
</p>
<p>The <code>Footer</code> key defines the text that is centered at the bottom
of the page. Only one <code>Footer</code> key can be specified.</p>
<h3><a name='Header'>Header</a></h3>
<p class='summary'>
Header text for Header
</p>
<p>The <code>Header</code> key defines the text that is centered at the top
of the page. Only one <code>Header</code> key can be specified.</p>
<h3><a name='Image'>Image</a></h3>
<p class='summary'>
Image /path/to/image/filename<br>
Image relative/path/in/DocumentRoot/filename
</p>
<p>The <code>Image</code> 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.</p>
<h3><a name='Notice'>Notice</a></h3>
<p class='summary'>
Notice Text to display below the job information.<br>
Notice More text to display below the job information.
</p>
<p>The <code>Notice</code> key defines lines of text that are centered below
the job information.</p>
<h3><a name='Show'>Show</a></h3>
<p class='summary'>
Show <em>value value ... value</em>
</p>
<p>The <code>Show</code> key lists the job information that is shown. The
following values are supported:</p>
<ul>
<li><code>imageable-area</code>: The imageable area of the current
page size</li>
<li><code>job-billing</code>: Billing information for the job</li>
<li><code>job-id</code>: The job ID</li>
<li><code>job-name</code>: The title of the job</li>
<li><code>job-originating-host-name</code>: The computer that printed
the job</li>
<li><code>job-originating-user-name</code>: The user that printed the
job</li>
<li><code>job-uuid</code>: The job UUID</li>
<li><code>options</code>: The options that were provided with the
job</li>
<li><code>paper-name</code>: The name of the paper size used</li>
<li><code>paper-size</code>: The dimensions of the paper size used.</li>
<li><code>printer-driver-name</code>: The printer driver used</li>
<li><code>printer-driver-version</code>: The driver version</li>
<li><code>printer-info</code>: The printer description</li>
<li><code>printer-location</code>: The location of the printer</li>
<li><code>printer-make-and-model</code>: The make and model strings
reported by the printer driver</li>
<li><code>printer-name</code>: The printer used</li>
<li><code>time-at-creation</code>: When the job was submitted</li>
<li><code>time-at-processing</code>: The current date and time</li>
</ul>
</body>
</html>
|
