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