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