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