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

Sea iriure nonummy ipsum lorem sit vel nihil. Vero et tempor. Et ad esse consetetur et sed gubergren sit in sed gubergren no erat elitr. Commodo laoreet ipsum molestie diam tempor dolore vero laoreet takimata erat sit elitr diam diam et duo diam enim. Sit duis nobis est facilisi nonumy voluptua nonumy enim ut id aliquip ut. Lorem stet dolore kasd aliquyam duo sit nonumy clita nam. Eleifend labore duo te sea elitr magna. Et dolore zzril at sadipscing magna dolor clita stet gubergren molestie stet sed qui cum erat et no erat.

Ut takimata invidunt amet sit sed est. Erat quis consetetur duis. Lobortis facilisis dolores clita diam invidunt feugiat takimata no erat consetetur. Sea sit duis velit ut et est. Invidunt justo ut sed aliquyam at nonumy sit lorem sit justo quod ea. Dolor diam dolore stet accusam justo eirmod sanctus consetetur facilisis veniam clita sadipscing. Et diam sadipscing ut eirmod sed eos labore justo hendrerit et clita sit feugiat.

Sample Output H3

Tincidunt amet sea nulla amet laoreet. Placerat clita qui dolor erat at diam ut sadipscing aliquip nulla facer amet lorem hendrerit ut takimata. Sea sea sed aliquyam vero vero tincidunt dolor aliquam invidunt vero clita ea diam dolor amet. Aliquyam justo ea magna ipsum suscipit lorem diam gubergren luptatum sed est justo amet erat. Et sed augue dolores kasd justo nulla iusto zzril ut iriure suscipit magna dolor. Lorem velit ipsum clita velit sed possim sed ea eirmod takimata ad elitr consequat ipsum sit invidunt eu.

Ipsum eos sed diam dolore facilisi consetetur. Accumsan et rebum sadipscing sadipscing autem stet consequat adipiscing eirmod exerci diam euismod dolore nonumy rebum est magna. Vero dolore eos takimata voluptua accusam labore sit zzril exerci tempor dolor erat dolor illum accusam. Iriure ipsum ut in clita et luptatum ipsum accusam dolor eos sanctus diam elit eos at justo et. Vel sadipscing nonumy accusam nulla ea lorem accusam sed invidunt autem rebum magna ullamcorper. Et sanctus dolor feugiat kasd duo diam sed lorem justo clita feugiat sit sed accusam diam. Voluptua vero accusam sed lorem diam elit quis in duis consetetur. Vero diam at ea consectetuer erat dolores kasd diam gubergren nonumy erat nobis dolores sit clita aliquip.

Sample Output H4

Tempor sea eirmod dolore vero. Sit luptatum erat congue ea velit sanctus dolor ea aliquyam aliquyam invidunt. Ipsum lorem lorem et molestie dolores labore at nulla ipsum takimata tempor no vulputate vel eos invidunt justo molestie. Voluptua amet rebum eirmod dolore voluptua nonumy labore. Vulputate lorem suscipit at in sit dolor labore elitr vel ut nonumy ad sadipscing clita facer exerci. Dolor accusam vero clita kasd et. Tempor tempor ut et ea veniam clita lorem diam diam duo duis clita invidunt velit. Diam sadipscing dolor. Duis illum placerat ut ut odio lorem lorem rebum vero. Eum et euismod tempor autem no dolores takimata vero. Sed amet tempor augue takimata option nonumy adipiscing magna ut lorem vero vulputate nam.

Wisi blandit dolor takimata sea consequat esse duis. Sit tempor magna sit. Eos ut erat erat nisl iriure tempor nisl accumsan sanctus ea eirmod labore justo tempor et eros. Aliquyam lorem at. Kasd dolores option diam ipsum sanctus dolor at consetetur nulla sit ipsum stet. Et doming lorem amet voluptua stet no hendrerit elitr nonumy molestie. Duis no vero vel amet illum sanctus velit facilisi sea autem dolor diam dolore.

Sample Output H4

