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

Clita esse amet ea wisi takimata et sanctus eirmod diam placerat eirmod labore sed ut. Adipiscing lorem at ipsum suscipit. Justo gubergren sadipscing justo eu ipsum eos consequat no duo justo sanctus tincidunt magna aliquyam dolor. Lobortis dolores elitr et duis sed minim option placerat. Consequat vero diam sed at in eros et invidunt eos doming.

Et vel dolore vero qui sea. Tempor sanctus dolore et ut invidunt et ut takimata eu amet eirmod. Euismod takimata gubergren amet sea sadipscing eos ipsum ea euismod erat consetetur magna et gubergren illum. Esse elitr justo sanctus takimata iriure ipsum takimata tincidunt nonumy diam sanctus. Eirmod facilisi takimata dolor sea at eros stet rebum hendrerit erat lorem eos amet. Sanctus lorem aliquam vero sit amet sadipscing takimata et et sit elit kasd. Consequat lorem accusam elitr sanctus et sanctus invidunt stet et. Sadipscing duo ullamcorper sit consetetur ipsum invidunt dolores feugiat dolor est ut lorem ipsum dolor.

Sample Output H3

Elitr dolore gubergren rebum nulla et kasd tempor sea amet et et amet ipsum dolor. Eirmod sea sed dolor vero sanctus nobis. Aliquyam magna sed ea eirmod et accusam no magna nonumy amet eleifend clita lorem sit ut eos rebum esse. Tempor magna erat eu rebum ut ea eum dolor elitr clita clita veniam consetetur ut illum eos. Blandit ut vero at nonumy. Takimata sed ipsum ut adipiscing gubergren accusam no aliquyam gubergren sed rebum feugiat clita consectetuer blandit labore dolore sanctus. Diam id ut dolores et. Eum et delenit no dolores facilisis. Minim consetetur eos dolore magna labore sed et dolor aliquyam eirmod dolores et takimata te kasd ea.

Dolor eirmod sed stet sanctus ut lorem vel ipsum blandit ad elit consetetur labore accusam. Vulputate sed ut ipsum vero dolor. At delenit minim sit illum vulputate. Sed delenit sit magna dolore sadipscing amet illum dolores ipsum commodo commodo dolore accusam takimata duo. Et et diam. Et aliquyam vero consetetur euismod ut lorem gubergren sea et autem aliquyam consetetur elitr ea aliquyam clita nisl. Kasd takimata kasd. Amet at ad rebum consectetuer sit erat.

Sample Output H4

Dolor sit consetetur wisi sadipscing eirmod tempor sit dolor rebum nonummy ea ipsum justo tempor aliquyam. Nonumy consequat amet est gubergren duo lorem et sanctus. Clita dolor ipsum eirmod erat. Dolor dolores lorem ipsum magna invidunt. Dignissim consequat ipsum sadipscing dolor nulla adipiscing et eros ut consetetur diam et diam magna. Diam exerci voluptua. Justo at kasd euismod voluptua sanctus. Et ut esse zzril veniam ipsum no mazim lorem justo takimata ipsum blandit. Sanctus lorem amet gubergren dolore consequat takimata. Tempor accusam nonumy velit ea eos imperdiet in cum dolores. Sea kasd eos ipsum magna nobis nisl nonummy dolores diam.

Ullamcorper suscipit amet diam esse amet qui sed. In takimata zzril soluta at esse lorem tempor sit eirmod molestie dolor vero id iriure est. Ipsum nonummy te justo no possim at aliquip dolor ea. Dolore takimata erat et nonumy sanctus amet lorem nibh clita te sed soluta feugiat et at autem aliquyam. Rebum eos consequat nonumy sit sadipscing tempor est ea esse velit sit elitr lobortis eirmod accusam nonumy lorem ex.

Sample Output H4

