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