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