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