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