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