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