PDF Properties

xportability LLC

PDF Properties

http://www.cloudformatter.com

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.

<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

Vulputate accumsan feugiat aliquyam rebum et option et. Aliquip sit ut duo ut sit lorem ut ullamcorper clita eum duo duo magna ut dolore sadipscing. Sed vero ut nisl blandit wisi. Nonummy velit ipsum duo ut no amet dolor dolor dolore nulla eum tempor elitr kasd consetetur duo erat iriure. Accusam iusto in consetetur ipsum accusam kasd accusam sit vel sit amet dolores kasd et. Accumsan dolor lorem ipsum vel et esse et in et magna mazim praesent aliquyam est labore eos dolore tempor.

Est accusam dolore voluptua at sanctus duis ut sed eu hendrerit ipsum lorem nonumy luptatum wisi hendrerit. Lorem duo dolor ut dolor ea et accusam. Eum dolores facilisis. Vero ea dolore dignissim. Vulputate voluptua eirmod kasd est sit augue.

Sample Output H3

Est wisi at facilisi in lorem et dolore est clita magna in dolores ipsum et diam et takimata qui. Labore justo duo ea lorem vero volutpat labore dolor dolor nobis. Sanctus labore duo ipsum elitr invidunt. Sed sed vero in et sit at. Et molestie lorem congue stet sed consequat magna.

Sed et augue dolore sed accusam eros aliquyam nulla. Nobis ut blandit autem eirmod in iriure ipsum sed veniam dolor soluta accumsan invidunt id duo. Sed eirmod exerci et ipsum vulputate tempor labore stet labore nonumy stet. Dolores eos lorem nonumy et esse et liber kasd justo ex invidunt takimata invidunt blandit magna lorem. Vero placerat stet sadipscing sea ipsum dolor lorem feugiat illum rebum sed quis. Diam ut vel vero dolore ut ea accusam ut dolor laoreet ipsum no tempor dolor consequat ipsum. Rebum vulputate eos facilisis consetetur eos ea sit exerci facilisi takimata ipsum in justo sed in no. Vero euismod at.

Sample Output H4

Esse diam gubergren diam velit amet no ipsum ea erat justo diam vel sed eos. Tincidunt elitr magna sea. Rebum amet aliquyam cum voluptua ipsum facilisis vero nulla accumsan dolor lorem autem. Dolore labore praesent diam et invidunt eos elitr vero eirmod. Mazim amet kasd et. Et vel takimata et volutpat nonumy rebum tempor. Nonummy nonummy amet nisl aliquyam ea sed. Cum in sanctus eos dolore no sanctus duo et te elitr tation aliquip tempor dolores. Gubergren labore erat sadipscing et ut adipiscing accusam aliquyam sit quis facer sed lorem ut et ea. Eum est diam gubergren nonumy adipiscing amet ipsum rebum no facer kasd dolore at at.

Duo et labore ut wisi. Ut elitr et magna. Nulla consequat tation wisi gubergren et vero stet et lorem et sed consetetur. Et est commodo qui ea takimata diam at. Dolores dolor dolore dolore clita dolore sed dolores justo cum elit rebum clita.

Sample Output H4

Ut ea et rebum tempor. Labore gubergren diam. Nihil aliquam sanctus. Est sea facilisi et consetetur in dolore sed blandit stet eleifend at magna sed at erat. No dolores eros ipsum amet dolor clita assum dolore et veniam tincidunt dolore amet. Duo dolor augue kasd voluptua magna dolores. Diam sanctus ea.

Stet aliquyam clita ut consetetur euismod molestie blandit erat lorem lorem dolore dolore. Autem dolore aliquyam clita labore erat dolor takimata tempor et. Et sea elitr et ipsum sit ex justo commodo facilisis ea eum diam autem lorem amet consetetur. Diam et vel. Ea justo dolor vel tempor dolore nulla elit sanctus in et tempor vero. Dolor sit sea sea eirmod dolores magna tempor gubergren. Erat dolore magna et sea duo. Dolore dolor ipsum vero eos eirmod dolores no eos amet dolores et iusto delenit.

Sample Output H3

Dolor clita lorem. Magna ut diam duo ut invidunt odio. Illum amet vero aliquam eirmod dolore duo volutpat justo dolor. Nibh vel lorem ea et. Amet doming ut justo imperdiet duis eu no accusam amet sit dolore laoreet takimata tempor.

Gubergren sanctus accusam rebum eirmod sed iriure sed est accusam consequat facer invidunt et et. Tempor feugiat gubergren accusam dolor eirmod sit voluptua sed eu magna facer est delenit diam lorem et et nonumy. Ut sit velit ea et dolore facilisi nibh lorem tempor est ut facilisis nam vel diam doming rebum. Et ipsum amet. Nobis amet sanctus esse takimata magna sit aliquyam ipsum sadipscing kasd est invidunt. Sed vel et ea clita diam ullamcorper nostrud eu ea duo erat stet et et.

Sample Output H4

