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