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 quis lorem amet diam magna amet dolor et erat odio voluptua. Lorem et lobortis elitr duo te consectetuer sit clita et aliquyam ipsum. Duis aliquyam ad justo nulla duo diam euismod consetetur sit mazim eirmod erat rebum amet. Sadipscing sed quod tempor dolor at gubergren gubergren duis doming nisl erat sea eirmod amet takimata dolor lorem sit. Amet dolor et. Accusam sit sanctus gubergren. Velit et rebum. Dolore ipsum molestie volutpat kasd justo ut accusam et.

Sit no duo sanctus duis illum justo augue rebum aliquyam diam clita hendrerit vulputate lorem amet et amet est. Eos tempor et at ut. Voluptua elitr dolore consetetur lorem et lorem sanctus takimata illum labore lorem vel sit. Eum sit commodo clita in amet magna iriure mazim eirmod et sed justo ullamcorper ipsum. Tation est clita. Nonummy dolor et dolore feugiat elitr elit ipsum duo dolore magna velit no iusto.

Sample Output H3

Zzril sanctus amet. Sed dolor eirmod est quis eirmod duo dolore lorem in sea augue stet labore. Elitr aliquyam aliquam assum ipsum erat et. Aliquyam invidunt blandit. Et dolor voluptua sea suscipit diam sanctus eirmod illum stet ea velit elitr eros nobis sadipscing ipsum ipsum takimata.

Kasd magna delenit aliquyam vel et no no justo takimata ipsum kasd justo dolores accusam sed sed erat velit. Sit no clita zzril labore duis diam facilisis justo autem doming feugiat. Consetetur suscipit sanctus erat ipsum justo aliquyam dolor aliquyam clita. Stet euismod eos ullamcorper aliquyam et tempor eu hendrerit vel erat zzril. Lorem dolor nonumy diam rebum dignissim. Aliquyam sadipscing elitr at dolore kasd feugiat aliquyam dolores nisl luptatum praesent. At soluta nibh esse. Sit takimata veniam erat eirmod duo et nonumy no eos. Erat in soluta consetetur. Voluptua sit labore lorem erat.

Sample Output H4

Takimata rebum et ipsum autem quis et ea esse dolor eum facilisis eos diam nobis lorem et. Facer ipsum dolores erat eirmod magna rebum elitr erat amet ea sadipscing dolore invidunt vel stet suscipit rebum. Consequat aliquyam amet sadipscing dolores erat sed kasd nonumy stet amet iriure duo diam nonumy nisl sit. Sed diam dolor nonumy lorem vel et eleifend. Autem takimata erat kasd dolor sit ea eos lorem et no option magna gubergren dolore at.

Takimata wisi rebum consectetuer nulla dolor qui tincidunt esse tempor minim sit in eos dolore dolor dolor. Te dolor eos est et liber ut gubergren eirmod tempor sit dolores diam stet sea aliquip. Ut ea no kasd sea gubergren rebum ea kasd eu molestie volutpat invidunt ipsum aliquyam ut sea ea consetetur. Ipsum sit sed ex eirmod et vel eum. Lorem congue sadipscing elitr gubergren sit odio mazim. Stet tation suscipit nonumy elitr. Zzril magna amet eos dolores sea erat consequat ea et no iusto tempor sed eos placerat diam duo. Clita magna amet sed at dolor no ut feugait sed aliquip accusam dolor est. Ut delenit rebum feugait veniam magna et et clita lorem dolor diam wisi lorem at facilisis. Vulputate elit aliquyam erat et amet minim at.

Sample Output H4

Diam est eos dolor elit ea duo elitr consetetur diam tempor accusam dolor sed ea. At eos vulputate. Et adipiscing consequat duo ipsum dolores sea eos zzril cum volutpat elit. Takimata luptatum amet aliquyam nobis possim voluptua et. Duis et et ipsum molestie. Stet tempor justo nonumy takimata praesent lorem esse et enim et facilisis gubergren amet tincidunt. Facilisi dolor delenit nonumy sed et ipsum in. Dolore hendrerit rebum invidunt stet tation amet sit esse diam. Dolore magna sed diam laoreet clita vero illum aliquyam at et. Rebum vero quis et possim. Sed eum dolores dolor tempor sit vero diam cum feugait takimata sadipscing sit sanctus.

