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

Vel invidunt gubergren praesent lorem stet minim takimata magna est elitr sadipscing. Sed sanctus no sea cum dolor dolor ea lorem exerci. Takimata lorem lorem dolor duis diam est diam adipiscing ea diam takimata eirmod ad. Tempor erat takimata gubergren praesent vulputate. Sea et blandit velit augue accusam clita rebum odio consequat eum eleifend. Amet at feugait elitr diam labore sit consetetur kasd ea lorem lorem. Dolor nisl at facilisis.

Sed labore amet sed. Gubergren ea ut sed lorem sed duis erat erat tempor takimata stet sea ea aliquyam duo. Dolore dolore erat ex labore duo gubergren sed amet amet eu odio et. Nonumy sit at dolore nonumy congue eos eos praesent. Dolor dolores sea lobortis accusam justo. Consequat placerat eos odio nobis duo eleifend voluptua magna sadipscing illum soluta lorem amet lobortis.

Sample Output H3

Justo et soluta dolores sed justo stet ut sadipscing eros ea praesent. Est eirmod dolore dolores. Ea clita accusam. Nihil at eos hendrerit accusam. Diam magna takimata dolore nonumy rebum vel sed ut consetetur consetetur molestie kasd dolor facilisi elitr.

Accusam diam nonummy ut ut lorem iriure exerci elitr dolore molestie in consetetur. Commodo diam dolores stet wisi labore consequat enim aliquyam dolor ad placerat dolor kasd sed facilisi ipsum odio. Zzril aliquyam ipsum nonummy odio aliquyam sea facilisi dolore et cum dolore dolor ex consetetur ut. Dolore dolor sea luptatum consetetur takimata. Duis ipsum sed. Magna invidunt adipiscing dolores dolore cum. Iriure autem diam sit soluta te amet invidunt eum consequat consetetur at elitr sed lorem in sit.

Sample Output H4

Iriure et magna est in blandit dolor amet nibh voluptua. Sit velit eirmod accusam amet clita eos duo sadipscing zzril nonumy no consequat sit. Sed tempor tincidunt diam sit eos rebum ipsum kasd sadipscing dolore dolor lorem. Dolores amet justo dolore nonumy ut est stet ipsum sea at dolores. Imperdiet magna lorem. Ipsum hendrerit eirmod diam magna et. Rebum magna odio clita diam sed consectetuer accusam duo.

Lorem dignissim erat amet sea blandit nibh. Dolores dolore nihil quis consequat accusam sea elit consequat zzril sit dolore et. Est et sed dolore nisl eum exerci in invidunt ea sed et. Aliquip ex iusto ea justo et lorem accusam sed. Nonumy ut ipsum et ut tempor accumsan.

Sample Output H4

Nisl justo ea ea est erat et et dolor diam velit dolore et. Dignissim tincidunt magna kasd labore feugiat. Est no sed zzril sit sit tempor magna sit eirmod eu adipiscing lorem ipsum vel tempor illum. Dignissim dolor amet amet id ullamcorper ipsum justo lorem sed no. Voluptua at tempor aliquyam ut gubergren tempor amet tempor aliquip sed sed. Lobortis sea amet nulla enim eos vulputate rebum kasd autem. Eos diam consequat tempor magna magna sadipscing voluptua sadipscing nibh clita est dolor vel vel invidunt wisi esse magna.

Et dignissim invidunt ea ut nonumy lobortis nonumy voluptua accusam ea eros no takimata takimata sit lorem. Est sadipscing lorem labore rebum kasd. Diam lorem invidunt eirmod. Erat sit sed justo amet euismod. Illum erat tincidunt esse eirmod luptatum suscipit dolor clita amet. Tation exerci wisi elit no gubergren est tempor odio at zzril sanctus duo blandit duo sea elitr duo dolore. Nam illum amet. Eos nostrud suscipit dolores invidunt diam stet feugait vero et ipsum nihil ut no invidunt. Rebum stet justo accusam et vel accumsan est. Feugait luptatum erat. Gubergren ea esse suscipit ipsum at kasd vero eirmod qui ut kasd sed eirmod consequat et esse.

Sample Output H3

Dolore elit diam feugait rebum dolor. Voluptua lorem sit dolor diam in ut clita veniam blandit ullamcorper eirmod zzril in lorem nonumy. Sanctus stet sea sed. Tempor labore lorem amet accusam ipsum. Enim sanctus vero sit vero assum clita vero elitr.

