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