Elitr kasd clita suscipit vel rebum dolor eirmod clita in autem molestie amet kasd dolores magna accumsan. Tation invidunt sit stet feugiat rebum et et nonummy ipsum vero invidunt dolor no lobortis ipsum dolore tempor rebum. Te rebum imperdiet aliquyam. Amet et eirmod possim. Sed voluptua molestie diam enim amet et est et ipsum quod. Ut blandit dolor at rebum dolor dolor dolor sed magna praesent. Erat kasd tation dolores invidunt labore consetetur. Duis invidunt eirmod aliquip. Sea rebum est erat diam ipsum ea sanctus elitr consetetur sed nisl feugiat.

Sample Output H3

Justo amet no amet elitr sadipscing. Ea elitr lorem eirmod blandit lorem minim diam qui elit sadipscing sea takimata et stet et sit clita. Et est blandit sed adipiscing sea ut consetetur sea at. Elitr gubergren vero dolor kasd sit. Et ut amet. Dolores mazim et gubergren et voluptua augue takimata.

Et est facer est amet erat in eu ipsum nibh iusto ea aliquyam assum labore commodo. Consetetur sit sit clita sea et nonummy lorem kasd rebum et nam. Elit dolor sit te no eirmod et sadipscing kasd ea lobortis sanctus consequat option. Clita vero diam. Qui dolores tempor sanctus et sit sanctus nihil gubergren ut velit labore ea eos. Lorem ut justo nonumy nibh aliquyam illum wisi consequat.

Sample Output H4

Amet tincidunt vero vero ut dolores tempor erat ipsum gubergren consetetur amet. Accumsan ipsum dolore vero tincidunt et magna invidunt nonumy dolore amet eos sit tation et duis labore. Ipsum lorem dolor sit sit invidunt et eu accusam dolor nonumy et. Sanctus ullamcorper sanctus enim ut diam te eirmod kasd est diam nibh sadipscing amet rebum. Gubergren lorem dolor duo diam diam tation ipsum eos volutpat lorem sed gubergren ea labore aliquyam justo. Amet nisl id sadipscing tincidunt.

Feugiat te ipsum dolor sanctus sea quis amet zzril aliquyam sadipscing tempor dolor eos et. Dolor facer sanctus. Justo diam imperdiet accusam consetetur amet placerat amet sea et dolores commodo dolor at tempor. Sit et dolores at clita nonumy rebum lorem sed. Et consequat at lobortis iriure. Erat invidunt hendrerit dignissim ea sed takimata iriure ut te consetetur diam. Enim sed mazim sit lorem molestie autem magna sanctus sea zzril consectetuer. No eleifend sed consetetur accusam invidunt et enim erat kasd nonumy facilisi eu duo delenit eos kasd. Sed vero diam sit dolor ullamcorper.

Sample Output H4

Ut consetetur autem sed sed vero eos et rebum et commodo elitr. No takimata ipsum sit aliquyam ipsum tation possim duo ut eleifend sit sanctus stet no. Duo vel vulputate tation et labore labore eu et et ipsum ut eros lorem labore in justo. Aliquam ut elitr kasd eos diam amet ut dolores gubergren dolore. Accusam iusto ea dignissim sit nostrud ea ad eirmod id cum dolores diam sit. Eos erat stet eum kasd dolore nisl sit tation gubergren sea et magna feugiat aliquyam et minim. Dolor kasd tation et sanctus no dolor et accusam aliquyam. Clita at et. Sit et sanctus tempor rebum et takimata eirmod invidunt et iriure tempor tempor dolores sit takimata kasd elitr consequat.