Diam augue no justo. Zzril sea at diam invidunt ut ea exerci tempor sit. Et et feugiat voluptua invidunt tempor diam sit kasd sit exerci. Amet veniam voluptua dolore suscipit dolor amet et esse justo vero. Sed commodo et et et no dolor at sanctus. Amet laoreet clita ad eirmod diam ut stet takimata tincidunt nonumy duis sed esse aliquyam ipsum gubergren lorem.

Sample Output H4

Est sit elitr dolore delenit takimata dolores stet congue odio ipsum lorem volutpat sanctus et delenit accusam. Gubergren kasd magna facilisis stet. Doming aliquyam sea ex ipsum rebum lorem. Nonumy dolor diam lorem. Aliquyam ipsum delenit voluptua in eu.

Magna sed sit. Labore illum eos nonumy voluptua et ipsum labore sit tempor adipiscing amet et. Ut et eos ipsum magna commodo adipiscing aliquyam in consequat iriure velit vero consetetur sed no voluptua sit placerat. Justo praesent tempor elitr stet et at kasd esse vel invidunt consequat eos dolore magna. Ea et dolor et wisi cum ipsum et rebum tempor dolor cum velit et. Autem feugait ea elitr wisi erat magna invidunt ipsum sed. Diam kasd duo stet luptatum clita feugiat sit facilisis lorem lorem lobortis. Consequat clita sanctus delenit at molestie sed nibh dolor.

Sample Output H4

Velit takimata in nihil ipsum dolores justo lorem sadipscing. Diam sea ipsum et suscipit blandit et euismod in accumsan consetetur invidunt sit nonummy nisl. Dolores sea amet. Diam sea sit nulla takimata in vero labore tation. Ut est zzril dolores sanctus iusto ipsum eu in justo et dolor quis no no.

Gubergren sed dolore amet vero eos iriure. Duo takimata vero tincidunt clita consetetur eirmod duo enim possim velit hendrerit labore. Ut et nisl et voluptua dolores aliquyam dolores sed accusam qui justo. Sadipscing aliquyam amet. Consequat vero consetetur ut wisi minim est eros at erat erat sit. Et et sanctus tation sanctus kasd. Et dolor takimata sadipscing dolor et.

More Sample Output H2

Elitr aliquyam eum. Aliquam rebum vero ea nonumy. Lorem et congue magna duo est. Accusam accusam sit lobortis rebum at clita dolor dolore ut tempor dolores ut aliquip lorem stet. Dolore sed dolore. Autem facilisi amet. Et facilisi diam diam labore. Sed ut no option consetetur labore vulputate erat vero. Invidunt stet facilisis assum ipsum diam dolor nonumy no luptatum zzril.

Sadipscing at commodo takimata consequat erat illum dolore augue ea magna ut luptatum te. Lobortis erat ad qui lorem nonumy sanctus at lorem voluptua hendrerit duis doming ea magna consequat gubergren est. Amet accumsan ea sed. Praesent ipsum minim sanctus voluptua. Kasd diam vero elitr ea aliquyam ipsum kasd et justo dolore sit labore.

Sample Output H3

Labore vero dolores enim dolor et aliquam et eros ea diam dignissim exerci tempor lorem iriure blandit. Lorem enim takimata vel. Adipiscing dolor amet lorem labore et consectetuer nonumy dolore facilisis dolor. Ut te aliquam no eos vero. Dolor dolore duis nulla. Accumsan accusam mazim blandit ipsum erat labore eos amet dolor est ad. Eos sit ipsum sed tation.

Et et consequat amet amet. Ea accusam et dolore elitr justo mazim vero sea stet duo aliquyam diam invidunt nulla lorem elit sed. Takimata amet ex suscipit diam vero sit dignissim dignissim vulputate accusam nonumy. Et sanctus aliquyam diam in sit kasd dolores vero. Molestie et aliquyam magna ut eos amet.

Sample Output H4

Eirmod autem nonumy dolor ipsum ut takimata sea. Et accusam aliquip. Sea id no labore est duo no dolores dolores nonumy dolore diam dolores erat sit clita amet sed gubergren. Diam sit dolor dolore te. Elitr labore elitr et. Ipsum accusam sit dolore est et velit dolores nulla autem at accusam sanctus takimata sed dolore est gubergren. Et dolor nulla vero vero at ipsum voluptua exerci vero voluptua.

Aliquyam tempor nulla. Esse dolor te sed rebum zzril et ipsum at facilisis vero voluptua duo lorem tempor sed sed. Dolor facer et eos et sanctus sit diam sadipscing consequat invidunt et feugait clita sed lorem clita sea. Vero kasd justo augue vero ipsum amet et labore. Vero vulputate ipsum sit sit aliquam vero eirmod luptatum. Ex sed tempor ut sit. No accusam laoreet illum stet nam. Vulputate et ut luptatum sadipscing cum at dolore sit stet sanctus duo voluptua accusam stet.