Sanctus sea vel ut sed. Ea et id dolore takimata dolor magna zzril ut delenit dolor. Ad in in sed labore accumsan eirmod elit diam duo et. Clita aliquam eum. Sanctus sit clita. Lorem ipsum est lorem vel clita tempor te no erat et amet et. Vel dolore diam rebum sed. Sit facilisis nonummy dolor. Eros et tempor aliquyam augue accumsan diam clita assum liber ipsum amet sed et sanctus suscipit dolor. Dolor labore aliquyam ipsum nonumy accusam dolor ipsum hendrerit.

Magna aliquyam dignissim eros stet gubergren nonumy lorem est aliquyam no sed tempor. Et erat dolor ea eos duo nonumy wisi no tempor. Takimata esse consetetur dolores sea ea dolore eu justo takimata sit sed gubergren erat. Et takimata elitr vero sed takimata sadipscing et lorem tation labore nihil duo vero est. Et wisi ipsum lorem est sit eirmod. Ea voluptua magna duo nonumy erat elit eirmod sed nonummy commodo et eros ea et et stet illum. Vero sea dolore ea no rebum feugiat accusam ea amet takimata kasd et takimata sed gubergren accusam.

Sample Output H4

Tempor accusam aliquyam sit at gubergren velit sanctus accusam exerci et sadipscing. Eos amet sea est aliquyam. Est lorem gubergren takimata ut elitr. Ut diam at autem. Ex aliquyam eos id eos consetetur adipiscing consetetur et.

Sea sed blandit dolor enim tempor dolor lorem vero erat gubergren et aliquip diam rebum. Ipsum sea sadipscing sea amet dolor justo erat sit. Ipsum enim sed in invidunt vero invidunt adipiscing dignissim stet stet diam eirmod. Stet facilisis nonumy quis sed diam justo luptatum sadipscing eum erat liber nibh kasd. Dolores sed eirmod sanctus diam. Esse ut dolores.

More Sample Output H2

Labore eos at dolor. Erat et eu ad eos commodo. Takimata dignissim blandit minim et tempor ad commodo minim sea ipsum qui dolore. Et sea takimata laoreet. Lobortis illum suscipit elitr diam elitr elitr diam amet dolor ipsum gubergren dolores labore tempor ex.

Et eleifend ea aliquam rebum elitr dolor sit ut congue no. In sed eirmod dolore. Esse sit duis. Eos rebum sadipscing augue. Ea elitr eirmod. Illum consetetur ipsum dolore magna at diam labore aliquyam rebum ut. Liber tincidunt duo sanctus takimata accusam feugiat ut diam gubergren congue hendrerit vulputate dolor consequat. Gubergren aliquip voluptua soluta. Dolor rebum amet dolor kasd erat augue facilisi gubergren duo. Dolor in duo est vero.

Sample Output H3

Dolor feugiat sit ipsum sit sit vero diam erat ullamcorper accusam at tempor eirmod stet consectetuer lorem. Ipsum no vel dolore feugiat clita magna. Eros doming lorem. Et option magna. Sit et at eirmod feugiat sit sed et et sed dignissim labore duis consectetuer. Sanctus consequat nibh accusam lorem elitr labore et sed dolores duo et sed sed erat sed possim. Quis accusam elitr at wisi dolore consequat sit rebum doming tincidunt sed stet.

Stet consetetur aliquam nonumy diam accusam ipsum et est illum accusam ipsum praesent minim est accusam sit dolore dolor. Aliquyam diam magna. Amet nonumy vel. Ullamcorper kasd justo ipsum clita amet molestie ut te dolores kasd. Facilisi dolore eirmod voluptua in duo et vero no vulputate vero no ipsum aliquam amet. Clita nobis stet diam dolor sadipscing kasd vero ea duo ut laoreet erat odio kasd. Accusam quis dolor diam ut est. Nibh sanctus at justo eu tempor ullamcorper qui clita amet kasd et sadipscing et.

Sample Output H4

Rebum eros kasd kasd laoreet aliquip. Erat et quis dolore velit elitr et dolor nonumy sea. Invidunt dolores dolores vero aliquyam diam tincidunt dolores vero iusto duo dolore duo diam amet. Labore consequat diam consetetur commodo voluptua diam. Dolor ipsum magna ut in diam ipsum et ea et ut lorem euismod diam diam est lobortis.

Sanctus gubergren esse dolore stet accumsan sed et tempor ipsum stet eros. Nonumy et diam voluptua at. Accumsan dolores at eum aliquam ut sed sit accusam. Justo qui sea sadipscing zzril accusam et sadipscing voluptua dolores et duis dolores clita vero dolor et vero ea. Sit dignissim eros et blandit tation ea. Eirmod exerci accusam diam sea clita dolores rebum aliquam et. Justo sit cum qui kasd elitr vero justo rebum lobortis volutpat hendrerit dolores aliquyam erat. Et sadipscing mazim accumsan est diam sed est. Doming dolor mazim lobortis consetetur consetetur dolor.

Sample Output H4

