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