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

Sit dolore lobortis molestie. Aliquip sed erat ullamcorper ut takimata. Et lobortis et et nulla diam magna. Magna vero dolore et et dolore qui eros at et invidunt et ipsum sit eos at sit. Magna velit stet et erat iusto consetetur diam. Ea diam diam sit justo dolores voluptua at id. Iriure stet amet autem ipsum nonumy diam erat diam vulputate et. Ea vulputate justo sadipscing et sit gubergren ipsum quis est magna sed ipsum consequat. Et suscipit amet voluptua id esse est sadipscing sed ipsum takimata eu erat vel diam lorem. Zzril et ipsum labore dolore voluptua no erat zzril takimata gubergren tempor eos duo consetetur nostrud accusam.

Diam stet tation dignissim stet diam vero vulputate. Adipiscing vero accusam dolore duo aliquyam illum. Magna dolores diam diam quis ipsum erat magna amet sanctus diam ut clita justo ea tincidunt invidunt. Accusam no sanctus kasd amet laoreet tempor dolore dolores dolor esse sed et dolor ut dolore eu. Molestie rebum ipsum luptatum nonummy velit duo sed duis est accusam dolore elitr eum sit lorem vero et. Dolor ea ea elitr invidunt delenit ullamcorper enim dolores tempor dolor lorem magna sanctus dolore consetetur nisl.

Sample Output H3

Option labore elitr gubergren eos et justo est. Nonumy magna et accumsan gubergren ullamcorper consetetur nonumy ut sanctus duis dolor et voluptua nobis est sanctus. Sed diam nulla ipsum exerci eirmod et eos takimata kasd eirmod elitr. Duo no takimata dolore. Accusam invidunt et. Clita odio quod ea et aliquip diam ut gubergren sanctus duo sed diam.

Est elitr kasd dolor eum duo et consequat hendrerit aliquyam. Elitr sed et zzril labore justo elitr et sed at. Nulla dolore dolore no volutpat. Dolore at labore diam amet justo ipsum dolore gubergren labore facilisi dolore. Ut et ut iriure duis amet eirmod dolor lobortis duis praesent nibh odio nostrud. Adipiscing nulla molestie aliquyam justo nonummy eos blandit sit suscipit. Erat dolores lorem vero labore ut lorem volutpat. Consetetur eos lorem et.

Sample Output H4

Laoreet accumsan takimata dolore consectetuer magna elitr nulla. No wisi sed dolor. Nulla ipsum velit sed dolor et nisl in consequat. Vel eros eirmod esse aliquip diam. Eros iriure dolore sanctus autem nulla dolor eos sed molestie iriure diam consetetur dolores. Autem labore sed sit labore no voluptua ut eos amet takimata autem. Sanctus esse eirmod sed sit justo takimata dolore autem vero. Esse amet dolores.

Rebum duis possim consequat accusam sadipscing diam eu suscipit tincidunt magna amet sea ea est eos. Diam duo tincidunt. Sit voluptua vero diam elitr stet et amet voluptua nonumy stet justo invidunt. Clita dignissim dolor et stet. Sea dignissim elitr eirmod sea takimata sadipscing ut vero nisl est amet sit amet dolor et delenit.

Sample Output H4

Facer stet labore erat assum dolores dolore invidunt no duo ex. Sed est voluptua. Adipiscing ea tempor et lobortis feugiat dolor praesent dignissim dolores stet vulputate. Kasd diam diam diam vel facer ut vero et ipsum accusam at. Ut dignissim vero erat rebum erat at lorem labore et diam illum sadipscing. Amet sit sadipscing et est duis nibh dolor et enim sea diam et elitr vel est ea ea. Ut consetetur dolore hendrerit et soluta blandit stet at imperdiet eros facilisis sadipscing. Feugiat eos elitr et ad et dolore. Tempor eu eu delenit mazim. Dolores justo eu sanctus stet. Sea amet aliquyam suscipit gubergren molestie clita amet aliquip clita aliquyam labore rebum commodo.

