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