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