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

Rebum voluptua dolore accusam erat dolor ea voluptua sanctus eum hendrerit diam labore dolor vel exerci at aliquyam. Wisi sit dolor euismod gubergren. Velit aliquyam voluptua magna. Amet enim dolor. Iriure erat eos ea sea nonumy voluptua et at kasd accusam vel. Et nisl sit magna esse at. Sit facilisis nulla et. Sea diam eirmod nulla elitr autem vero dolor wisi amet ipsum.

Et molestie sadipscing et tempor augue diam eirmod voluptua gubergren placerat eu praesent takimata. Dolore elitr et duis aliquip elitr ipsum ipsum gubergren lorem. Erat sit amet eirmod at sit imperdiet lorem ex nostrud dolore euismod diam sit et diam feugiat aliquyam et. Sea mazim est diam vero erat et iusto nonumy amet velit at dolores amet kasd. Et veniam dolores diam dolore duo accusam. Placerat sit augue commodo justo sit diam justo sit duo nulla velit ullamcorper eum sea nonumy erat diam diam. Vero zzril accumsan sadipscing justo et diam et quis tempor invidunt facer accusam. Vel nonumy dolores vero et consectetuer gubergren dolores at ipsum ipsum nonummy et. Ex sanctus kasd sadipscing ut labore sanctus elitr at ut facilisis dolor. Invidunt eos mazim amet ipsum ex et.

Sample Output H3

Erat sanctus vulputate. Sed accumsan accumsan eros tincidunt. Dolor laoreet esse lobortis et consetetur kasd tempor et lorem ea eu stet at. Vero consetetur eleifend. Et vero invidunt vulputate adipiscing diam sanctus et ea.

Invidunt amet magna ipsum facilisis vero wisi zzril gubergren takimata et luptatum ipsum. Lorem illum tation stet lorem lobortis elit vero consetetur sed velit ea invidunt sit sit diam dignissim sit. Et amet ea ipsum kasd iriure rebum diam clita sed quis minim et. Elitr amet consetetur ad. Te accusam duo erat sanctus nonumy dolores eirmod nonumy et justo. Et et invidunt diam voluptua diam lorem option esse sed magna duo. Commodo vel gubergren nonummy.

Sample Output H4

Ipsum vel consetetur sed. Dolor exerci sea no tempor dolor tation accusam eum laoreet sed eum takimata gubergren et est. Stet voluptua magna diam adipiscing et justo kasd. Est autem voluptua et dolor elitr dolor gubergren voluptua. Eu sit vero nonumy ipsum. Feugait elitr veniam. Ipsum luptatum iriure sit aliquyam erat duo velit clita ut erat duo dolor ut placerat et rebum.

Ipsum delenit ipsum ut ipsum voluptua duis laoreet. Et ea sed est. Eos possim eos lorem at ut. Vero est et nostrud dolore stet ipsum odio zzril et facilisis. Dolor minim eos sanctus consectetuer commodo quis ipsum elitr no commodo lorem consetetur vero. Vero magna duo amet aliquyam sed eos at feugait sea id iriure sadipscing wisi est accusam eos est tation. Ea dolore amet ullamcorper et aliquyam duo tation euismod et. Ea eleifend takimata vero dolor dolore dolore invidunt sea stet in facilisis ad. Sanctus est accusam.

Sample Output H4

Dolor lorem illum. Odio sed zzril feugait aliquyam sea eos adipiscing rebum sanctus. Eu elitr ut. Eu no sed dolore praesent at magna est dolores volutpat ea at ipsum eirmod dignissim. Eirmod ea amet invidunt dolore at laoreet sit ea. Dolore at elitr.

Stet justo stet nonumy ea dolor duo dolores aliquyam diam tempor. Eos illum labore quod hendrerit in facilisis. Ea dolor ea voluptua et tempor diam adipiscing eu diam. Nulla sanctus sadipscing dolor sanctus vel duis est. Et ipsum dolore et sit. Ex dolore illum gubergren vero ex quis amet stet et lorem molestie amet nonumy augue dolor ea. Labore vero mazim erat et erat sea no ipsum eirmod magna amet eos justo aliquyam imperdiet est molestie tempor.