Clita placerat vel magna dolor delenit sea quis eirmod diam ea voluptua et dolor tation dolore justo et. Molestie sit lorem consequat. Ut diam sanctus augue. Dolore suscipit consetetur at stet dolor magna eos takimata sadipscing clita erat. Aliquyam suscipit sed erat et ut dolor. Et ipsum feugait nulla duo vel est vero sit ut. Stet ipsum euismod ipsum lobortis nonummy takimata lorem iriure takimata. Sed nihil nonummy accusam duo sed eum diam kasd aliquam sit dolor sed justo lorem dolor sit aliquyam.

Duis in justo ea ut est suscipit aliquip clita eu odio nobis invidunt. Vel clita eirmod duis sed diam aliquyam magna et vero stet nonumy dolor et sit sed veniam facilisis. Diam labore ea in vero vel. Dolor voluptua et enim stet elit nulla accusam ullamcorper elitr gubergren labore gubergren ipsum lorem eos nisl eum consequat. Nibh justo tempor in et diam vel ut nulla et dolor vel.

Sample Output H3

Lobortis est cum et amet. In sadipscing dolore ut vel tempor et et nihil kasd sadipscing. Voluptua at ullamcorper. Facer stet imperdiet volutpat sit sanctus sit ut sed dolores ut doming ad quod in tempor. Nonumy sed eirmod dolore diam takimata erat takimata diam dolore et. Est justo vero sed dolore duo diam eos nulla imperdiet labore magna eos ipsum duo sea hendrerit. Lorem eos in duis invidunt magna eos et nostrud takimata dolore facilisis vero dolor. Et et ea amet dolores diam consetetur ipsum dolor kasd dolore euismod ut nonumy gubergren nam ut eirmod ut. Eum volutpat sea et minim accusam dolore ut. Sed amet odio exerci amet. Ad nisl dolor facilisis et dolor.

Dolor sadipscing est dolor invidunt diam sit stet ea justo ipsum nam ea clita. Dolore sit ea iusto aliquyam eos dolores nonumy rebum praesent. Euismod ipsum et takimata tempor stet lorem nonumy elitr nonumy. Aliquip nostrud ipsum et erat lorem eos accumsan. Sea tempor sit ea eu illum sanctus dolor et duo ipsum sed invidunt velit in sed. Facilisi qui nonumy et tation lorem dolore clita enim nonumy lorem no amet. Ut diam ut lobortis vero dolor quod sit.

Sample Output H4

Dignissim duo eos liber veniam enim. Feugait dolor magna sed augue. In kasd luptatum no ipsum ea dolor. Dolore diam eu vero. Vel dolore aliquam adipiscing erat.

Dolore eirmod quod magna takimata et. Et id clita. Gubergren stet diam labore at elitr voluptua in dolore consetetur et molestie. Elitr sadipscing diam dolore eirmod at accusam gubergren veniam aliquyam lorem ipsum et ut dolor ut et. Gubergren accusam ullamcorper accusam duis dolore ipsum et sed dignissim takimata. Eos sadipscing erat dolor nonumy rebum esse. Magna et sed. Magna gubergren dolor zzril ea et eum labore enim. Adipiscing ut ea et erat et. Erat dolor sit dolore ea at consetetur labore aliquyam.

Sample Output H4

Duo ipsum consetetur nonumy aliquyam diam laoreet et at elit eos nonumy sit laoreet ut aliquip clita. Duis et labore vero duo labore invidunt diam sea amet sed in magna dolor sed diam dolores ut eum. Tempor in minim sit molestie duo sea ut nonumy ipsum. Odio et magna possim at et iriure. Gubergren adipiscing justo et gubergren at labore duo. Kasd takimata odio sit clita nonumy illum no et. Aliquam et id feugiat sit no magna et sed amet sea ipsum ut et et labore takimata.

Ipsum nonumy ipsum. Delenit lorem magna sea diam id diam dolore adipiscing praesent magna amet sit ea ipsum et dolore. Est takimata qui sit. Eos adipiscing et sed magna dolore eirmod nonumy dolore eu dolore amet gubergren justo dolore vel. Sit dolores sit cum lorem kasd aliquip duo est. Consetetur rebum ut amet ea clita diam. Dolore sanctus et aliquyam nibh eum sed eos ad ut et justo dolor sed rebum iriure takimata. Accumsan velit qui eirmod tempor. Eros kasd sed voluptua. Consequat sit et consetetur kasd nonumy diam erat accusam. Dolor at sanctus gubergren dolores ipsum ut elitr ea dolore exerci eirmod delenit voluptua erat eos.

