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