Kasd voluptua sed ut nostrud soluta ut magna et ut diam stet tation. Et gubergren consectetuer eu in nibh nobis sed et. Elitr vero kasd et dolor luptatum lorem diam amet quis zzril lorem dolor. Diam kasd euismod in zzril luptatum nisl dolor sit eos ipsum hendrerit. Rebum hendrerit voluptua dolores et ex clita sadipscing velit.

Labore et invidunt sit duo dolor est at clita gubergren elitr dolore est. Stet takimata accumsan dolore takimata aliquam. Nulla ea ut takimata et nulla rebum magna invidunt voluptua. Tempor amet in consetetur nulla nam exerci lorem duo tation tempor duo et. Duo sadipscing lorem eum labore consetetur nibh. Voluptua laoreet ullamcorper sit nostrud nonumy justo diam nibh at takimata assum wisi gubergren rebum aliquip sea dolor.

Sample Output H3

Tempor sadipscing amet luptatum stet consectetuer ipsum zzril kasd cum elit. Tincidunt labore dolor duo nisl sed consetetur et aliquyam sed magna justo sea aliquip sed sea. Dolores justo invidunt sea takimata consectetuer. Nibh nonumy et voluptua. Nulla clita voluptua nostrud at kasd magna ut aliquyam. Eirmod elitr nonumy. Ut clita magna aliquyam nonummy vel eu ut clita labore. Takimata magna qui justo gubergren eu vero dolores hendrerit sed.

Vero ut vulputate consetetur lorem. Justo invidunt sed invidunt illum sanctus et autem blandit. Aliquip elitr aliquam lorem. Kasd justo no clita. Et amet no invidunt dolore amet elitr sea accusam ipsum diam consequat et dolore consetetur. Volutpat nam invidunt facilisis commodo rebum ipsum illum esse amet blandit molestie stet ad gubergren kasd et. Stet et diam iusto velit esse autem stet at veniam ipsum sit no accusam sanctus dolor takimata. Eos labore in est justo duis nonumy nonummy ea hendrerit.

Sample Output H4

Ut sea praesent at laoreet vero. Ipsum dolore justo ea illum diam aliquip vero dolore diam et nonummy et elitr consequat elitr ipsum lorem sea. Autem autem consetetur accusam et dignissim lorem gubergren sit dolor vel lorem dolore et diam delenit lorem duo sadipscing. Vel justo sed. Amet et vero magna ut ea blandit in. Eos sed duo velit lorem sadipscing aliquyam ut dolor consectetuer. Nonumy ut id illum magna et nonumy magna voluptua consetetur labore iriure mazim. Accusam lobortis iriure et at aliquyam enim voluptua lorem gubergren amet diam vero. Eros dolor tempor consetetur est sea molestie nobis aliquam. Dolores stet diam assum et qui facilisi iriure in invidunt feugiat.

Duis dolores dolor sed aliquyam sit dolor magna diam dolor ut aliquyam gubergren consectetuer diam no elit. Eirmod labore dolor ipsum. Lorem aliquyam esse ut et ipsum invidunt facilisi amet takimata sed diam kasd dolor kasd. Aliquyam eirmod magna stet et at labore stet labore dolor invidunt elitr commodo diam. Et consetetur accusam ipsum cum at dolore ea no. Exerci sanctus lorem magna takimata feugiat ullamcorper ut eleifend lorem dolor accusam sed eu erat aliquyam. Sit justo nisl amet no est nam amet esse dolore ut et erat. Vero accusam diam tempor et sit vel.

Sample Output H4

Delenit lorem dolor sed molestie. Invidunt tation clita. Dolore voluptua amet est eos lorem sit te. Lorem lorem et dolor odio est eos lorem amet. Elitr erat kasd vero erat est nibh kasd rebum labore amet et ea tempor dolor dolor dolor. Et nulla diam justo nostrud diam et et feugiat velit amet ut stet sit sea tation diam gubergren accusam.

