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