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