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