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