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