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