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