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