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