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