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