Enim consequat vero est tempor justo elit nonummy voluptua delenit ut at eleifend sit sea at aliquyam commodo clita. Eum nonumy ipsum. Et facilisi sea et facilisi consectetuer et sadipscing facilisi diam liber tempor magna. Diam diam diam sanctus gubergren lobortis gubergren augue suscipit accusam sadipscing adipiscing adipiscing dolore nonumy amet. Dolore molestie rebum dolore nihil eu kasd ut sanctus sadipscing voluptua vel. Feugait accusam at minim odio at dolores sanctus erat no. Consetetur dolor ipsum. Gubergren dolor sed accusam sea soluta aliquyam eirmod amet dolores ipsum sea. Et eu erat molestie clita sit.

More Sample Output H2

Dolor ea diam rebum eirmod eleifend kasd dolor duis et duis sadipscing ea tation sed sit est feugiat. Euismod nam dolor commodo vero sit duo ut ipsum sed ut ipsum sanctus aliquyam est elitr tempor diam sanctus. Dolor et invidunt eos erat. Rebum amet nonumy in no. Commodo nonumy ipsum amet no ut blandit sit ipsum minim. Dolores consetetur ullamcorper accusam iusto erat. Diam magna lorem dignissim sanctus suscipit volutpat nonumy et lorem diam sit. Eros amet eos enim sit dolor accusam lorem vel. Gubergren no est sed et erat dignissim elit gubergren. Voluptua sit et sed dolore.

Stet ipsum kasd eos. Ipsum sed et vel accusam amet diam invidunt nostrud ipsum. Eum diam eros wisi dolor commodo kasd labore eos voluptua eos delenit sed. Stet consequat et vero sea et in stet option clita magna ut dolor sea feugait dolor. Clita placerat clita lorem esse accusam labore vel magna hendrerit magna.

Sample Output H3

Dolor kasd sit dolor et nonummy facilisi kasd nobis vero. No no zzril eirmod. Et erat vero sit et justo takimata dolor stet vero sadipscing et lorem. Assum nam clita dolor vel ipsum nonumy. Eu erat duis. Kasd erat stet amet no et amet diam dolor est. No dolore luptatum et blandit velit dolores lorem feugait adipiscing lorem lobortis clita consequat clita nonumy molestie aliquyam. Lorem amet commodo takimata no nisl duo blandit sed dolor stet justo zzril consequat ea lorem. Sed dolore assum erat ea.

Dolore sanctus ea ut luptatum sit et erat magna vel sit clita at takimata takimata consectetuer. Tempor voluptua ipsum labore sadipscing diam et clita in consequat kasd luptatum laoreet est nonumy. Facilisis at tempor hendrerit duis invidunt vero ea elitr elitr. Eirmod diam consequat. Hendrerit invidunt est dolor tincidunt sea tempor eos et. Et et eos. Nostrud diam elitr kasd eros lorem consequat accusam nonumy ea sit nostrud tempor erat sit et et id dolor. Accusam wisi lorem dolore erat. Possim ipsum et duis sadipscing rebum est sanctus ipsum duo voluptua eirmod te congue sadipscing ea.

Sample Output H4

Lorem ea magna nibh et facilisis est dolor voluptua. Eirmod ipsum et diam rebum magna sed dolore illum takimata. Iusto exerci minim dolore wisi dolor. Lorem praesent facilisis odio ut et ut kasd feugait. Magna sed erat delenit et iusto justo et magna wisi ut ipsum et nonummy sit et sed duo euismod. Consetetur justo vel ut dolor. Tempor dolor stet lorem dolor praesent erat et amet sadipscing aliquyam erat ut invidunt vel dolores. Consequat sit aliquam dolor labore tempor rebum eirmod nulla vulputate lorem consequat in diam feugait. Consetetur amet aliquip ipsum diam quis laoreet exerci tempor no vulputate sed praesent dolores velit sadipscing.

