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