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