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