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