Sadipscing et labore lorem stet et eos dolores eos vulputate kasd eos iriure. Dolores tempor et duo et in tincidunt dolore sanctus erat veniam dolore gubergren sit tempor. Duis consetetur diam dolores te iusto eos magna sit soluta. Vel kasd eos vero dolor laoreet sit justo at qui dolor. Ea dolore eum et est ut rebum rebum voluptua aliquyam.

Sample Output H3

Et et erat quis erat. Ut in lorem sit sit sed et et dolor feugait. Eu kasd sed nisl duis et hendrerit duo est dolores clita adipiscing molestie elitr nobis et ut tation. Consetetur luptatum vero sanctus labore dolore amet ipsum in dolor et ea. Sanctus amet ut dolor sit lorem in elitr accusam imperdiet tincidunt delenit eos no duis lorem. Duo ipsum no tempor labore volutpat sea amet sea sed magna et ipsum.

Eirmod doming facilisis. Qui rebum tincidunt zzril eos et. Et et diam dolore feugiat. Lorem ipsum et labore sea ipsum ipsum sit delenit molestie. Euismod elitr justo et. Soluta magna doming aliquip no ea eleifend voluptua et odio. Veniam commodo ullamcorper vulputate et ipsum ut et qui. Tempor vero ipsum molestie et nonumy clita. At rebum molestie justo tation luptatum. Amet lorem facilisis duis ipsum sea dolor voluptua autem erat ipsum est amet. Nulla option imperdiet ipsum rebum zzril diam ipsum facilisis.

Sample Output H4

Eirmod est no lobortis sed elitr diam sea tempor dolor et ipsum elitr molestie nulla invidunt justo. Quod praesent et clita clita feugiat et at luptatum nulla invidunt feugait consequat. Et lobortis feugiat tempor in eu justo tempor clita dolor rebum. Dolor ut aliquyam dolores sed erat ut rebum accusam diam clita diam. Sea ut dolor vel gubergren et autem consetetur eos at molestie tempor molestie facilisis liber wisi sanctus. Invidunt ipsum zzril accusam aliquyam justo ex. Vulputate ipsum iusto ipsum dolore placerat sit nostrud ex sea ea. Delenit at consequat invidunt sit nonummy soluta eos.

Sit volutpat autem et. Eu feugiat takimata diam ut sadipscing ea. Placerat aliquam labore in aliquyam sadipscing gubergren at magna amet iriure sed clita et veniam no et dolore tincidunt. Tempor ipsum diam eleifend stet aliquyam vulputate labore consetetur magna stet enim rebum elitr amet dolore clita amet et. Erat sed lorem dolores ipsum aliquyam zzril lorem stet magna. Erat duo dolor aliquyam dolor consequat dolor feugiat et dignissim at duis amet invidunt clita gubergren justo ut kasd. Iusto rebum stet ex sea ipsum eos nihil dolore et dolor lorem. At amet dolores.

Sample Output H4

At lorem no justo. Consetetur nisl dolor. Aliquyam sed sit amet ipsum ut et dolor tempor. Labore accusam ipsum gubergren est autem et aliquyam hendrerit amet invidunt elitr at lorem eos gubergren. Suscipit cum voluptua justo amet elit consetetur elitr nisl no lorem quod eirmod. Mazim sed sit. Id ut tation est. Dolor rebum ea dolor eirmod nonumy stet eos et nonumy lorem eu ipsum vero et. Diam et blandit. Nisl rebum tempor eleifend ipsum eu ea praesent et ipsum at gubergren sit eirmod voluptua eirmod. Ut kasd lorem eum diam dolore suscipit vulputate ipsum feugait ad diam consetetur qui eos nonumy accusam.

Nonumy vel est nobis vero delenit dolor eum. Labore sed sit sanctus ea. Lorem invidunt erat et duis. Amet voluptua ipsum eos et facer nibh euismod ut. Sed elit zzril. Erat aliquyam nonummy delenit.

More Sample Output H2

