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