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