Sample Output H3

Sed dolores clita delenit dolor dolores stet dolores id sed duo erat nulla stet ipsum molestie. Justo ea aliquip lorem duis vulputate rebum nostrud dolores. Sanctus lorem diam voluptua. Sed labore elitr ullamcorper adipiscing et magna ad amet quis consetetur gubergren clita odio consectetuer takimata voluptua no nisl. Blandit nonumy lorem ad diam dolor. Labore lorem sea ad lorem dolor ipsum sit clita et et sanctus est magna diam sanctus eirmod nisl aliquyam. Sanctus dolores erat minim consetetur odio no ea diam erat consequat et sit magna dolor rebum eirmod sit. In gubergren ut nonumy erat. Lorem ipsum erat.

Et kasd magna sit erat duo clita gubergren qui eu elitr odio kasd. Vulputate tempor possim et vero voluptua. Elitr facilisis est et clita sea at aliquam sed suscipit aliquyam ut iusto. Vulputate lorem esse. Erat sed duis sit takimata consequat nonumy te takimata dolore sanctus eirmod takimata magna lorem et vero amet voluptua. Sadipscing in consetetur erat diam vero stet vel nonumy. Lorem eirmod sit justo option. Nisl rebum est dolor invidunt feugait accusam consetetur praesent hendrerit et diam eleifend magna velit eirmod.

Sample Output H4

No labore et. Dolores duo sit diam suscipit tempor sed sit magna nisl accusam et amet in amet eos eirmod dolor tempor. Lorem dolor no ipsum justo sit magna dolores consequat ipsum magna sea. Feugiat nihil accusam sit dolor lorem labore wisi sit erat dolore facilisi erat sanctus sit. Lorem at diam. Consectetuer et et elitr ea ut accusam. Clita illum nulla eos euismod takimata stet magna at et in rebum dignissim ipsum molestie sed dolore amet. Voluptua ut vero commodo consetetur diam. Luptatum exerci illum erat zzril stet et sed qui luptatum. No erat accusam ea.

Sed eirmod vero. At et nulla enim vero consetetur elit accusam aliquam et labore amet ut sed tempor dolore erat. Tincidunt dolore facilisi ut et hendrerit amet ea accusam takimata ipsum. Eirmod eos duis clita et feugiat esse eirmod sed vulputate dolores sanctus magna dolore justo no iriure. Stet dolore et sanctus eu nonummy sea consetetur clita eirmod sed exerci eos elitr molestie ut. Gubergren erat lorem justo ut consetetur amet aliquyam diam eu sit lorem justo volutpat elitr accusam sed.

Sample Output H4

Dolores aliquip at et lorem duis kasd aliquam suscipit dolor enim euismod diam amet iusto. Eos nonumy diam volutpat tempor. Elitr nonumy lorem lobortis sed eos. Ut diam dolore commodo amet lorem nostrud et et amet. Amet vel sea clita te takimata illum velit adipiscing diam ex dolore ea. Labore vulputate no tation blandit ea in. Et magna consequat sed diam tempor molestie no ullamcorper diam accusam dignissim sed. Tempor delenit diam sed voluptua consequat vero vulputate amet accusam. Iusto et nulla diam feugait ipsum.

Ipsum nonummy eirmod sed. Magna eum est vulputate ipsum sit iriure sed aliquip lobortis eirmod dolor sed eros est lorem ut diam et. Aliquyam aliquyam accusam takimata vulputate ea amet et justo vero labore commodo consequat ut kasd. Illum dolores iusto ipsum gubergren exerci nonumy. Diam tincidunt nulla gubergren dolores dolor dolores sit blandit adipiscing dolore et. Ipsum ut tempor duo nulla exerci consetetur accumsan velit. Illum ea eos elitr. Iusto et dolor diam amet stet. Stet invidunt accumsan lorem et in.

More Sample Output H2

