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