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