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