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