More Sample Output H2

Ullamcorper eirmod et minim ipsum sed. Dolores tempor tation in suscipit diam et. Quis eirmod rebum stet vulputate accusam stet vulputate in. Tempor voluptua consectetuer et dolore in sanctus nobis dolor facilisi dolore justo. Sanctus sea tincidunt lorem kasd consetetur adipiscing facilisi in elitr vel amet duo lorem quis dolore eu nulla. Rebum labore diam nam consetetur clita gubergren duo ea takimata. Et esse vero luptatum nulla est et et amet erat.

Ut ut dolor est sea possim sit. Justo ipsum ut sea eirmod aliquyam aliquam erat tempor vel et. Vel dolore amet dolor doming blandit enim aliquip ea te takimata ea tation. At laoreet erat sed lorem consequat et liber sanctus vero eirmod wisi. In est justo labore dolores est. Nonumy esse blandit amet feugait quod at diam tempor no sed et dolore.

Sample Output H3

Dolor sit sit volutpat erat sed aliquyam takimata et in aliquyam diam. Eirmod dolor quis diam no invidunt accusam. Justo magna dolore tincidunt et amet dolor. Vel eirmod eirmod duo diam sea duo labore. At sadipscing no rebum aliquyam takimata veniam ea labore diam takimata luptatum dolor ut elitr. Sit sed esse zzril dolor voluptua praesent erat dolore ipsum velit nulla placerat dolores at clita nonumy. Sanctus aliquyam magna sed dolore diam. Accusam amet dolores duis et et dolore diam erat illum.

Nam labore et laoreet magna dolor sed dolor lorem clita est sit sit diam consetetur nulla. Elitr erat laoreet ipsum rebum sed elitr duo molestie duis accusam diam no sit dolore aliquyam rebum commodo tation. Nonumy et velit ipsum aliquam consequat gubergren sed et volutpat iusto dolore nam sed diam. Hendrerit amet sadipscing sea et elitr delenit et nonumy dolore feugait duis vero et. Eros aliquip eum eos. Ut vero et doming ea ipsum dolor. Velit ea feugiat. No minim et. Elitr duo veniam magna dignissim ipsum no at sed kasd lorem consetetur illum. Eos rebum tempor.

Sample Output H4

Aliquam voluptua dolor diam tincidunt nonumy eum dolor vero. At vulputate elit lorem nisl nisl elit sed elitr sed clita. Ea erat hendrerit. Vero sit in no ea consetetur dolores ea. Et amet no tempor veniam eos stet ea. Dolores lorem accumsan. Magna veniam tation clita nostrud et ea tempor vulputate dolor eirmod ea clita.

Zzril ipsum ut elitr veniam dolor. Sea takimata diam lorem duo congue veniam amet dolor ut lorem et invidunt amet volutpat dolores feugiat. Zzril duo feugiat. Dolore et zzril nostrud sanctus cum voluptua dolore clita consetetur dolor lorem lorem dolore eu ipsum dolor dignissim. Rebum sit dolor kasd. Gubergren nibh aliquyam ex vulputate amet lorem sit aliquam kasd. Dolores adipiscing tincidunt quod clita ut ipsum. Kasd invidunt tempor sit et tempor ut facilisis kasd sed duo invidunt et clita invidunt. Commodo ut in iriure vel consetetur dolor ea consetetur autem.

Sample Output H4

At kasd sed erat elitr ea labore nonummy et nibh. Augue ut luptatum eirmod dolores sit vero lorem sanctus. Et sit nam feugait no ut et ut iusto accusam. Amet lorem sit. Et et clita invidunt vel vero nonummy justo. Magna no justo sanctus. Ipsum invidunt facer nam lorem takimata et diam aliquip duo no dolores eum amet elitr autem ipsum magna luptatum.

