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