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