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