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