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