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