Sit zzril nonumy tempor in nonumy. Vulputate nulla amet et dolor eum et tempor sed ut aliquyam. Ipsum voluptua at invidunt lorem nulla et et elitr euismod takimata sadipscing diam sit sea ea sadipscing. Dolore dolore takimata congue stet sit in iusto. Duo stet dolore dolore eos possim invidunt duis ullamcorper voluptua euismod nonumy eu accusam ut amet. Hendrerit ipsum eum dolor nisl justo te consequat in nam dolore eos eum at sea sed.

More Sample Output H2

Sea esse sed invidunt dolore elitr ut consequat. Eirmod dolor accusam kasd eirmod dolore magna. Lorem kasd ut elit consetetur gubergren facilisis dolore et at. Sed dolor sit sea nonumy duo diam dolore est ex amet liber dolores dolores. Sanctus justo et te tation sed consequat ad liber duo nonumy lorem stet tincidunt sed. Lorem et diam accumsan erat dolore diam et euismod kasd dolore voluptua voluptua invidunt ut duo dolore ea enim. Vel ut consectetuer accusam sit facilisi sit consetetur sit rebum ipsum duo sed duis stet. Sed sadipscing et aliquyam sed tempor dolores duis. At molestie magna minim eirmod et ipsum kasd. At rebum et duo duis ea invidunt feugiat et enim diam nisl.

Kasd ut invidunt magna ut labore dolores tation elitr nonumy sit accusam et option eu. Elitr lorem sea justo takimata. Ut gubergren minim veniam consetetur eum est magna ea. Ullamcorper voluptua lorem tincidunt dolor volutpat et iusto tempor zzril et voluptua dolor dolore amet lobortis. Lorem laoreet et.

Sample Output H3

Ut elitr erat rebum sea eum sed nonumy et odio sea et eirmod duis dolore diam et. Accumsan ea labore id imperdiet imperdiet sadipscing diam dolores nonumy vel. Ipsum dolores accumsan sea sed clita magna dolor nostrud sed dolor lorem. Dolores lorem ipsum at eleifend. No aliquyam erat in voluptua lorem. No illum accusam duo dolor nonumy eros et iusto diam iriure at. Elit tincidunt feugiat labore eum euismod ut luptatum sit gubergren diam dolore dolores magna sit magna. Laoreet consectetuer sea.

Eum eos iriure option vulputate et sadipscing. Imperdiet gubergren amet erat gubergren sit facilisi consetetur aliquyam ut. Te duo et aliquyam dolor nulla sea eirmod aliquyam sit eirmod gubergren dolor sed dolores magna duo veniam dolor. Clita at wisi illum. Labore sanctus et et sea voluptua doming clita consetetur est delenit tempor duo diam justo consectetuer labore.

Sample Output H4

Ipsum lorem rebum lorem sadipscing tempor. Nobis labore sit dolor tempor duo rebum lorem labore vero eirmod velit aliquyam. Molestie lorem elitr et. Consetetur dolore accusam sed et clita tempor takimata et magna lorem ipsum diam labore et. Minim clita mazim dolores rebum hendrerit duo est iriure amet et vero dolor quis. Et labore diam sadipscing sed. Sanctus lorem exerci sit veniam sit duo rebum est consetetur tempor ea option consetetur tempor praesent ipsum. Aliquam stet luptatum dolores at. Aliquyam est facilisi. Nulla ut tempor takimata vulputate aliquyam nam nonummy labore praesent ipsum nihil labore. Nonumy sit aliquyam.

Sit rebum diam magna duo mazim sit consectetuer nulla eos minim et nam. Eos dolor et takimata sit at et erat et amet et et et. Et nonummy vero et dignissim soluta at ex dolor lorem. Dolore clita minim ipsum sed. Nulla magna vero gubergren et duo nostrud labore labore sit. Facilisi accumsan dolor dolor qui autem takimata magna option iriure. Lorem dolor et kasd et ipsum illum diam ipsum magna labore consetetur vulputate. Autem molestie duo nulla magna et dolore. Clita elitr et gubergren eos rebum veniam et dolores ut.

Sample Output H4

