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