Sit facilisi in invidunt option. Dolor elitr invidunt est odio labore est nihil kasd ea. Clita magna euismod. Duis gubergren commodo et illum facer sit rebum dignissim sed et illum eos labore. Est stet clita lorem sit augue est. Duo aliquyam dolor nonumy eum accusam at quod et ipsum lobortis et eum rebum amet. Ipsum kasd sanctus. Sed dolor amet magna augue tempor consetetur est takimata magna ipsum iriure. Ullamcorper magna diam consetetur dolor aliquip in te ipsum tempor est vulputate adipiscing. Tation dolor consequat dolor nisl et et sea dolore minim gubergren in feugait sit accusam amet dolor ex. Elitr tempor ipsum voluptua et.

Ea vulputate sea nihil facilisis nostrud sed at. No sed labore stet at suscipit aliquip eos sadipscing. Nulla gubergren nihil dolore nobis invidunt. At takimata vero ad. Laoreet dolor stet duo magna duo ipsum sit. Feugiat illum consequat clita sadipscing dolores eirmod wisi. Lobortis amet et est voluptua iriure sanctus sit et exerci at labore.

Sample Output H3

Est accusam amet et eleifend. At duo erat dolor et diam diam sit nostrud sadipscing duo dolores gubergren. Molestie quis est erat accusam duo duis magna no eros diam autem dolor. Elitr ullamcorper vulputate ipsum. Sanctus magna diam accusam sadipscing ut ipsum soluta est sanctus. Nulla no vero illum et gubergren wisi et dolores consectetuer euismod amet no accusam ea hendrerit dolor sed ut. Consequat accusam erat ad accusam duo takimata elit sit eos consequat nulla hendrerit at et justo euismod at wisi. Amet accumsan delenit. Praesent dignissim consetetur justo sed rebum minim takimata sit lorem ea tempor stet at stet ipsum soluta labore ipsum. Lorem ut amet labore lorem sit stet facilisis dolor te sea stet takimata accusam lorem dignissim takimata tation. Sanctus facilisi at aliquyam nonumy sed sit accusam sit illum.

Gubergren gubergren aliquip at feugiat duo gubergren dolore luptatum aliquip nonumy duis consequat. Dolor aliquyam eros voluptua elitr in sit sit elitr accusam. Accumsan commodo aliquam facer sanctus. Amet eos et elit volutpat. Erat velit soluta aliquyam laoreet sit lorem nisl id dolor nostrud diam. Augue nulla esse consetetur ipsum hendrerit duo et ipsum sea assum voluptua sed gubergren esse consetetur.

Sample Output H4

Clita eu sed magna diam ut elit nonumy eleifend eirmod dolores dolor amet invidunt. Vero sadipscing est at erat diam sanctus tempor lorem sadipscing. Ea eos lorem sed ut sed justo eos ea erat et sit. Rebum consequat stet diam aliquyam amet. Stet blandit te ut soluta consequat dolor. Clita est enim sed eirmod.

Nam nonumy nostrud tempor eros diam sed accusam dolores soluta voluptua et kasd rebum ea. Sanctus esse eirmod kasd et ipsum ad. Sit takimata takimata kasd gubergren ea luptatum stet sanctus accusam voluptua. Amet quod eos. Est sed nonummy dolor laoreet rebum sed et ipsum voluptua lobortis velit amet ea stet sadipscing. Dolor invidunt justo odio et gubergren dolore ut rebum rebum diam. Sed sed eos rebum gubergren quis eu dignissim clita dolore. Luptatum nostrud vel wisi elitr aliquyam dolor sea.

Sample Output H4

Commodo adipiscing exerci esse hendrerit vel laoreet elitr dolores diam. Sit diam vero ipsum no laoreet laoreet aliquam lorem iusto eirmod et magna odio clita consectetuer quis gubergren. Ipsum sanctus dolore invidunt dolore. Vero consetetur dolor dolores kasd ad sed lorem iusto veniam eu exerci dolore dolores. Liber nisl sed erat ea wisi diam duo elit. Stet dolore veniam gubergren. Duo sed nonummy et sit sed diam nisl nonumy gubergren suscipit lorem sea sanctus commodo vero. Sadipscing ipsum aliquyam. Sed takimata sit amet sed tempor sanctus sanctus lorem magna dolores augue erat. Lorem sed luptatum sit lorem et dolor odio justo euismod sit.

Et tempor vero eirmod ipsum erat takimata sea labore et vero dolor labore ut nobis sanctus duis et. Ipsum feugiat sea aliquyam vero voluptua ipsum consectetuer. Aliquyam eirmod blandit augue rebum dolore eos duo voluptua iriure eirmod. Laoreet tempor accusam diam in commodo enim eos magna ea takimata nostrud zzril ipsum commodo ut. Sit stet lorem dolor dolor accusam vel option. Ullamcorper sit kasd et magna nonumy dolore velit voluptua elitr invidunt consectetuer wisi. Ipsum ut sadipscing eos aliquyam consetetur dolor kasd option elit nostrud ut eu. Accusam et lorem vero sed aliquyam elitr voluptua. Magna dolores dolor diam aliquyam sed sadipscing stet diam est vel sit nulla gubergren lorem dolores sanctus.