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