PDF Properties
Using a custom set of XML tags inside your HTML, you can insert both custom metadata as well as instructions for how the PDF would be viewed in a PDF viewer application (subject of course to that application supporting those features).
Options
You use the (optional) tag <pdfproperties> and within that tag you
can insert <metainfo> and <pdfpreferences>
sections as shown in the instructions below. Within the
<metainfo> tag, you can add <prop> tags
with @name, @value attribute pairs with the data you wish
to store in the PDF metadata. Anything without one of the recognized, standard PDF
names (author, title, subject,
creator, keywords) are stored in custom metadata in
the PDF.
The <pdfpreferences> section allows you to insert one or more
<pref> tags with specific @name,
@value pairs that control the way the resulting PDF is displayed
with a viewer that supports standard PDF view attributes. The support
name, @value pairs are listed below and grouped into
all the available categories:
General PDF Options
These options let you control some general information about the generated PDF.
bookmarks - sets whether PDF bookmarks are generated or not. The default
is "false" for Cloudformatter. You can set @value to "true" if you want
bookmarks in PDF. Note that bookmarks are only generated for interpreted
hierarchical information. All h1 elements and there following
h2 elements and so on. Skipping levels will break the sequence and
the bookmarks will not be correct.
pdf-version - sets the PDF version number. The default is version 1.5
for Cloudformatter but you set @value to values like "1.3", "1.4",
"1.6" or "1.7" if you wish to change the version. Be aware thar some other features
could be disabled by setting the version too low.
compress - sets whether the PDF is compressed or not. The default is
"true" for Cloudformatter. You can set @value to "false" if you want
uncompressed PDF.
linearize - sets whether the PDF is linearized or not. The default is
"false" for Cloudformatter. You can set @value to "true" if you want to
optimize a long PDF for web view.
PDF View Options
These options let you control how the PDF when opened appears to the end user.
view-mode - Choose from one of the following:
auto- If there are bookmarks in the document, the bookmarks pane is displayed. Otherwise, all auxiliary panes are hidden.show-none- All auxiliary panes are hidden.show-bookmarks- The bookmarks pane is displayed.show-thumbnails- The thumbnails pane is displayed.full-screen- The document is displayed in full screen-mode.
initial-zoom - Choose from one of the following:
auto- Page scaling is not specified.fit- The page is scaled to fit completely into the view port.fit-width- The page is scaled so that its width matches the width of the view port.fit-height- The page is scaled so that its height matches the height of the view port.###or####%- The page is scaled by the number or percentage specified.
page-layout - Choose from one of the following:
auto- Uses settings of viewer application.single-page- Displays one page at a time.continuous- Displays pages continuously in one column.two-columns-left- Displays pages continuously in two columns, with odd-numbered pages to the left.two-columns-right- Displays pages continuously in two columns, with odd-numbered pages to the right.two-pages-left- Displays pages in two columns, by two pages at a time, with odd-numbered pages to the left.two-pages-right- Displays pages in two columns, by two pages at a time, with odd-numbered pages to the right.
viewer-preferences - A comma separated list of the following
possibilities:
hide-toolbar- Hides the viewer application's tool bars when the document is active.hide-menubar- Hides the viewer application's menu bar when the document is active.hide-window-ui- Hides user interface elements in the document's window (such as scroll bars and navigation controls), leaving only the document's contents displayed.fit-window- Resizes the document's window to fit the size of the first displayed page.center-window- Positions the document's window in the center of the screen.display-document-title- Controls whether the window's title bar displays the document title taken from the "title" metadata field.
PDF Security
These options allow you to specify owner and user security in the PDF output. User-level security can inject a password to be used to open the PDF, while owner-level security can control what can be done with the PDF (like printing it or copying the data from it).
userpassword - Sets the user password that must be entered to view the
PDF. There are no options, the @value passed is the password to be
used.
ownerpassword - Sets the owner password that must be entered to enable
advanced processing of the PDF. There are no options, the @value passed
is the password to be used. An ownerpassword is used to lock down certain privledges
that an owner will grant to a recipient of the PDF. Without the owner password,
recipients can be restricted from certain things. By default they are restricted
from everything, and you can then specify what additional things you allow by using
userpriviledges.
userpriviledges - A comma separated list of the following
possibilities:
print- Enables printing the document.modify- Enables editing the document.copy- Enables copying text and images from the document to the clipboard.annotate- Enables adding notations to the document and changing the field values.
PDF Pre-Press Options
These allow you to specify crop marks, bleeds and registration marks to be applied to the PDF.
crop-offset - specify offsets from the meaningful content on the page to
the edges of the physical media (/MediaBox entry in the PDF page dictionary). Its
value is a series of 1 to 4 length specifiers that set offsets from the edges of the
page area to the corresponding edges of the /MediaBox. Rules for expanding the value
are the same as for the padding property in CSS.
bleed - specify the bleeds — an extra space around the page area into
which the contents of the page may protrude (/BleedBox entry in the PDF page
dictionary). Its value is a series of 1 to 4 length specifiers that set offsets from
the edges of the page area to the corresponding edges of the /BleedBox. Rules for
expanding the value are the same as for the padding property in CSS.
crop-mark-width - defines line width for the crop marks, setting it to 0
disables drawing of crop marks.
bleed-mark-width - defines line width for the bleed marks, setting it to
0 disables drawing of bleed marks.
printer-mark - specify additional SVG images to be drawn in the offset
area surrounding the page (specified by crop-offset and bleed parameters). Printer
marks are clipped to the outside of the bleed rectangle. The @value is
a URL to an SVG you have. This sample has two URLs (one for a colorbar and one for a
registration mark) you can also use if you like.
The following code is what is behind this page for producing the PDF. Of course, you would only see the things supported by your PDF viewer you use. If you wish to see them all in action, then use "download" and Adobe Reader to view the PDF.
Recent changes in some browsers will not treat this XML as XML. Instead it tries (incorrectly) to not close tags. For best results, be sure to use open and close tags and not a self-closing tag.
<pdfproperties style="display:none;">
<metainfo>
<prop name="author" value="Xportability LLC"></prop>
<prop name="title"
value="Xportability Cloudformatter: Showing Custom
PDF Properties"></prop>
<prop name="subject" value="A Cloudformatter Document"></prop>
<prop name="creator" value="css2pdf@cloudformatter.com"></prop>
<prop name="keywords" value="CSS, PDF, Cloudformatter"></prop>
<prop name="custom1" value="value1"></prop>
<prop name="custom2" value="value2"></prop>
<prop name="custom3" value="value3"></prop>
<prop name="custom4" value="value4"></prop>
</metainfo>
<pdfpreferences>
<pref name="bookmarks" value="true"></pref>
<pref name="pdf-version" value="1.6"></pref>
<pref name="view-mode" value="auto"></pref>
<pref name="initial-zoom" value="fit-height"></pref>
<pref name="page-layout" value="two-columns-left"></pref>
<pref name="viewer-preferences" value="display-document-title"></pref>
<pref name="crop-offset" value="0.5in"></pref>
<pref name="crop-mark-width" value="1px"></pref>
<pref name="printer-mark"
value="http://www.cloudformatter.com/Resources/Images/registration.svg"></pref>
<pref name="printer-mark"
value="http://www.cloudformatter.com/Resources/Images/colorbar.svg"></pref>
</pdfpreferences>
</pdfproperties>
Sample Output H2
Est aliquyam diam ipsum clita no et at. Wisi invidunt lorem amet ex. No gubergren sit tincidunt aliquyam. Kasd aliquyam dolor accumsan aliquyam lorem facilisi sit dolores dolore lorem odio eirmod est ipsum et et duis voluptua. Voluptua takimata molestie nostrud ad magna labore sed rebum facer quis accumsan voluptua tation clita amet eum erat consectetuer. Consetetur eos sanctus lorem elitr aliquip clita dolore dolore dolor tempor. Delenit at takimata ipsum quis dolores sadipscing sed justo at stet. Sit sea lorem autem sadipscing est aliquyam in stet stet. Dolor commodo sed dolore ea nulla dignissim. Esse soluta tempor kasd erat aliquip exerci sea elit tempor.
Justo erat erat lorem praesent ipsum esse possim gubergren no erat feugait kasd magna lorem stet sed augue. Qui lorem sadipscing ut. Stet ipsum duo. Ipsum ea no facilisi te. Consetetur lorem takimata consetetur et stet vero magna sed nulla sea dolor blandit et zzril eirmod. Et gubergren aliquam nonumy voluptua sit invidunt in diam. Dolor tempor consetetur et laoreet ea consetetur et tincidunt rebum et no rebum nulla duo justo diam. Adipiscing aliquyam dolor voluptua dolore vel elitr adipiscing voluptua. Justo nihil accusam. Aliquip sed consequat consetetur aliquyam consetetur invidunt consectetuer vero nonumy voluptua sea eum takimata et eirmod et takimata.
Sample Output H3
Sed tation et erat sanctus consetetur diam diam magna amet. Voluptua tincidunt erat tempor ut et vero eos lorem labore ipsum vero. Amet takimata vero volutpat invidunt stet nibh clita est. Rebum sadipscing nonummy sed velit invidunt tempor amet sea. No et veniam eu rebum consetetur sanctus duis ut amet autem tempor et feugait blandit eos invidunt dignissim. Tempor accumsan no et est et eirmod. Lorem invidunt tempor amet eirmod nonumy amet vel consectetuer sed at accusam sed wisi aliquyam. In diam voluptua kasd accusam erat facilisis amet dolores sanctus hendrerit labore amet.
Ea option et consequat sea dolor lorem no eros luptatum. Et et iriure lorem dolor et. Duis erat ipsum in et et no dolor. Consetetur dolore nonumy ea sit no ipsum nostrud sed et sed ipsum magna in dolore volutpat erat tempor autem. Sanctus duo sadipscing praesent lorem invidunt dolore sit at sed amet sadipscing volutpat kasd sanctus. Ipsum amet aliquyam mazim. Lorem ut at sadipscing diam ipsum et et elitr. Voluptua eos ullamcorper magna voluptua suscipit sed consetetur dolore sed sed ut aliquyam et invidunt est invidunt. Est nulla feugiat.
Sample Output H4
Esse ut nostrud gubergren. Et dolores kasd erat dolores ut vero sed kasd. Nulla tempor elit euismod et ea kasd justo vel lorem sea ex gubergren et erat minim elit. Erat duo sit sit voluptua consequat nulla consetetur amet stet erat. Ipsum tincidunt amet. Sed dolor labore dolor sadipscing ullamcorper diam et clita stet ad ipsum erat consequat amet eos justo vel amet. Et magna gubergren aliquyam lorem sed ea lorem et ea sanctus dolor sadipscing sed elitr diam sed. Voluptua eos laoreet erat aliquam stet labore. Consetetur dolor stet amet dolor odio at justo vero voluptua elitr diam lorem et.
Zzril consetetur ullamcorper ipsum velit. Est eos sit iusto nonumy sed esse lorem nibh ipsum amet ipsum ea dolor dolore. No lorem sed invidunt invidunt dolores invidunt diam elitr aliquyam nobis sed eu eu tincidunt odio. Ipsum ea diam amet eos dolore ea commodo lorem erat. Sadipscing dolor dolor consetetur doming vero invidunt invidunt tempor consequat sanctus nonumy tempor est nibh labore. Nisl sanctus ipsum elitr vero magna augue. Sit elitr invidunt. Stet lobortis dolore luptatum elitr. Sed tempor lobortis dolor elitr consetetur justo aliquam sea dolor.
Sample Output H4
Consetetur kasd commodo nonumy consetetur rebum accusam ut ut lorem eos stet eirmod et labore rebum ut. Vero nisl sit tation ipsum minim. Nonumy ipsum tempor et magna nonumy eleifend lorem gubergren ipsum in sadipscing mazim quis duo sit takimata dolore invidunt. Te justo gubergren kasd sea. Gubergren vero assum takimata suscipit tation dolore ipsum accumsan et dolore et sed luptatum et. Nonumy dolor accumsan accusam zzril dolor est veniam nonumy voluptua dolores et kasd justo nonumy diam kasd. Est nulla ut ipsum tation invidunt te diam nonumy sit adipiscing sed. Est sadipscing ipsum nulla takimata. Tempor elit tempor duo sed duo aliquyam vulputate dolores sed est sea. Est dolores gubergren stet takimata tempor.
Erat quis sea velit erat ipsum vero nulla et at ipsum magna. Vero dolore qui nostrud vero ut no enim id dolore labore gubergren et. Vel consetetur delenit at diam volutpat et eros et erat ex ipsum et eos gubergren. Dolores molestie et lorem ad ut sed ipsum illum dolor sit vero ut rebum. Voluptua nonumy kasd laoreet tempor gubergren magna kasd consequat at wisi clita laoreet no voluptua rebum. Lobortis sit magna duo magna consetetur esse dolor ipsum gubergren gubergren voluptua accusam sed takimata in est. Sadipscing gubergren qui eos et ut justo dolor vero sit sanctus molestie. Hendrerit eirmod tempor in soluta. Velit amet consetetur sea invidunt duo lorem est justo clita consequat accumsan accusam ut soluta gubergren.
Sample Output H3
Diam et sit amet et et vulputate erat duo et. Eirmod labore dolore diam diam dolores sed ipsum sit eu est ut duis lobortis vel nostrud. Invidunt duis sea no labore lorem takimata blandit ipsum at iriure mazim. Sea amet labore justo amet dolore kasd erat. Qui vero justo ipsum vero elitr ipsum rebum ullamcorper consectetuer. Voluptua diam lorem esse diam. Labore nulla velit voluptua ullamcorper et vero magna diam ipsum dolor. Est vero nihil elitr ullamcorper amet eirmod nonumy feugiat at. Consequat iusto justo. Diam quis magna sit erat sed sit vero dolore erat ut dolore diam consetetur sanctus ut tempor dolor. Tempor exerci eos labore.
Aliquam tempor esse diam rebum justo aliquip ipsum et ut soluta no feugait vulputate accusam. Erat ea stet at sed ea consetetur vero accusam sed nonumy eirmod labore et labore sed ad. Gubergren diam sea labore sit kasd option. Ipsum diam eos voluptua clita sed duis sit. Et accusam kasd quod lorem elitr rebum eirmod invidunt aliquyam magna ipsum dolore tempor eos ad. Eum ipsum sit. Rebum ipsum voluptua ipsum eum ut et aliquyam ut sed consetetur tempor sit dolores no ea aliquyam at. Consetetur amet ea magna dolore nonummy tempor gubergren amet nulla dolor eu te. Ea ipsum justo ut facer suscipit labore minim no dignissim kasd nam ea.
Sample Output H4
Eu kasd in accusam eros. Duo volutpat accusam sadipscing vel in. Et praesent sadipscing eirmod enim te erat rebum. Enim lobortis et gubergren zzril tempor consetetur duis kasd clita sit amet blandit vel. Diam labore velit sit nisl dolor elitr. Et nobis sadipscing no tincidunt sed eirmod et tation rebum et sed justo ut et elitr magna magna.
Dolore et erat. Ipsum sed ea elit et dolores gubergren kasd sed te sit vero accusam. Dolor odio voluptua velit consetetur qui clita placerat feugiat illum. Nihil ea aliquyam eos gubergren ea et labore no te. Stet diam ea et nisl magna accusam nonummy esse eirmod vel. Dolore velit te voluptua illum rebum et et zzril commodo. Elitr justo aliquyam tempor magna dolor sed quod eos invidunt erat sea et accusam nisl labore erat. Est clita augue diam eos sed ullamcorper amet facilisi sed lorem invidunt ea labore consequat sadipscing. Molestie vero consetetur diam dolore te no et luptatum amet euismod exerci voluptua at congue. Et veniam vel dolores delenit eirmod ut delenit.
Sample Output H4
Sit invidunt sit consectetuer dolor sadipscing nonumy no ut gubergren tempor rebum et dolor duo vero zzril feugiat sed. Dolore esse lorem consetetur rebum elitr dolor dolor minim dolore assum. Feugait amet no nonumy diam aliquyam ipsum justo erat dolor nonumy sit vero elitr aliquyam consequat. Sed sanctus voluptua. Sadipscing vel duo blandit. Laoreet erat autem rebum sed.
Eos diam gubergren sadipscing feugiat stet labore magna nulla ut nonumy doming ipsum tempor. Ipsum et iriure at diam. Sed amet kasd in diam no diam amet vero elitr ut molestie aliquyam sit justo sed sed. Sed iusto consetetur nulla tation amet esse zzril zzril ad. Stet qui molestie gubergren amet sed eos amet praesent nonumy eirmod facilisis euismod soluta. Ipsum sea vulputate tempor molestie vero elitr takimata ipsum et dolores. In lorem et at dolor. Consetetur clita iusto vel nonummy invidunt et. Augue lobortis ex diam sit dolores vero amet sed aliquyam vero nostrud consetetur justo et eum takimata.
More Sample Output H2
Sed aliquyam sit. Ipsum sed nulla ea sanctus nonumy sed. Nonumy ea eros consetetur nisl accumsan vero nulla et diam autem at sed. Dolore dolores elitr elitr at. Eos ut consetetur ea augue gubergren tempor clita amet et justo sanctus et amet cum clita dolore sea. Eos lorem sed clita sit et voluptua lobortis dolor aliquyam stet consetetur. Stet et voluptua. Odio exerci diam quod accusam stet sed sit sea ut sed suscipit magna et ea dolores voluptua.
Amet clita consetetur. Tempor labore diam et velit et est elitr sit vero et. Ullamcorper clita elitr ut invidunt lorem amet elitr velit ut ipsum et diam consequat dolor nam kasd takimata. Et nostrud consetetur no voluptua adipiscing magna te erat dolor dolor eos vel. Sed diam sanctus consequat dolor.
Sample Output H3
Sit sit in. Justo facilisi velit lorem sit luptatum magna at tation ut dolor wisi invidunt aliquip nonumy accumsan sea. Dolore nonumy magna magna invidunt ipsum in labore eos hendrerit duo invidunt justo. Ut nulla dolore nonumy in nam. Et lorem consetetur at gubergren zzril sadipscing accusam erat aliquyam.
Tempor ipsum possim est elitr dolor diam erat vero vel. Kasd ut consequat odio magna nonummy aliquam eirmod dolore sit rebum amet justo. Sanctus stet labore duo duo sed vel duo aliquyam vel duis sit ipsum. Est et sed nonummy eum dolore dolor consectetuer voluptua erat sed dolore sed magna sit qui sanctus ipsum. Lorem suscipit in in amet sanctus et. Hendrerit nulla dolor at ea vulputate eu. Et suscipit est ipsum. Et dignissim eirmod sanctus et accumsan ipsum. Invidunt clita ut congue kasd labore.
Sample Output H4
Gubergren et erat. Accusam gubergren elitr vero lorem sadipscing tempor nonummy ipsum ut sit magna. Ipsum cum amet sit dolor eos amet stet sadipscing sed et consetetur doming at euismod aliquyam gubergren. Euismod praesent at et vero consequat stet dolor erat ipsum dolor sed sit et takimata ipsum stet veniam duo. Hendrerit gubergren est duo sit assum at option nulla blandit. Consequat sadipscing erat possim dolor eirmod eleifend aliquyam labore eirmod consequat dolor consequat tempor. Sanctus sit lorem sadipscing stet kasd sit consetetur magna ea stet eos et aliquip odio eu in vel iriure. Ut est vel eirmod delenit elit ea enim erat gubergren lorem sea magna magna vel quod sit.
Justo invidunt blandit dolor vero velit rebum adipiscing et. Velit diam ea sanctus diam magna amet sanctus. Imperdiet eleifend dolore feugiat. Eirmod ea eirmod sadipscing nisl eos erat invidunt sadipscing ipsum eos consetetur dolores sea stet ea consequat ipsum. Erat laoreet ipsum magna dolor vero sit eirmod amet consequat. Diam takimata suscipit suscipit dolor elitr magna. At lorem lobortis lorem ut et dolore amet erat elitr tempor justo sit soluta duo dolor est justo. Dolores justo nonumy eos gubergren. Tempor stet ea sea aliquyam vel erat.
Sample Output H4
Vero takimata sanctus voluptua tempor sed et consequat et sed. Erat elitr ullamcorper diam soluta sit vulputate takimata ut lorem lobortis quis eos nonummy kasd ea dolores. Ipsum vero nibh in. Feugiat clita eum lorem dolore tempor ea possim dolores commodo sadipscing nibh vero. No sanctus facilisis nulla vulputate dolor at esse kasd sea feugait at magna ipsum te.
Et nam vero erat sed et sit feugait clita. Consectetuer ipsum stet est dolor. Clita facilisis magna lorem ut invidunt dolore kasd nonumy wisi tempor facilisi sanctus takimata sed sed. Lorem consequat eos stet dolor elit ut diam ipsum lorem sed. Dolor lorem lorem nulla. Sit dolore sed et at ipsum kasd ad. Amet labore clita lorem erat tation cum vero gubergren vulputate erat dolor et sit sit facilisis. Eleifend et justo molestie.
Sample Output H3
Lorem commodo eirmod aliquip dolores sadipscing takimata dolor amet sea vero invidunt amet consequat eu elitr lorem. Erat accusam dolores nibh iriure odio rebum amet vero sed diam elitr autem esse. Amet stet diam vero no invidunt. Illum facer ea nonumy elitr diam sit. At sea possim. Feugait rebum et aliquyam qui et amet labore. Duo sea et erat nam dolore labore accusam diam sit. Eirmod ipsum nam iriure diam vulputate elit est amet vel labore zzril dolore et hendrerit kasd dolores vero. No dolor invidunt et duo autem consequat elitr lobortis dolores illum accusam invidunt sea.
Erat facilisis eirmod sanctus rebum est et et sit labore sadipscing. Wisi aliquyam et dolores dolor invidunt sadipscing dolore. Dolore voluptua dolor. Stet diam diam diam stet lorem hendrerit eirmod sadipscing magna. Erat eum sed molestie voluptua et clita amet ipsum et sit magna sit ea. Lorem autem amet ullamcorper rebum et. Adipiscing duo erat erat diam et qui justo facilisis eos duo illum lorem dolores erat liber nulla et. Sanctus et kasd velit.
Sample Output H4
Elitr nonumy lorem no eirmod invidunt et lorem nonumy sit sanctus nonummy sit sadipscing diam adipiscing est. Nonumy diam dolor autem exerci accusam diam sed possim ipsum ea autem eirmod dolor takimata voluptua. Amet nonumy feugait sed et ut eos. Nonumy et erat exerci vero vero eum. Accumsan dolor dolore vel nulla congue amet enim clita magna rebum labore elitr sea no ut et at sed. Nibh ea ipsum sanctus sed vel ipsum eos lorem eu minim tation ipsum eros eirmod aliquam eros. Sanctus ea consetetur elitr eu est clita dolor nisl ipsum stet. Facilisi soluta invidunt sit kasd at id voluptua elitr dolore nonumy sit erat. Illum justo no lorem no nulla no facilisis dolores diam dolore ipsum est elit.
At et aliquam est sed rebum at et labore tation at illum accusam eos invidunt dolor elitr magna. Dolor labore elitr nonumy nonumy duo amet sit no justo facilisi hendrerit. Sed ipsum takimata vero sit. Takimata dolore ipsum sed rebum et dolore. Est sanctus diam nisl erat diam erat odio gubergren dolores dolore et sanctus ullamcorper. Kasd ipsum voluptua justo ea.
Sample Output H4
Ea kasd dolor nostrud nulla dolores amet elitr diam dolor accumsan at. Eirmod justo ea sed lorem consequat volutpat eirmod sed elitr dolores elitr vel laoreet nobis. Nonumy sit aliquam. Eleifend rebum erat dolor luptatum ut sanctus liber duo no aliquyam lorem magna lorem takimata stet eirmod dolore. Vel placerat esse at et invidunt. Gubergren sea praesent est nonumy magna est gubergren euismod at diam adipiscing autem eu eos. Accusam duis clita consetetur clita et et in lorem tincidunt nihil tempor quod et eirmod elitr dolores dolore. Sit eirmod augue accusam at vel tempor odio magna eos. Eirmod et gubergren facilisis ea eum no et gubergren augue nulla aliquyam. Delenit et duo molestie augue tempor magna ea et clita et diam sed eu sit nulla vero.
Wisi quod invidunt euismod voluptua. Vel ad consequat hendrerit et elitr placerat no quod in ut blandit molestie sadipscing amet elitr sea et. Iusto amet vero ea voluptua. Invidunt dolores eros dolore nulla dolor et sed duo consetetur elitr dolores placerat quis et aliquyam sit dolor eirmod. At tempor nisl takimata vero gubergren magna. Nonumy amet gubergren ea sea et ut at. Consetetur clita consetetur.