Eirmod in velit. Gubergren amet kasd sit rebum lorem gubergren ipsum at at aliquyam. Dolor sed diam vero amet rebum erat sit. Lorem vulputate sanctus kasd vero ut et consetetur accumsan vero facilisis. Nostrud stet et aliquyam dolore aliquyam ad kasd dolore sanctus placerat augue et erat.

Sanctus dolore vero augue invidunt elitr sanctus tempor eirmod. Diam autem gubergren diam. Erat ipsum eos vero minim justo exerci ea labore. Hendrerit ut minim labore consetetur sit iriure euismod in tempor stet molestie clita. Volutpat facilisi dolore elitr doming sed accusam dolor consetetur molestie consetetur no praesent sanctus sit ullamcorper.

Sample Output H3

Diam et veniam takimata exerci accusam kasd velit amet. Invidunt amet nam tincidunt sed gubergren. Vero et magna eirmod sadipscing voluptua in sed consetetur vero et clita. Clita tempor no ut ipsum veniam mazim erat. Ea magna et amet eirmod amet vero et eleifend justo hendrerit ex diam ipsum tincidunt elitr. Takimata diam et delenit dolor vero sit nonumy eos ea placerat et no. Ipsum hendrerit in sit nonumy luptatum ipsum accusam dolor dolor at elitr lorem et accusam. Et et sadipscing. Lobortis et stet molestie lorem eirmod autem accumsan ea volutpat accusam consetetur stet takimata sanctus clita consequat lorem labore. Consectetuer invidunt tation vulputate sit est consequat nibh.

Enim at erat dolor iusto accusam facilisis eirmod eirmod dolor et elitr. Justo sadipscing illum et dolor. Gubergren duo dolore diam ex nisl et. Id dolor consectetuer sed justo. Autem ipsum facilisis ea vero et ut amet commodo possim stet possim invidunt rebum hendrerit. Duo et sanctus diam no accusam sanctus vel imperdiet dolor sit sit ut et. Kasd dolor ipsum erat et ipsum. Ipsum labore sed vero justo eos. Kasd erat no eirmod labore wisi autem ut elitr magna at.

Sample Output H4

Eirmod no justo nulla et erat lorem diam tempor labore labore vero sit duo invidunt praesent lorem feugiat. Et eos vel option sadipscing takimata labore consectetuer eirmod at kasd et lorem duo eirmod ipsum. Ipsum nonumy sit vulputate dolor lorem. Diam vero rebum diam justo diam duo elitr amet diam. Elitr ipsum delenit voluptua consequat.

Commodo dolor voluptua dolores magna sanctus eu ut duo consequat iriure lobortis. Rebum sea sadipscing ullamcorper justo elitr wisi sit consetetur takimata justo. Rebum tempor accusam. Est tempor iusto delenit dolor vel dolor et accumsan. Eros ipsum consequat gubergren qui magna veniam nostrud sit ut te diam sea lobortis et kasd at. Tation erat duo. Tempor ut stet takimata takimata est lorem rebum eu voluptua amet voluptua labore at dolores sit labore tation. Invidunt ipsum accusam amet et ea rebum elit tempor sed dolor tincidunt enim voluptua.

Sample Output H4

At sit nihil diam at enim invidunt vulputate labore nonumy magna vero diam. Takimata facilisi sit ipsum magna dolores et sea ipsum accusam sadipscing sanctus amet justo diam labore. Sit diam dolor tincidunt sit accumsan gubergren amet ipsum amet ea dolores. Est laoreet eum gubergren. Iriure ut dolore consetetur possim sed sit dolor laoreet sit justo. Duo vel illum blandit stet aliquyam diam sit lorem. Praesent dolore diam. Sed sed eos dolores dolor feugiat ut dolores.

Sadipscing hendrerit sanctus et sed sanctus labore clita feugiat accusam dolore. Aliquip sea ullamcorper et minim vel dolores. Vero diam dolores ipsum labore facilisis at vero. Eos sed ut ipsum no vero et vero vulputate nulla eos lorem. Nonumy sanctus in at velit rebum elitr diam ea no lorem tempor. Lorem laoreet ut et aliquyam aliquyam no diam no sanctus. Cum elitr gubergren lorem voluptua voluptua dolor ut at diam. Kasd labore takimata est kasd dolore diam sed ut vel amet nibh accusam aliquyam possim et duis.

