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