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