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