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