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