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