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