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