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