Sanctus sea eirmod kasd ipsum voluptua dignissim magna et nonumy tincidunt nulla est sadipscing tempor amet. In dolor sed stet accusam invidunt aliquyam amet sanctus quis dolores duo magna iusto at sit sed duis. Duis sanctus nam accusam magna sit est et tempor lorem sanctus. Diam magna enim duis no et et diam sed. Dolores magna dolore ipsum.

Duo lorem elit vel vel lorem ad et labore magna zzril stet et stet. Ullamcorper illum et sed ut eirmod amet dolores. Rebum ut magna. Diam no ullamcorper amet ut takimata est nonumy. Nonummy dolores clita takimata sit dolore sed. Nisl ullamcorper sed kasd voluptua nulla ea sit tempor et takimata. Doming et diam labore et sadipscing quod nam dolore ea sadipscing at sanctus amet lorem ipsum erat. Autem enim nonumy molestie nibh amet ipsum no amet facilisis consetetur.

Sample Output H3

Sed ipsum vero rebum labore in sed ut elitr justo. Ipsum eirmod sit accusam gubergren at ut et ipsum duis. Ut sadipscing kasd vel magna aliquyam dolore euismod aliquyam clita eos tempor sit eum eos. Possim diam eleifend et vero duis duo. Mazim duis et congue sea eirmod gubergren nulla et suscipit feugait magna. Autem dolor dolor invidunt autem nonumy sed in duo amet sit imperdiet ipsum tempor diam ut et diam. Sea hendrerit consetetur ipsum consectetuer et dignissim hendrerit sit. Lorem tincidunt labore sit enim sanctus eum. In voluptua gubergren sanctus sadipscing elitr minim accusam dolor. Amet labore iriure gubergren sit ea eos eu dolor sea et lorem erat.

Et elit sed clita sit et. Dolore amet praesent sit et sit ea invidunt at minim magna et elitr. Dolore sadipscing sit duo erat nonumy ipsum aliquam lorem esse autem aliquyam erat. Duis et eros. Et tempor dolor nonumy consetetur. Dolore lorem quis duo labore. Et amet molestie kasd vel. Id eum sit dolore sanctus nulla dolor amet tempor.

Sample Output H4

Nonumy at dolor invidunt at sit vero ea tempor amet sit invidunt at id. Esse et no ipsum clita duo elitr kasd imperdiet et sanctus amet et eum dolore diam. Wisi stet nonumy in dolore labore aliquyam sadipscing ea. Dolor sit quod. Eros vero consetetur nonumy diam invidunt eirmod vero eos eu ea at ipsum justo dolore. Accusam et et. Ipsum stet dignissim at tation lorem labore no sit et sed sadipscing ipsum. Rebum sea dolore aliquip dolor. Sed in lobortis elitr. In magna kasd laoreet labore at sadipscing.

Cum augue ipsum consequat sit gubergren dolor vero diam sit aliquyam sanctus et consetetur tincidunt voluptua eu. Nonumy aliquyam rebum lorem vero ad duis feugiat labore facilisi dolor feugiat dolor ut. Sit invidunt consequat accumsan facilisis diam dolor nonumy lorem facilisis diam tempor et tempor clita. Consequat commodo iusto lorem ipsum. Suscipit sea vero diam qui lorem aliquyam et magna nisl ipsum veniam dolore velit vero dolore eirmod ipsum.

Sample Output H4

No ipsum labore. Vulputate stet dolor accusam consequat erat at zzril magna. Justo tempor consectetuer ipsum blandit justo. Dolore consequat consequat soluta dolore et minim. Lorem enim accumsan. Sea erat dolor diam ea sit sed dolor no lobortis dolores sed.

Et ut zzril illum et no vel dolore gubergren et dolore at sed duis amet sea. Consequat esse amet ut et commodo lorem est possim duis duo ipsum dolor ipsum facilisis. Labore sadipscing sit. Delenit lorem feugiat ipsum no assum kasd sed sed sanctus iriure ut amet. Sit sadipscing et et diam duo minim rebum voluptua duo blandit sed rebum iusto est kasd. Ipsum lorem duis facilisi ut takimata sit commodo stet et sit stet elit praesent dolore lorem aliquyam erat. Te sanctus diam nostrud ipsum justo et tation lorem.