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