Invidunt labore invidunt erat eirmod eirmod invidunt. Nonummy lorem clita ipsum molestie duo. Iriure vero magna ea facilisis adipiscing dolor eros tation no ea accusam dolor nulla magna. Esse eos sadipscing nonumy dolor augue. No in tempor vero takimata diam eirmod te sit amet sit rebum et ut. Tempor dolore eirmod suscipit quod et dolores sed labore et rebum et.

Dolor erat eirmod. Dolor delenit doming nibh sea laoreet lorem iusto praesent rebum diam sit rebum no praesent erat invidunt iriure vel. Et vero elitr gubergren invidunt ipsum voluptua sea ea nulla gubergren ea. Dolore dolor in erat dolore sed adipiscing. Accusam accusam ipsum sit duo sea sanctus ut at consetetur dolore stet et clita. Eos invidunt ipsum est eirmod stet eos tempor lorem kasd accusam eirmod sanctus dolor dolor at ipsum lorem duo. Ipsum eirmod takimata magna consetetur accusam tation nonumy ipsum amet invidunt dolor accusam tation et euismod vulputate ut. Elitr ipsum labore amet nonumy stet feugait lorem ipsum mazim molestie takimata takimata sed clita at. Gubergren et kasd clita magna labore justo lorem voluptua vero sanctus stet magna accumsan adipiscing justo. Voluptua sit molestie et invidunt.

Sample Output H3

Accusam sed magna lorem consetetur doming et sea vel ea dolore tempor et clita velit. Rebum eum rebum tation ea lobortis eos labore dolor tempor dolor iusto kasd sanctus stet vero nulla. Nostrud aliquyam sit magna. Commodo elitr accusam sed ea. Magna consetetur liber. Esse aliquam laoreet et sit lorem et justo illum sit sanctus sadipscing veniam dolor. Dolor no vero amet gubergren quis vel stet ut elit kasd amet ut et consetetur et.

Invidunt vero illum et dolor. Accusam mazim dolor diam ut lorem est delenit vero dolore. Magna sanctus consetetur gubergren consetetur sanctus sadipscing est vero duo vero takimata. Molestie at stet et voluptua vero eu. Takimata clita erat invidunt. Eirmod diam magna clita nobis eirmod sadipscing. Augue consequat amet tempor placerat consetetur nostrud sit sed vero kasd et dolor molestie lorem sed voluptua. Eirmod est sit vero vero ipsum quod stet vero. Vero amet invidunt in dolore luptatum nonumy mazim stet sadipscing soluta erat justo nihil. Consectetuer invidunt duo nulla vel te sed diam sed eirmod eirmod iriure vero eirmod magna minim eu et takimata.

Sample Output H4

Quis accusam dolor. Augue sanctus sanctus dolores accusam nisl ut invidunt consetetur diam clita et. Takimata in dolore nibh vero commodo tempor et molestie ex kasd nulla vero. Stet accusam dolor voluptua ea. Amet eirmod justo nihil magna. Lorem dolor suscipit magna. Exerci tempor clita consectetuer ipsum. At tempor aliquyam no consequat ipsum tempor amet tempor dolor.

Et dolor sit zzril accumsan et aliquam eos lorem takimata amet eos. Et tempor takimata ipsum sadipscing clita amet et autem. Et diam sea clita ullamcorper ad vel molestie kasd. Gubergren nulla amet clita sadipscing stet sed. At diam justo invidunt sea et ipsum kasd rebum ipsum sadipscing ut eirmod eos hendrerit euismod sed hendrerit commodo. No et takimata facer accusam iusto at odio ipsum eum no minim accusam eos sea est accusam. Et tempor feugait autem diam option sed at amet consetetur eirmod mazim et et sed magna lorem amet dolores.

Sample Output H4

Ipsum stet option sea blandit eirmod imperdiet rebum sit ea. Est sadipscing et nulla molestie aliquyam tempor elitr duo magna diam dolor duo at autem ullamcorper invidunt. Amet sea eirmod tempor in adipiscing vero amet sanctus blandit clita nibh gubergren consetetur amet accusam eirmod justo. Rebum ea takimata clita elitr duis labore sadipscing dolores dolore ipsum et consequat gubergren vero sanctus at sit. Eos volutpat facilisi accusam vero lorem rebum velit accusam dolores dolor ipsum diam no ipsum sanctus in tempor nulla.

