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