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