Est dolor sed stet nibh autem clita. Clita lorem eirmod vero kasd amet sit takimata voluptua ut elitr clita eos stet gubergren. Dolores sea nulla magna est. Aliquip dolore eirmod dolor ea erat esse diam ipsum suscipit ipsum et vel ipsum rebum. Aliquyam sea ipsum lorem volutpat blandit sit nisl vulputate et dolore voluptua amet wisi ipsum. Rebum et et sed tation dolor consequat eirmod vulputate dolore.

Sample Output H3

Gubergren iusto at clita sit nostrud eum eos consetetur diam eu sit. Erat facilisi quod dolor gubergren magna lorem ipsum accusam et zzril ea invidunt eum dolore takimata rebum in amet. Magna consetetur ipsum dolore et et sit et aliquyam sanctus sea labore magna et dolor takimata takimata. Elit et aliquyam lorem eirmod amet sed magna rebum dolores ipsum lorem stet magna magna dolor eros ut. Clita sea nisl aliquyam sadipscing eos et dolor clita labore dolores ea. Adipiscing et stet ipsum consetetur sed diam consequat tempor nonumy voluptua dolores takimata option elitr consetetur accusam erat. Clita lorem nostrud rebum sed at stet zzril eos soluta molestie et dolor. Sed delenit lorem justo nobis sea amet rebum enim at eirmod ut facilisis justo eos vero.

Accusam exerci molestie ipsum eos sea invidunt sea feugiat consequat et justo ipsum in erat amet commodo sit. At esse est consetetur eu accusam vulputate dolore justo duis exerci sed illum rebum stet amet. Eu accusam ut vel et vel diam invidunt dolor ea sanctus delenit. Quis duo et invidunt quis dolores. Quis accusam ipsum cum. Adipiscing enim est liber dolore diam sea aliquyam in velit eum no eos. Rebum consetetur sea.

Sample Output H4

Magna sit nam lorem sea justo vel ut. Amet in vero. Vero lorem dolores aliquyam et ea. Kasd ipsum labore at diam eos stet consectetuer erat est sanctus accusam tempor voluptua laoreet et. Zzril aliquyam vel et justo stet invidunt augue et eos invidunt vero in eirmod accusam sed cum. Et clita amet iusto invidunt takimata et consectetuer diam hendrerit.

Ea dignissim aliquyam eirmod et voluptua stet amet sadipscing. Lorem at esse amet vero exerci sed sanctus labore dolore. Sit hendrerit facilisi clita sea sadipscing eu est liber ut. Diam invidunt nibh molestie consetetur nonumy lorem sit ea facilisi. Commodo vel nisl voluptua molestie stet et lobortis ut liber et eos.

Sample Output H4

In voluptua euismod aliquip dolor sed suscipit magna cum ipsum amet placerat sanctus ad nisl sanctus eirmod. Consetetur sed diam gubergren sed odio nisl dolores consequat sit eirmod no sed stet takimata ipsum ut. Elitr augue stet ad magna duo amet duo est aliquyam dolor clita dolor sanctus dolore lorem erat sed sed. Sit lorem amet invidunt clita lorem tation id sadipscing eirmod. Sea diam in vel consetetur ut sit sit placerat. Takimata minim facilisis ea ut. Diam sed aliquyam ut praesent erat elitr stet in dolore dolor eirmod doming takimata aliquam.

Delenit sadipscing et nonumy erat tation ea luptatum. Praesent veniam diam vero tempor dolore. Duo sit et clita et dolore facilisis dolor iriure sadipscing quis exerci no amet duis ea augue erat kasd. No rebum erat ipsum et dolor eirmod facilisis. Invidunt dolore rebum vero diam sed elitr ut eum volutpat sed consequat vero feugiat. Dolor euismod hendrerit diam labore. Rebum tempor nibh rebum vel lorem eirmod wisi wisi sit sadipscing labore ut feugait.