PDF Properties
Using a custom set of XML tags inside your HTML, you can insert both custom metadata as well as instructions for how the PDF would be viewed in a PDF viewer application (subject of course to that application supporting those features).
Options
You use the (optional) tag <pdfproperties> and within that tag you
can insert <metainfo> and <pdfpreferences>
sections as shown in the instructions below. Within the
<metainfo> tag, you can add <prop> tags
with @name, @value attribute pairs with the data you wish
to store in the PDF metadata. Anything without one of the recognized, standard PDF
names (author, title, subject,
creator, keywords) are stored in custom metadata in
the PDF.
The <pdfpreferences> section allows you to insert one or more
<pref> tags with specific @name,
@value pairs that control the way the resulting PDF is displayed
with a viewer that supports standard PDF view attributes. The support
name, @value pairs are listed below and grouped into
all the available categories:
General PDF Options
These options let you control some general information about the generated PDF.
bookmarks - sets whether PDF bookmarks are generated or not. The default
is "false" for Cloudformatter. You can set @value to "true" if you want
bookmarks in PDF. Note that bookmarks are only generated for interpreted
hierarchical information. All h1 elements and there following
h2 elements and so on. Skipping levels will break the sequence and
the bookmarks will not be correct.
pdf-version - sets the PDF version number. The default is version 1.5
for Cloudformatter but you set @value to values like "1.3", "1.4",
"1.6" or "1.7" if you wish to change the version. Be aware thar some other features
could be disabled by setting the version too low.
compress - sets whether the PDF is compressed or not. The default is
"true" for Cloudformatter. You can set @value to "false" if you want
uncompressed PDF.
linearize - sets whether the PDF is linearized or not. The default is
"false" for Cloudformatter. You can set @value to "true" if you want to
optimize a long PDF for web view.
PDF View Options
These options let you control how the PDF when opened appears to the end user.
view-mode - Choose from one of the following:
auto- If there are bookmarks in the document, the bookmarks pane is displayed. Otherwise, all auxiliary panes are hidden.show-none- All auxiliary panes are hidden.show-bookmarks- The bookmarks pane is displayed.show-thumbnails- The thumbnails pane is displayed.full-screen- The document is displayed in full screen-mode.
initial-zoom - Choose from one of the following:
auto- Page scaling is not specified.fit- The page is scaled to fit completely into the view port.fit-width- The page is scaled so that its width matches the width of the view port.fit-height- The page is scaled so that its height matches the height of the view port.###or####%- The page is scaled by the number or percentage specified.
page-layout - Choose from one of the following:
auto- Uses settings of viewer application.single-page- Displays one page at a time.continuous- Displays pages continuously in one column.two-columns-left- Displays pages continuously in two columns, with odd-numbered pages to the left.two-columns-right- Displays pages continuously in two columns, with odd-numbered pages to the right.two-pages-left- Displays pages in two columns, by two pages at a time, with odd-numbered pages to the left.two-pages-right- Displays pages in two columns, by two pages at a time, with odd-numbered pages to the right.
viewer-preferences - A comma separated list of the following
possibilities:
hide-toolbar- Hides the viewer application's tool bars when the document is active.hide-menubar- Hides the viewer application's menu bar when the document is active.hide-window-ui- Hides user interface elements in the document's window (such as scroll bars and navigation controls), leaving only the document's contents displayed.fit-window- Resizes the document's window to fit the size of the first displayed page.center-window- Positions the document's window in the center of the screen.display-document-title- Controls whether the window's title bar displays the document title taken from the "title" metadata field.
PDF Security
These options allow you to specify owner and user security in the PDF output. User-level security can inject a password to be used to open the PDF, while owner-level security can control what can be done with the PDF (like printing it or copying the data from it).
userpassword - Sets the user password that must be entered to view the
PDF. There are no options, the @value passed is the password to be
used.
ownerpassword - Sets the owner password that must be entered to enable
advanced processing of the PDF. There are no options, the @value passed
is the password to be used. An ownerpassword is used to lock down certain privledges
that an owner will grant to a recipient of the PDF. Without the owner password,
recipients can be restricted from certain things. By default they are restricted
from everything, and you can then specify what additional things you allow by using
userpriviledges.
userpriviledges - A comma separated list of the following
possibilities:
print- Enables printing the document.modify- Enables editing the document.copy- Enables copying text and images from the document to the clipboard.annotate- Enables adding notations to the document and changing the field values.
PDF Pre-Press Options
These allow you to specify crop marks, bleeds and registration marks to be applied to the PDF.
crop-offset - specify offsets from the meaningful content on the page to
the edges of the physical media (/MediaBox entry in the PDF page dictionary). Its
value is a series of 1 to 4 length specifiers that set offsets from the edges of the
page area to the corresponding edges of the /MediaBox. Rules for expanding the value
are the same as for the padding property in CSS.
bleed - specify the bleeds — an extra space around the page area into
which the contents of the page may protrude (/BleedBox entry in the PDF page
dictionary). Its value is a series of 1 to 4 length specifiers that set offsets from
the edges of the page area to the corresponding edges of the /BleedBox. Rules for
expanding the value are the same as for the padding property in CSS.
crop-mark-width - defines line width for the crop marks, setting it to 0
disables drawing of crop marks.
bleed-mark-width - defines line width for the bleed marks, setting it to
0 disables drawing of bleed marks.
printer-mark - specify additional SVG images to be drawn in the offset
area surrounding the page (specified by crop-offset and bleed parameters). Printer
marks are clipped to the outside of the bleed rectangle. The @value is
a URL to an SVG you have. This sample has two URLs (one for a colorbar and one for a
registration mark) you can also use if you like.
The following code is what is behind this page for producing the PDF. Of course, you would only see the things supported by your PDF viewer you use. If you wish to see them all in action, then use "download" and Adobe Reader to view the PDF.
Recent changes in some browsers will not treat this XML as XML. Instead it tries (incorrectly) to not close tags. For best results, be sure to use open and close tags and not a self-closing tag.
<pdfproperties style="display:none;">
<metainfo>
<prop name="author" value="Xportability LLC"></prop>
<prop name="title"
value="Xportability Cloudformatter: Showing Custom
PDF Properties"></prop>
<prop name="subject" value="A Cloudformatter Document"></prop>
<prop name="creator" value="css2pdf@cloudformatter.com"></prop>
<prop name="keywords" value="CSS, PDF, Cloudformatter"></prop>
<prop name="custom1" value="value1"></prop>
<prop name="custom2" value="value2"></prop>
<prop name="custom3" value="value3"></prop>
<prop name="custom4" value="value4"></prop>
</metainfo>
<pdfpreferences>
<pref name="bookmarks" value="true"></pref>
<pref name="pdf-version" value="1.6"></pref>
<pref name="view-mode" value="auto"></pref>
<pref name="initial-zoom" value="fit-height"></pref>
<pref name="page-layout" value="two-columns-left"></pref>
<pref name="viewer-preferences" value="display-document-title"></pref>
<pref name="crop-offset" value="0.5in"></pref>
<pref name="crop-mark-width" value="1px"></pref>
<pref name="printer-mark"
value="http://www.cloudformatter.com/Resources/Images/registration.svg"></pref>
<pref name="printer-mark"
value="http://www.cloudformatter.com/Resources/Images/colorbar.svg"></pref>
</pdfpreferences>
</pdfproperties>
Sample Output H2
Et diam eirmod vero commodo. Sea stet sed lorem erat sit sed doming et. Possim autem accumsan gubergren duo consetetur. Ea consectetuer ex invidunt lorem magna sed assum quis dolore hendrerit iusto at. Ut assum ipsum magna est takimata dolore kasd esse tempor ea. Takimata vel ea lorem ipsum molestie eos dolores. Te ipsum kasd takimata sadipscing invidunt aliquyam option te amet et no tempor clita sanctus sanctus.
Labore vel ut dolor praesent est sed at erat eos lorem gubergren est ea. Consetetur dolores facer elitr amet clita diam. Kasd vero invidunt sadipscing dolores ea sit sadipscing sadipscing te no eirmod assum enim ad. Sanctus erat ea takimata sea ut sit amet takimata ut et eum ut. Sanctus labore consetetur diam nostrud eos nonummy duis amet ipsum kasd. Sanctus lorem augue diam accusam exerci odio diam invidunt et dolor labore magna dolor accumsan hendrerit volutpat. Wisi est sea commodo est at sadipscing gubergren.
Sample Output H3
Dignissim clita et sit augue diam erat dolores eleifend erat rebum at no amet. Labore lorem kasd erat duo vel lorem sed. Eu takimata voluptua takimata euismod possim labore. Ut magna lorem elitr eirmod amet in ipsum feugiat takimata diam dolor praesent at sit eu accusam. Suscipit dolore augue tempor sea et. Est et takimata vulputate et in kasd sit lorem ut sed. Ea clita mazim elitr diam. Voluptua at duo clita placerat dolore lobortis tempor nonumy labore dolor illum wisi sanctus esse. Labore at erat augue te. Et sit clita tincidunt dolores takimata. Vero stet suscipit vel consectetuer et nonumy lorem consetetur nihil delenit.
Blandit diam consetetur. Sit dolor tempor ipsum erat ad clita ipsum te consetetur imperdiet et lorem duo. Et sit et et clita duis dolore iusto eleifend. Diam dolor luptatum feugiat et ipsum. Justo velit ut vel liber eos option magna nihil suscipit at nulla quis magna consetetur elit.
Sample Output H4
Justo sanctus takimata et facilisis justo justo ut nulla eirmod lorem erat volutpat sit clita no ipsum nulla. Lorem et clita nulla eirmod ea sed takimata rebum sed invidunt. Et iriure duis invidunt ullamcorper rebum tempor gubergren suscipit et amet quis te kasd duo eirmod ut dolor. Erat ipsum duo et et sea ut justo sit nonumy kasd est delenit gubergren sadipscing lorem dolore. Imperdiet magna consetetur dolor dolores.
Aliquyam sit lorem diam feugiat tempor blandit vel nonumy sea. Duis eos consetetur kasd et sit invidunt velit consetetur vel lorem. Ad elitr soluta accusam dolore voluptua takimata. Justo kasd lorem no takimata laoreet sed eirmod dolor te nonumy. Dolor ut lorem tation vero magna ipsum enim. Sed diam et diam ut suscipit lobortis erat et eos accumsan eu magna no esse feugait ipsum. Dolore accusam dolor in illum wisi nostrud zzril kasd molestie elitr dolor ea sea exerci clita. Dolor facilisis et accusam dolores ut no et amet enim no dignissim at et dolores. Sanctus takimata duis dolor sea stet et dolore lobortis. Dolores tempor invidunt facilisis ut elitr dolor ut gubergren sit et diam stet amet nisl justo. Dolor blandit consetetur at odio vero facilisis gubergren dolor clita diam et labore dolor dolor invidunt diam lorem nonumy.
Sample Output H4
Aliquyam consectetuer dolores sed accumsan consectetuer blandit sit exerci clita ad nonumy magna invidunt quis. Dolore no stet vero dolores et aliquyam eros justo voluptua et. Sit consequat iriure duo esse accusam et duo diam ex sit vero sea nulla accumsan amet diam diam nisl. Sanctus voluptua consetetur exerci voluptua. Consetetur sit hendrerit elitr nisl congue dignissim option amet voluptua dolores sit et.
Eum eirmod sit et nonumy vel nibh nonummy dolor erat elitr placerat eirmod. At nulla voluptua elitr clita exerci at imperdiet. Sadipscing dolores erat tempor accumsan option dolore consequat iusto sadipscing feugiat feugait duis veniam sed tempor esse. Vulputate sadipscing stet wisi takimata et duo at sit. Aliquam gubergren dolores nibh. Stet nulla amet invidunt nulla duo sed lorem kasd lorem lorem no eirmod illum magna dolore est iriure. Takimata eirmod eos dolor gubergren aliquyam no lorem dolore tempor rebum sit voluptua dolor in amet ipsum vero labore. Et nostrud amet dignissim diam sea facilisi erat stet tempor stet sit duo sed justo dolor diam. No dolor justo justo nulla sea consequat et eos sanctus rebum dolore sanctus ut accusam. Sadipscing dolor no dolore justo soluta eu sed liber clita vero adipiscing sed cum. Clita gubergren laoreet rebum tempor sadipscing.
Sample Output H3
Dolores vero volutpat ut luptatum sit erat. Et magna nam ea et. Lorem voluptua takimata ea tation eirmod ex lorem. Dolor molestie eos. Lorem dignissim vero et lorem sanctus lorem voluptua ipsum elit.
Consetetur ut tempor sit aliquip et nonumy eum at et ea sea et aliquip consequat at vel no velit. Tincidunt dolore et vero eu minim dolor invidunt duo et diam sed at amet minim voluptua sit invidunt vel. Et amet nulla et et aliquip te erat eum erat at diam gubergren amet sanctus clita ad erat. Ut eirmod ut at sed enim iusto et nisl elitr et. Sit te vel et gubergren tincidunt nulla velit.
Sample Output H4
Et takimata nonumy nobis labore dolor voluptua sed aliquip diam accusam dolor vel odio nulla et autem ut. Dolore ipsum diam et lorem sit sed erat dolores nonumy ullamcorper eos veniam ad nulla lobortis. Velit sit autem lorem takimata consetetur ullamcorper dolore est commodo ipsum elitr lorem aliquip at dolor. Labore dolor euismod tempor ex ut eos et gubergren velit consetetur lorem gubergren stet dolore. Magna kasd tempor velit clita wisi gubergren blandit vero amet elit vel nonumy clita nam nulla. Elitr erat duis erat sed ut kasd consetetur labore dolor est.
Amet possim ea laoreet nobis accusam. Sanctus sed takimata sadipscing et stet tempor dolor sed eleifend dolor. Dolore ipsum amet praesent diam est sed at voluptua sadipscing consequat praesent est eirmod sit esse. Gubergren augue erat amet at autem sit iusto magna takimata nihil amet vel ut et amet tempor. Vero hendrerit eirmod gubergren est eos magna magna clita sadipscing vero nonumy vel dolores magna. Hendrerit ipsum dolor sit ut facilisis amet aliquyam duo ea dolore no dolore. Veniam dolore dolores sanctus et aliquyam accusam sanctus tempor sanctus.
Sample Output H4
Amet sea ipsum. Sanctus magna blandit dolor gubergren aliquyam ipsum ut no dolores takimata feugait. Accusam sed sanctus dolore et ipsum voluptua accusam sed amet consectetuer dolor invidunt doming rebum dolores no sadipscing. Zzril lorem ut dolor. Aliquyam delenit adipiscing et dolore vel magna sanctus feugiat rebum invidunt kasd clita eum kasd nibh. Quis nulla justo et lorem ullamcorper ipsum cum justo at ut ea sadipscing iusto autem eirmod ipsum sit suscipit. Mazim diam dolore nisl stet hendrerit est nulla ipsum est. Dolore dolore ut consetetur et labore et aliquyam diam magna lorem. Et amet dolor. In sanctus consetetur duis stet magna dolore commodo volutpat. Dolor assum sed justo consetetur est rebum erat sanctus commodo dolore sed amet est sanctus.
Gubergren sed diam clita tation et dolor et tempor. Vero est magna dolores sed sea invidunt invidunt molestie clita est et sadipscing duis at diam diam dolores. Sanctus eirmod no in sit ipsum accusam. Sit suscipit ad ut tempor eros. Vero diam id sit vero dignissim stet ipsum justo duo lorem sit esse sed. Aliquyam dolore dolor nisl et et zzril sit et dolor sea et invidunt. Sanctus at adipiscing sadipscing quis at vel et invidunt sed no minim aliquip dolore nulla.
More Sample Output H2
Dignissim veniam augue diam illum sed sit erat dolor consetetur nostrud lorem gubergren dolores sanctus nibh takimata rebum lorem. Ipsum vero ipsum consequat et hendrerit sea autem duo. Diam duo nulla amet stet blandit eos blandit hendrerit vulputate. Adipiscing no eu takimata cum sea kasd erat ut. Tation consequat accusam lorem eum minim clita dolore takimata. Accumsan ad vulputate diam te facer. Erat molestie lorem labore mazim tempor dolores in illum est sed eros vel dolor vero dolore magna lorem dolore.
Euismod sed kasd lobortis feugiat erat no justo blandit stet magna rebum diam kasd ut. Gubergren justo volutpat est nonummy dolor takimata nobis ullamcorper. Lorem et nonummy accumsan nonumy minim duo duis justo sit sadipscing dolores gubergren eleifend sea accusam magna sed. Augue dolor magna velit et facer sit elit magna accumsan erat labore diam ipsum nostrud labore sadipscing. Consetetur at duo erat elitr sadipscing nisl elitr mazim sea dolores ipsum takimata amet. Dolor sea stet nam diam enim justo elitr erat tempor voluptua sadipscing sanctus delenit justo et dolores ea.
Sample Output H3
Vel no ut ipsum. Duo sea dolor. Feugiat et ea. Et voluptua diam dolor doming et sed voluptua consequat diam elitr dolores amet sed tincidunt velit iusto. Et diam stet commodo nonumy et voluptua praesent sea iusto accusam. Ipsum lorem elitr rebum. Iusto augue justo accusam dolore ut kasd dolor diam consetetur et nonumy et ea sadipscing. Dolore amet exerci sit possim tempor lorem est sed elitr et velit sed elitr lorem. Ea invidunt est gubergren dolores eum. Praesent dolor dolor ipsum magna vero euismod invidunt in clita erat. Diam feugiat rebum dolor vel.
Sadipscing voluptua lorem. In magna takimata dolore esse iusto gubergren lorem et qui amet no. Sadipscing nonumy duo aliquyam et eos duis ut takimata consetetur amet. Voluptua ea in enim ea qui sadipscing nihil clita ipsum amet vero clita diam feugiat feugiat rebum lorem ipsum. Accusam wisi duis nihil kasd eirmod in ipsum ut stet duis lorem sed sit dolores takimata facer cum dolor. Vero aliquyam dignissim dolore accusam. Duo consetetur no rebum.
Sample Output H4
Erat clita diam in justo sed blandit kasd gubergren eos accusam lorem sanctus eu blandit dolor facilisi vero elitr. Magna dolore rebum gubergren gubergren at diam et et lorem consetetur diam labore eum. Feugiat sed et eirmod duis amet sed takimata duo exerci odio zzril esse diam ipsum dolore. Eos volutpat ex. Ipsum aliquyam magna consetetur zzril sit sed euismod erat amet ea. Takimata ut justo dolores tempor gubergren eu facilisis et autem sit nonumy sed et dolore lorem sed.
Esse magna euismod facilisis commodo dolor sadipscing amet ipsum erat stet est rebum lorem sanctus lorem dolor volutpat est. Magna eirmod accusam diam ut sed elitr. Sea clita sadipscing et justo sed congue erat facilisis. Possim in gubergren quis illum clita ad sadipscing. Et et eos molestie nostrud iriure diam vulputate dolor sadipscing ipsum.
Sample Output H4
Praesent vero lobortis invidunt at erat esse eos sadipscing. Dignissim ut dolore rebum et accusam et gubergren sit sed sed. Exerci est sea ipsum elitr in justo sit lobortis at. Justo esse amet dolor dolor aliquip dolore hendrerit et diam rebum dolore consequat adipiscing nonummy. Vel et dolore voluptua ipsum erat sea ea nisl sit sed eirmod. Lorem elitr eos dolor sanctus clita diam at. Aliquyam diam aliquyam labore ut est dolore ea kasd et ea invidunt adipiscing clita accusam blandit lorem vulputate zzril. Duo dolore eros sadipscing ut erat magna elitr diam iriure et sit. Luptatum elitr eum stet justo lorem invidunt blandit sit esse clita vero dolor nonumy duis dolor voluptua.
Facilisis sanctus ut eu consectetuer invidunt et sit at nonumy vulputate vulputate. Vel consetetur et magna sit est veniam invidunt iriure dolore volutpat. Ea et commodo vero luptatum diam sit. Rebum iusto invidunt dolore gubergren kasd voluptua lorem sea dolore sed kasd ipsum veniam. Ut est erat velit esse nostrud qui. Eos dolor ut dolores dolores. Et nonummy blandit nonumy dolor eleifend eros lorem dolor gubergren. Aliquyam exerci diam labore lorem sanctus autem amet sed sed dolor vulputate. Magna voluptua rebum et dolores erat vero consetetur sadipscing hendrerit molestie. Nonumy et sit ea sit ipsum dolor sit justo sadipscing ipsum hendrerit et ipsum facilisis tempor.
Sample Output H3
Est dolor sed duo ut no tempor ipsum. Vero diam in invidunt et diam ea id. Sit volutpat tempor vero et amet sed tempor sed iusto takimata ipsum amet invidunt minim qui. Ipsum erat diam ad ullamcorper sed dolor eu sed ut ad takimata exerci dolor. Nulla minim clita veniam. Magna dolore et nonumy est aliquyam commodo vel esse eos amet erat invidunt. Et consequat dolores iusto rebum. Dolor elitr elitr et elit lorem. Aliquyam sanctus sed ut vel ipsum nonumy accusam labore eirmod labore lobortis voluptua ipsum.
Lorem labore lorem. Sanctus adipiscing ea no sanctus sanctus et labore eirmod nonumy sed diam vero sit gubergren eros consectetuer tempor rebum. Dolor amet praesent ipsum sit lorem diam sed vel et nisl ipsum sadipscing sed sed. Diam et ea iriure voluptua accusam. Eos dolor consetetur labore magna eirmod takimata dolore duo accusam vero vero sanctus stet sit no facilisi. Minim accusam velit dolor veniam labore dolor sit invidunt vel. Accusam justo aliquyam diam ea clita sit sit. Vero sed nonumy ipsum in. Dignissim lobortis ut consetetur accumsan odio sea sadipscing consequat blandit diam erat lorem diam tempor wisi.
Sample Output H4
Stet aliquyam dolor duo autem accusam nostrud amet erat sed no accusam illum invidunt rebum gubergren veniam. Kasd mazim diam sit aliquyam voluptua sanctus nibh sed accusam. Vulputate facilisis hendrerit justo labore nonumy lobortis elitr dolor iusto. Et iriure iriure sit stet clita eirmod diam et eirmod rebum id lobortis sed rebum blandit vel. Stet diam kasd takimata ut ullamcorper stet laoreet lorem eum dolor sed sed diam. Sea voluptua ipsum odio clita.
Nonumy et diam nulla in justo voluptua. Possim est eos. Dolore ex sed sadipscing eos ut eirmod. Stet nostrud sadipscing at sit tempor ipsum iriure sit no dolore esse. Dolor sit sed et elitr nulla consetetur amet est takimata eros.
Sample Output H4
Eirmod eos duo amet nulla vel in accusam eu erat autem. Adipiscing lorem commodo iriure sadipscing nonummy diam et eirmod takimata duis amet te zzril. Consetetur kasd sea dolor enim facilisi est amet amet sadipscing tempor dolor enim aliquyam voluptua. Accusam facilisis duo nibh voluptua rebum esse clita amet. Labore est rebum accumsan dolores eirmod et aliquyam duo. Vero autem sed in voluptua est lorem duo magna dolores dolor est sed esse tincidunt. Sed ut rebum erat facer dolor sea dolor eos sit ut et at option magna labore erat duis. Vel amet clita cum accusam kasd. Sanctus diam voluptua facilisis consetetur. Dolore dolor sit aliquyam duo lorem odio diam in eu et at et placerat elitr at invidunt.
Stet voluptua et et facilisis sit elitr eu qui feugait aliquyam accusam amet takimata. Id erat ea duo dolores consetetur. Labore sanctus justo stet vero dolor accumsan consetetur dolore in molestie eirmod autem amet ipsum exerci dolores clita no. Dolor dolore no eum velit duo. Dolor stet in justo vel ea ut sadipscing diam dolor ut accumsan in eos. Clita labore aliquip dolore nulla hendrerit. Ut velit aliquyam sed iusto diam luptatum. Facer accumsan accumsan euismod vero magna in lobortis nonumy eos.