Sample Output H3

Et ea enim sed facer et luptatum. Et diam lobortis ea no eos molestie erat justo consectetuer at et gubergren illum duo. Diam sadipscing et clita et luptatum elitr invidunt praesent tempor ipsum ut erat eum blandit exerci stet. Sed sit illum et invidunt nisl aliquip duo accusam clita et elit. Diam erat erat rebum eos ex lorem imperdiet dolor sed duo ipsum et et. Vel in erat. Facilisis aliquyam sed sit amet. Takimata magna nibh no no. Justo accusam nisl clita.

Aliquyam est no no et nonumy ex sit. Magna labore amet elit diam. Nonumy est justo nulla eu ut diam et et et eirmod. In ea voluptua. Sea delenit takimata ipsum elitr sea duo dolor nonumy et kasd labore. Dolor sit et velit. Stet dolores stet sit sadipscing nulla diam aliquyam nonumy et iriure dolor. Dolor sit minim sadipscing. Hendrerit congue lorem.

Sample Output H4

Labore elitr dolor sit voluptua lorem et augue. Magna et invidunt no clita diam erat et at rebum justo amet dolore. Accusam magna tempor erat est diam et tempor ut nobis dolore ipsum at. Est dolores zzril dolores dolor dolores ea dignissim. Tempor nisl invidunt kasd nonummy. Et kasd suscipit invidunt tempor sanctus tation et et sit invidunt stet. Diam ut ipsum stet luptatum takimata consetetur sed congue. Dolore duo nonumy dignissim ea sit eros eirmod amet at vel zzril diam vero stet labore accumsan. Blandit sed molestie dolore lorem ea nibh ea eos accusam ut.

Et sed takimata voluptua justo ipsum tempor elitr volutpat feugiat stet dolor tempor sit. Sed eos sit clita gubergren duis nisl et amet consetetur rebum vero at et. Lorem blandit aliquip elitr. No ea lorem sadipscing vero dolore vero dolor sit magna amet et zzril et aliquip. Est elitr elitr dignissim id eirmod nam magna est vero clita. Velit at aliquyam. Sit ut labore quis eos. Nonumy iriure sanctus liber duo dolores eirmod ipsum sadipscing magna sed diam lorem vel exerci possim ipsum. Sed duo nonumy ea no ipsum dolore diam et sea accusam erat ut sed sit ipsum justo. Lorem nonumy ipsum diam praesent takimata eleifend tation ea dolor no vel gubergren et magna dolor.

Sample Output H4

Duo facilisi est sea at elitr voluptua et voluptua ad justo assum. Sit et rebum et zzril duo eirmod justo dolore lorem dolor dolore labore sit. Ipsum aliquyam dolore lorem velit suscipit aliquyam facilisis voluptua accusam. Kasd ad et magna tempor. Diam ea nonummy feugiat facilisis lorem ex sed vel ut invidunt suscipit soluta voluptua sed tation. Nulla dolor aliquyam vel lorem lobortis et nonummy molestie ut amet nibh sadipscing consetetur. Stet ea est dolor et clita justo aliquyam labore feugait sea aliquam nibh accusam sadipscing stet vero consectetuer. Lorem labore takimata consequat sed tempor sea autem voluptua rebum duis accusam nonumy elitr invidunt gubergren amet. Lobortis dolor consetetur sea amet.

In labore in accumsan erat in voluptua sed ut sed amet lorem justo diam at consequat dolor. Dolores ut eirmod. Sit in clita sadipscing dolor dolore autem ipsum quis nisl consetetur justo tempor elitr sit vero feugiat sed. Facilisis eirmod consectetuer justo lorem feugiat dolor. Clita sit ea consectetuer rebum eos lobortis nonumy. Nihil tempor amet feugait sadipscing dolore duo eum erat erat diam commodo duo invidunt sit consetetur at.