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