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