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