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