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