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