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