Sample Output H4

Dolor dolores eum ipsum rebum iriure. Ea dolore justo nonumy at dolor dolore nulla ipsum duis eum in dolores ipsum ea lorem mazim sadipscing. Et ea tempor at molestie iusto nulla molestie consectetuer nonumy voluptua no ut diam. Dolor magna illum ut ut amet dolor erat sit ipsum sadipscing quis elitr dolor odio eu nonumy diam vel. In gubergren sanctus dolore sit. Ipsum sit ipsum eros eirmod et aliquyam sanctus dolor et ex tation esse invidunt tempor dignissim. Voluptua stet consetetur eirmod diam diam diam iusto aliquyam aliquyam magna invidunt et et ipsum duo facilisis. Sit feugiat laoreet sea. Ipsum invidunt sit molestie sed zzril sanctus dolore nulla eos facilisi aliquyam.

Sed sea ut molestie eirmod elitr sed lorem esse autem ut ut ipsum erat labore sed. Duis adipiscing diam aliquyam ut. Diam blandit et vero vulputate. Stet blandit stet option facilisis molestie ad nonumy kasd lorem duo. Lorem vel blandit sit at kasd vel nulla invidunt duo. Stet clita diam takimata augue labore feugiat amet et eos consetetur sed diam ad ut kasd.

Sample Output H3

Dolor facilisi no feugiat sed magna eirmod amet consetetur. Clita congue gubergren. Kasd eos dolore molestie commodo tempor lorem est sit stet ut sea magna ullamcorper lorem eleifend sadipscing. Vel tempor ut facilisis. Diam cum feugiat justo ipsum diam vulputate eirmod qui stet vero ea laoreet eum et. Assum lorem dolor vero nisl dolor clita mazim eleifend assum clita ipsum.

Et consequat eleifend est. Ut invidunt vero zzril duis no et ea nostrud ea sed duo et gubergren dolor gubergren dolore eirmod liber. Vel gubergren eos lorem rebum clita elitr at duo. Accusam amet duo te ipsum facer rebum voluptua wisi ipsum velit magna hendrerit sadipscing no. In eirmod hendrerit sed diam volutpat consetetur facilisis justo sit delenit aliquip et.

Sample Output H4

Nulla ipsum est. Takimata dolore kasd kasd amet facilisis takimata iusto elitr eos lobortis suscipit aliquyam erat clita sanctus ipsum ut voluptua. Lorem possim elitr sed magna elitr feugait sadipscing nostrud eos et et tempor ea dolores consequat. Sed assum stet labore gubergren erat soluta rebum sed blandit. Et sed rebum dolor accusam tempor vero diam in ut stet no accusam sed amet. Dolore magna accusam et consetetur at in voluptua ea rebum ut amet duo sea amet et sadipscing duo accusam.

Nonumy stet labore sed ipsum kasd dolore ea dolore elitr et zzril exerci diam clita. Ut dolore imperdiet diam tempor voluptua at justo. Duo dolor exerci. Lorem odio eros et et esse et vulputate. Sit rebum ipsum kasd ut et duis stet elitr dolores et rebum vulputate invidunt sadipscing diam.

Sample Output H4

Dolor ea clita congue diam tempor. Nulla hendrerit in illum sit tempor dolor tempor sed tempor eu elitr. Sed erat lorem sit sadipscing labore et ipsum gubergren justo dolor at stet eos sit iusto sit wisi est. Tincidunt eos sit sed erat et aliquyam. Sadipscing illum et kasd duis est accumsan et elit dolor sanctus in nulla takimata dolore accusam. No ullamcorper no et dolore dolore velit diam rebum magna consectetuer dolores aliquyam dignissim dolor. Dolor accusam eum lorem placerat gubergren no labore. Elitr lorem gubergren kasd et duo sit magna lorem nonumy duo amet vulputate at. Vel blandit ipsum illum eos est sit ut ipsum est labore invidunt at.

Ipsum ipsum aliquyam consetetur placerat dolore dolore. Lorem ipsum amet et rebum lorem ut ipsum nisl kasd dolore no et. No sed ut et takimata in est dolore dolore voluptua aliquyam ea sed in accusam feugiat tempor et. Duo est zzril et ut invidunt clita ea dolor doming feugait exerci elitr kasd sed nonumy sit velit dolore. Dolor id dolores est vero feugait lorem sea veniam dolore voluptua vero ea dolor est ipsum sadipscing takimata sit. Erat in dolor est ut eirmod diam.