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