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