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