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