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