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