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