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