Dolore sea diam aliquyam ipsum commodo duis ea sanctus elitr dolore facilisis suscipit dolor et sed takimata invidunt sit. Sadipscing invidunt aliquip sea feugait. Rebum eos diam lorem invidunt eum. Vulputate doming justo invidunt ipsum sit ipsum tempor stet invidunt ipsum consetetur sea velit sanctus. Facer kasd lobortis. Enim no amet sit et nonumy lorem ut eros in liber lorem accusam ullamcorper labore nonumy invidunt esse. Nonumy sadipscing autem option qui et rebum. Lorem sea lorem lorem consetetur consequat option at minim zzril minim. Gubergren dolor duo tation qui aliquyam sadipscing suscipit dignissim dignissim dolores labore duo et ea.

Sample Output H4

Nonummy amet magna sanctus molestie sit te lobortis no tation sed velit in tempor takimata est ut enim elitr. Labore amet est veniam vero magna clita elitr et dolore at ea iriure feugait eirmod hendrerit. Lorem sanctus sit elitr lorem no. Dolor justo sadipscing aliquip sed sed dolores et diam facilisis ut sed in invidunt consequat sanctus takimata. Sit vero sit est consetetur labore et justo eirmod eirmod sit amet.

Ut vel duis sanctus eirmod gubergren. Sed feugiat ut sit dolore nostrud vero lorem consectetuer eu ea iusto est. Dolore tempor et vero no invidunt eos feugait dolor at consetetur clita eirmod clita. Lobortis nonumy justo consequat tempor. Sit sit te stet quod ullamcorper et.

Sample Output H3

Sit vero clita enim dolor et kasd eos rebum. Sed sit wisi ea sit et accusam nostrud amet at. Nonummy consetetur blandit et invidunt sed dignissim kasd labore vero invidunt qui facilisis erat. Illum eos no. Voluptua dolor euismod lorem tincidunt nonumy sit vel no. Eos dolor ullamcorper.

Amet rebum feugiat sed ut no nonummy et erat magna sadipscing sed sadipscing clita. Lobortis magna tempor tincidunt. Accusam sanctus aliquyam voluptua sed vero diam vero justo kasd nulla. Esse diam erat takimata takimata dolore accumsan adipiscing nonummy eum. Vero dolor feugiat et autem erat tation elitr kasd invidunt vel.

Sample Output H4

Nulla dolor feugiat. Zzril justo amet sit dolor eleifend no ipsum elitr. Dolor ipsum erat. Tempor euismod tincidunt. Nostrud nonummy lorem dolore vel illum tempor diam at et amet ut labore esse et sit.

Aliquyam erat eos labore erat dolores eirmod. Gubergren diam vel sadipscing dolor dolore dolores veniam sadipscing amet nonumy et et justo diam autem at ex sea. Et feugait sed dolore kasd kasd consequat consequat no tincidunt no molestie nostrud in stet eros. Eos veniam elitr illum iusto. Justo sea ipsum possim sed. Ut gubergren justo no magna et qui amet ex magna.

Sample Output H4

Sit dolor eirmod sed dolor. Ea ad sanctus sadipscing voluptua nonumy et eos sit facilisis nulla vero clita facer eos sit ut. Diam quis eu dolor amet nibh eos amet. Nonumy dolore nonumy facilisis diam takimata consetetur at at facilisis rebum labore erat sadipscing et gubergren est. Laoreet justo sadipscing veniam amet dolores et amet takimata. Eos aliquyam nihil possim autem sea voluptua placerat nulla labore. Blandit dolor et duis. Possim feugiat clita ut takimata at sit invidunt diam elit nonumy.

Et blandit vero. Stet sit vel sed at facilisi accusam dolores. Erat nobis facilisi eos velit doming dolor facilisis diam diam eirmod molestie dolor duis labore exerci sea rebum dignissim. Feugait suscipit tempor at labore dolore. Rebum zzril nulla at in duo accusam laoreet rebum erat et amet dolore sed tincidunt. Et esse dolor vel invidunt enim ut dolores hendrerit esse sit eum stet dolor ut diam lorem magna. Gubergren ipsum ipsum dolore justo augue amet lorem consequat ut justo sadipscing quod invidunt augue sed amet. Erat sed justo rebum clita amet invidunt praesent consequat nostrud kasd sed et ullamcorper et accusam quis. Ut sed diam sanctus.