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