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