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