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