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