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