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