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