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
Ipsum duo voluptua ut exerci stet et. Facer et hendrerit rebum clita delenit stet et at clita et stet accusam sit te diam. Sit consequat sed molestie labore erat sea veniam accusam eros in gubergren ut facilisi sed elit sit. Lorem accusam ipsum lorem et est invidunt amet accusam clita elitr et dolor euismod dolore stet tation. Amet facilisis takimata ipsum dolore eu. Eirmod eos vero. Nonumy in iusto et stet takimata accusam. Vel euismod et ut molestie sea veniam aliquam elitr nonumy rebum vel labore labore amet ipsum nisl aliquyam sit. Hendrerit ut et magna. Diam luptatum wisi eirmod voluptua nonumy justo at sed esse et et erat lorem id praesent gubergren.
No vel et et veniam illum adipiscing dolore sanctus stet zzril duis placerat nulla voluptua vero sadipscing. Et ea amet. Eu amet dolore magna eu clita ut tincidunt sed diam. Ut sanctus ex in diam sea aliquip duis takimata rebum rebum illum sea vero. Et duo aliquip iusto exerci labore et rebum.
Sample Output H3
Eros sed ipsum et in option et tempor eirmod odio et sanctus ut consectetuer eirmod autem. Consetetur duo duo stet justo nonumy lorem in diam eos ut et vero. Sed blandit eleifend duo eum commodo eum dolore delenit. Consetetur nonumy sanctus mazim et sit duo labore rebum feugiat diam magna stet sit placerat et lorem autem. Nonummy nonumy et vel ut aliquyam.
Nulla voluptua sit. Elit dignissim diam tempor. Labore sed invidunt nonumy lorem praesent ipsum in gubergren kasd ut lorem sit est blandit consetetur augue accusam invidunt. Voluptua et clita sadipscing ut nonumy nulla duo blandit sea feugiat invidunt no veniam elitr eirmod. Erat eos ut sit est dolor justo sit clita ut est rebum labore dolores. Elitr stet aliquam stet duo erat ipsum rebum at invidunt voluptua nostrud aliquip. Amet vel no ipsum suscipit adipiscing eu ea eos. Justo sadipscing nulla eos odio ipsum esse wisi diam erat consetetur sit eirmod. Stet sed at nulla eum wisi erat. Amet rebum ea eu feugait ea nihil dolor ad voluptua invidunt dolore amet sea.
Sample Output H4
Consetetur et ipsum at wisi et et. Dolor soluta sed nulla accumsan no dolor voluptua elitr laoreet placerat minim possim eirmod. Eos et facilisi aliquyam duo placerat dolore invidunt clita at erat rebum accumsan duo iusto. Ipsum sea ipsum ut sea eirmod et nonummy. Eum dolor sadipscing aliquip dolore no diam est in ut lorem. Elitr tation hendrerit amet et dolore ipsum enim at tincidunt sea justo dolor tempor est invidunt lorem est.
Magna et in in vero eu diam lorem duo sed magna gubergren ipsum praesent eos sit dolore sea sed. Sit rebum eum ea nonumy vero nisl no accusam diam sit ullamcorper eos ipsum magna. Stet et dolores duo tation ipsum duis velit duis autem esse lorem accusam diam hendrerit nulla. Feugiat amet dolores diam sadipscing aliquip nisl gubergren justo quis sed sed. Accusam sit ipsum ipsum eirmod eu vulputate elitr et et dolor.
Sample Output H4
Sed lobortis elitr tempor dolores dolores lorem sadipscing hendrerit justo rebum sadipscing accusam duis eos sea nonumy vulputate. Diam eirmod diam ut clita justo lorem rebum vero eos aliquyam blandit. Et vulputate rebum sit dolor magna kasd euismod sanctus amet erat. Laoreet gubergren duo. Elitr labore sit. Dolores dolores amet dolor voluptua erat justo lorem. Dolor accusam kasd ut amet consetetur no et velit ullamcorper vero sed vulputate et tempor ipsum. No sea magna dolore et eirmod ipsum voluptua et luptatum nonumy dolores. Dolor sit sadipscing quis no aliquyam duo zzril nonumy adipiscing.
Sanctus doming eirmod delenit. Amet rebum ipsum ipsum accusam iriure takimata tempor rebum dolore nibh no sit diam. Ea diam ea kasd dignissim lorem dolor at magna tempor justo iriure nulla. No clita dolore sit eos et voluptua ipsum odio accusam sit dolor laoreet ad lorem. Sed nonumy takimata eos labore sed adipiscing kasd sadipscing clita. Nam volutpat dolores ut ipsum vel lorem est esse. Rebum sed et consequat stet takimata duis kasd ea vero labore diam diam zzril.
Sample Output H3
Amet dolore aliquyam aliquyam est dolor gubergren eirmod aliquyam est dolor sit eu molestie. No te lorem consetetur dolore dolores. Et et duo amet gubergren justo. Dolore sea et diam sit eirmod. Vero et facer nibh duo aliquam no ut velit voluptua sit. Consetetur et amet diam accusam labore duo te diam no clita eos elitr feugait eos no consetetur ipsum iriure. Eleifend sea ea tempor feugait consectetuer. Ipsum tation stet lorem sadipscing lorem amet vero vero aliquyam stet.
Dolore autem kasd magna kasd duo sit eros dolor eirmod dolore labore ea duis. Liber takimata clita kasd nonumy et et amet dolor eirmod justo justo. Invidunt amet erat sanctus et accusam rebum sanctus. Et diam nibh consetetur sit sit kasd nulla tempor diam eos clita justo et vel sanctus sadipscing ea. Id justo nulla sed dolore et dolor minim lobortis elitr rebum no amet sed ad qui invidunt velit consetetur. Justo nulla dolores consectetuer elitr sit justo sit consequat erat sit gubergren et. Sed hendrerit consetetur invidunt feugait eos. Accusam takimata eirmod eos justo laoreet ut at magna labore amet lorem. Elitr invidunt dolor in lorem invidunt invidunt sed. Et sed ipsum nobis ipsum lorem et at dolores aliquyam et consetetur ipsum praesent sed duis. Iriure dolore at tempor sed magna nonummy.
Sample Output H4
Mazim invidunt lorem tempor eos. Nonumy nonumy eleifend dolor accusam dolor at ex lobortis sanctus. Invidunt sadipscing nulla consetetur lorem diam stet no clita amet lorem erat consequat. Sed amet tempor et zzril ut aliquyam takimata vel dolore. Dolor ea mazim eos. Ad diam aliquyam eu dolores molestie invidunt ea justo amet sed iriure elit aliquip nonumy kasd ipsum tempor autem. Eirmod stet eirmod amet eirmod aliquyam facilisis diam invidunt.
Esse invidunt sit ipsum sea lorem. Nonumy ipsum rebum sanctus dolor ea veniam ipsum iriure aliquyam amet ipsum lorem eirmod consetetur liber clita diam aliquip. Elitr voluptua clita sit erat accusam at accusam sadipscing ut invidunt magna kasd ut nonumy gubergren iusto dolore kasd. Accusam ut dolor duis invidunt eirmod et iusto te veniam amet. Facilisis justo voluptua. Eros dolores nibh. Sed sed no kasd duis justo. Rebum ipsum labore et aliquyam voluptua gubergren no takimata ipsum elit placerat ut sit ex tation at ut accusam. In sea sanctus ipsum sanctus at elit dolor voluptua voluptua sed. Suscipit sit takimata et. Diam ea eirmod dolores no et aliquyam elitr.
Sample Output H4
Veniam sanctus commodo magna in. No sed est sadipscing rebum imperdiet tincidunt ea et et aliquyam kasd ea tempor eros amet amet. Dolore duo vel. Blandit tempor at kasd clita euismod ea sit gubergren consetetur ut hendrerit elitr sanctus sit aliquyam clita ut. Mazim sed voluptua sed ipsum diam facilisi elitr magna quis commodo amet et tincidunt eos feugait justo. Accusam amet lorem. Facilisis eos ut dolor vero amet ut amet ea eirmod.
Diam amet quod dolor. Ut nonumy gubergren stet lobortis nibh iriure veniam. Justo dolor kasd stet no justo aliquyam sed magna ipsum est in lorem at sanctus facilisis amet ad. Ut dolor sanctus sit iusto amet tempor doming luptatum tempor at ea sed et eos voluptua. Clita invidunt duis imperdiet no lorem et.
More Sample Output H2
Ipsum ipsum autem. Invidunt gubergren stet nonummy ut. Stet amet id molestie nonumy eos ipsum lorem eos ut rebum quis aliquyam dolor. Quis gubergren dolores laoreet voluptua dolor tempor euismod. Stet diam sit est duo ea dolor. Vero ullamcorper augue sadipscing tempor dolore exerci esse. Amet dolor ut erat nam duo mazim sed elitr amet aliquyam dolor consequat. At ut aliquyam at lorem et mazim in sea tempor dolores tempor.
Nonumy gubergren id tempor dolor veniam nulla diam no illum et eos nibh exerci sadipscing ea. Amet eos aliquyam laoreet eros takimata no gubergren et tempor dolore nonumy luptatum kasd aliquam imperdiet. Eos magna vero ipsum lorem invidunt molestie ut voluptua aliquyam amet diam magna magna. Elitr magna sanctus dolor takimata adipiscing magna lorem invidunt et tempor sadipscing duo. Sea aliquam sanctus vel eos justo sit et ipsum amet tempor facilisis diam ut sadipscing elitr labore. Sanctus rebum dolor ipsum accumsan vero. Aliquip elitr diam tempor tempor stet consetetur dignissim ut ea euismod dolor consequat no vero. Sit clita kasd gubergren dolore magna amet kasd consetetur praesent lorem invidunt velit diam et lorem et.
Sample Output H3
Dolor justo esse magna et tincidunt iusto ipsum invidunt consectetuer. Blandit at ipsum erat zzril velit rebum sit in vero. Et sadipscing lorem sea sed aliquyam feugiat vero nulla kasd nulla in dolore zzril ad wisi diam. Kasd sed gubergren kasd enim labore sanctus. Dolor iusto ut ut invidunt qui no dolor ipsum consetetur. Vero accusam in laoreet eum sadipscing consequat sed lorem dolores ipsum dolor elitr aliquip ea sed sit clita est. Tempor minim enim est gubergren eirmod placerat vero et diam eu et wisi. Cum nonumy ipsum accumsan rebum dolor sed elitr sea lorem magna. At amet et no labore zzril commodo ea vero. Ipsum est ad voluptua consectetuer exerci dolor consetetur takimata duo dolor molestie sit justo.
Et ipsum aliquam amet iusto diam at eos tation et. Et sadipscing facilisis dolore tempor nulla sed euismod dolor clita iusto sit invidunt feugait ea gubergren erat tempor. Et lorem duo. Nonummy amet sit facilisis liber voluptua et diam luptatum sadipscing. Justo sit tincidunt ea ea elitr vero sanctus sed eu. Dolor et tempor takimata euismod amet invidunt volutpat diam ipsum amet ea. Sanctus at et ipsum zzril consequat accusam takimata hendrerit exerci facer delenit accumsan consetetur nonumy ipsum. Voluptua et et consetetur eum vel gubergren autem et duo lorem aliquyam gubergren. Justo dignissim dolor stet takimata takimata et imperdiet quis exerci. Gubergren vulputate rebum sadipscing lorem dolor ipsum tempor consequat eos diam et. Clita tincidunt facilisi elitr praesent dolore dolores voluptua eum dolor dignissim erat labore aliquyam magna nulla est.
Sample Output H4
In dolore eirmod takimata sit est erat lorem. Sadipscing adipiscing tempor sadipscing. Ipsum amet ea nobis erat erat vero facer ut adipiscing possim clita ea et et. Ipsum ea sea dolore et. Autem erat imperdiet aliquip assum lorem kasd illum clita sed diam. Justo aliquyam dolores takimata. Ea ullamcorper ipsum dolore eu esse blandit at sea voluptua diam sed dolore eu gubergren wisi. Stet veniam sanctus elitr no accusam. Illum esse takimata et diam sit elitr amet sed voluptua. Feugait aliquip dolor et invidunt consetetur ipsum illum.
Est magna tempor. Sed sit in ut dolor labore no esse. Magna gubergren vero labore duo takimata ut diam iusto no. Sit kasd sed est et kasd. Sed sadipscing nulla erat takimata esse labore amet sit et amet diam et rebum sadipscing stet et sanctus. Gubergren aliquyam tincidunt voluptua feugiat labore et dolores volutpat. Vero ullamcorper dolore diam vulputate magna in et dolor lorem nonumy. Voluptua sanctus accusam sed ex sanctus takimata elitr autem. Et sed dolor ipsum et velit elitr sit consequat et praesent dolor mazim. Stet amet diam dolore.
Sample Output H4
Feugiat dolor esse no vero dolore est ipsum nobis duis gubergren accumsan illum invidunt diam sit magna. Nulla est sed ullamcorper. Dolores dolores no et id et amet ullamcorper vero et aliquip dolor rebum amet eros. Ipsum adipiscing nonumy stet. Iriure diam duis. Suscipit nihil vero est vero dolore eirmod voluptua labore invidunt placerat ea aliquam erat. Aliquip vero diam eirmod ea iriure facilisis hendrerit clita duo esse hendrerit sit consetetur magna et in et elitr.
Takimata justo enim amet minim ex magna elitr justo gubergren et dolor dolor kasd clita nulla. Commodo ipsum aliquyam sea rebum esse. Eirmod tempor magna molestie ea et enim eros. Labore amet nonumy ex in dolores eirmod amet magna in sea soluta in et. Dolor duis stet duo amet gubergren amet mazim magna dolore sea consetetur erat kasd nulla. Sed dolore amet justo praesent hendrerit vero sea magna gubergren ea gubergren accusam. Et et et adipiscing ut tempor dolor rebum consectetuer erat. Dignissim at erat dolore et dolor labore lorem. Erat sed dolor magna option gubergren lorem et tempor ut at ea laoreet. Lorem ullamcorper diam invidunt elitr sed sit dolor erat amet. Magna erat tempor sed facilisis takimata wisi takimata veniam vel elitr iusto.
Sample Output H3
No et ipsum diam commodo est nonumy lorem feugait eirmod accusam dolores ea hendrerit consectetuer diam nobis. Clita consectetuer duo. Ea dolore aliquyam diam facilisi sed sea ipsum facilisi dolor vel dolor et vero stet. Option vero at et sea eirmod takimata no tincidunt sed quod nonumy. Aliquyam iriure takimata consectetuer lorem rebum lorem luptatum stet et sed sed exerci magna duo dignissim dolor at et. Dolore dolore nisl exerci ut dolor ipsum esse stet erat. Ex justo stet minim et nonumy. Ea kasd illum ipsum sanctus sed dolor elitr kasd duo eirmod tation rebum ea invidunt ea ipsum.
Magna duo magna eu ipsum nonumy ipsum dolores mazim et stet molestie dolore nulla clita elitr duis. Sanctus et at aliquyam quod invidunt. Amet stet lorem amet dolore illum gubergren nonummy amet no sit tempor eleifend ut quod exerci kasd. Ut nisl option iriure voluptua justo hendrerit vero ea ullamcorper dolore duo duo in iriure. Ut wisi illum luptatum eros et ipsum sanctus kasd molestie consetetur lobortis sit labore. Nulla stet nibh tempor eleifend dignissim est.
Sample Output H4
Elitr nulla lorem. Labore dolore quod kasd elitr vero diam sed vero rebum imperdiet labore consequat in ut. Sea eirmod diam enim sanctus et est sea ipsum erat nulla vero at autem vero duo justo. Accusam nonumy sed labore stet eos minim ut odio et. Dolor amet voluptua.
Sed lorem feugiat vulputate clita justo. Sit elitr clita option te dolores consetetur nonumy sed et ipsum aliquam nonumy kasd hendrerit. Est ipsum lorem erat eos erat lorem. Feugiat takimata sit dolore stet stet clita diam ipsum justo kasd elitr eleifend sadipscing sanctus. Autem sadipscing duo magna ipsum justo veniam ut nisl sed tation elitr rebum exerci nonumy. No blandit et. Dignissim et sit sadipscing odio takimata dignissim accusam aliquam consequat consetetur iriure. Takimata et erat erat vel gubergren nulla.
Sample Output H4
Duo elitr dolor magna diam duis rebum hendrerit et dolore nostrud erat nisl esse sed voluptua ipsum amet amet. Dolores ipsum ut aliquyam amet sea. Voluptua dolore dolore sea at elitr feugait ipsum gubergren. Sit feugiat no sea magna dolore kasd est sanctus. Sit eirmod justo elitr rebum vulputate praesent te ea laoreet facilisis accusam et. Esse diam ea. Ut dolor dolor et rebum dolore. Lorem euismod consectetuer lorem accusam diam dolor amet et eu tempor elitr sed vero illum at ea euismod et.
Dolore et ipsum ipsum vel accusam invidunt. Stet rebum nulla eros diam et sit et vero amet vel et et et. Sit nisl consetetur dolor erat cum dolore euismod amet facilisi labore. Lobortis dolores duo nisl sit nostrud dolore et et no. Ut imperdiet possim gubergren no dolore.