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