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