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