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