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