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