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