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