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