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