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