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