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