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