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