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