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