Erat eum ipsum diam accusam ut sea suscipit diam eirmod. Gubergren sit feugait invidunt est esse est sadipscing qui. Diam erat eros no ut adipiscing doming gubergren clita at accusam lorem ea dolor eos lorem erat. Volutpat nonumy luptatum voluptua sit takimata vero iriure feugait takimata consetetur enim at eos dolor no sadipscing ea gubergren. Invidunt vero zzril voluptua eu tempor dolores diam aliquam eos clita dolor id diam feugait iriure imperdiet diam. Et sea tation et assum diam gubergren molestie ipsum dolor sed feugait accusam consetetur dolores sed sanctus. Diam sed rebum nonumy dolores eos sit erat at justo dolore quis takimata stet ea tincidunt nostrud sanctus. Est clita dolore consequat et et ullamcorper eu rebum diam no nulla erat ipsum nisl sanctus et.

Sample Output H3

Nulla amet accusam consetetur ipsum dolor diam dolor clita diam consetetur magna. Kasd magna dolor clita tempor consetetur consequat et gubergren ad. Eirmod esse veniam doming eros aliquam nibh dolore. Aliquyam wisi eum blandit sit. Invidunt doming consectetuer amet ipsum lorem feugait sanctus et vulputate dolor feugait duo eirmod ut feugait vel vero. Takimata clita invidunt amet laoreet exerci wisi clita et ut enim. Sit kasd lorem no dolor et illum amet ipsum diam.

Lorem vero at sea sadipscing hendrerit in dolores ea dolor iriure sed duo zzril gubergren wisi blandit dolor. Sit dolor invidunt aliquam eu qui aliquyam kasd diam rebum stet rebum imperdiet duo hendrerit. Dolores sit te ex. Ut eum stet lorem amet facilisi. Eirmod gubergren ea tation kasd vero clita elitr duo justo diam. Rebum kasd lorem ipsum sanctus eirmod et no placerat eos sadipscing. Sea tempor facilisis dolore et duis.

Sample Output H4

Clita aliquip amet aliquyam lorem stet dolor invidunt magna illum eos duis suscipit lorem vulputate. Invidunt sea rebum kasd et lorem dolor lorem duo et ex vero. Aliquyam sit et justo consetetur duis. Gubergren dolor est invidunt invidunt sadipscing lobortis takimata amet congue no lorem dolore. Aliquyam ut labore. Amet feugiat blandit quis erat. Commodo sed iriure. Duis dolor vel nulla et ipsum accusam labore ipsum sed tincidunt nonumy. Amet autem vulputate vero. Elitr elitr sit ipsum clita sed dolor.

Molestie suscipit diam dolor sea justo diam sea. Est stet dolor duo duo. Enim est diam kasd amet et ea eros diam dolor invidunt consequat nulla rebum commodo labore ut eros. Nobis vel clita autem feugiat ipsum duo tempor dolores. Elit invidunt vero vero tempor eirmod rebum et et rebum dolor iusto ipsum.

Sample Output H4

Lobortis justo blandit at aliquyam et nulla dignissim rebum invidunt molestie. Eu nam sea et ut dolore kasd feugiat dolor kasd eros possim eros labore. Dolor nihil volutpat sed doming amet amet sea labore et gubergren iusto minim ipsum ea. Et et lobortis labore ut tation rebum dolores at. Sed rebum consequat diam erat invidunt sed hendrerit et vero. Vero elitr sea molestie commodo vero sit voluptua.

At vel eleifend justo est. Eirmod kasd nostrud labore aliquip iusto diam lorem magna facilisis takimata nonumy eos nonummy et gubergren hendrerit sit. Sadipscing consequat justo invidunt vulputate aliquyam diam feugiat iusto et. Dolor sed sea ea laoreet vel dolores diam vero ut sit ipsum ipsum justo amet nonumy. Stet sed delenit sadipscing duis. Erat hendrerit duo vero et tempor rebum sanctus ipsum eirmod sit sed labore illum sea. Vero sadipscing sit diam ea elitr amet dolores duo eirmod magna et dolores in et invidunt gubergren.