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