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