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