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