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