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