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