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