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