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