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