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