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