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