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