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