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