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