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

At consetetur diam ut blandit et clita takimata facilisis diam clita magna. Dolor consectetuer sed nostrud in amet duis diam laoreet et eos sed sea diam. Iusto eos accumsan lorem laoreet aliquyam dolor gubergren veniam gubergren ut clita. Feugait te dolore elitr voluptua amet. Magna magna clita ipsum te dolores sed diam ipsum duo lorem no magna.

Sanctus ex illum hendrerit duo amet sed dolor soluta sea nonumy. Ea clita minim magna nisl rebum erat voluptua. Clita amet ipsum sanctus odio eos sea feugait placerat diam. Dolor takimata est. Dolore et duis in accusam enim nonummy. Accusam et erat sanctus diam odio aliquyam amet magna. Kasd consetetur est hendrerit volutpat vel sed duo sed clita minim sea nonumy elitr takimata iriure. Eos ipsum erat eirmod sed cum ipsum. Ea nulla amet sit et tation.

Sample Output H3

Dolore sit consetetur dolore sit feugiat zzril nostrud ipsum. Ut vero stet rebum suscipit lobortis sit dolor. Sed ipsum kasd labore in molestie sea accusam nonumy et sit. Justo labore takimata dolor dolor clita justo. Hendrerit invidunt ut esse eos eirmod feugiat accusam amet tempor no et ipsum ut invidunt lorem stet sit lorem. Iriure et tation euismod sit dolores dolor nulla molestie duo sadipscing placerat voluptua accusam duis dolor dolores. Sed dolor qui eirmod nonumy dolor hendrerit nulla velit labore dolor. Gubergren sit no elitr stet esse kasd lorem dolore est diam takimata labore nobis sed duo nonumy vel justo. Eos voluptua luptatum labore sadipscing in invidunt eos tempor et ex. Kasd vero facilisi elitr.

Aliquam eirmod erat amet kasd. Stet imperdiet est tempor eos diam et lorem rebum et augue labore ea eum ad quis option accusam. Minim lorem sadipscing amet accusam consetetur dignissim accusam eum. Tempor labore tempor. Eros dignissim sit. Lorem amet magna volutpat duis et sanctus ea et eos. Ipsum est illum no et duo et et eleifend autem sadipscing ipsum qui diam sed sed.

Sample Output H4

Et ut et invidunt voluptua ex accusam takimata. Facilisis gubergren blandit et nonumy. Magna accusam sea diam ut eu. Sanctus et magna est diam vel veniam nulla sanctus eirmod. Et cum magna sit sit nulla dolor ullamcorper duo nibh. No dolor in et diam eirmod ut. Quis gubergren magna.

Takimata facer est amet magna sit labore accusam lorem elitr lorem ut ex congue eirmod. Ut dolor sanctus eirmod euismod sanctus dolores eirmod dolores voluptua magna eirmod eos at. Takimata aliquyam kasd amet kasd sadipscing sea dolore voluptua sadipscing facilisi ipsum lorem ipsum consequat nonumy ut. Velit at suscipit ipsum invidunt dolore amet eos. Feugiat eos elitr sit luptatum sed diam vel lorem in diam sed duo diam justo sanctus quis invidunt ipsum. Vel ea velit lorem nonumy et labore. Tempor at dolores clita aliquam et congue aliquam ea dolor voluptua. Luptatum est sit duo et hendrerit volutpat ipsum dolor ipsum iusto accumsan aliquyam magna ut rebum.

Sample Output H4

Laoreet autem dolore consequat diam. Eos sadipscing tincidunt. Consequat justo diam amet kasd augue kasd elitr dolor justo. Lorem ipsum eos et aliquyam sanctus sadipscing zzril et ea ea dolore. Ut kasd erat eirmod amet duo amet at ea sanctus sit lorem takimata sed facilisis dolores. Kasd clita voluptua et hendrerit vel dolores dolore nonumy et aliquyam veniam et.

Dolor justo euismod erat amet sanctus feugiat eirmod hendrerit luptatum labore elitr et ipsum dolore dolore. Ipsum lorem dolore ut stet eos erat eros praesent nihil et sit dolore ut praesent accumsan et nostrud. Duis erat iusto delenit dolor duis justo enim sea id consetetur eirmod sed takimata et augue sed. Lorem magna amet rebum sea kasd consetetur feugait. Gubergren ea dolor velit labore sed sadipscing invidunt justo voluptua no kasd imperdiet nibh. Et dolores eos no magna lobortis dolores nisl takimata est justo at sadipscing ipsum accusam aliquyam et. Sadipscing hendrerit duo tincidunt no. Kasd luptatum accusam magna tempor justo invidunt voluptua tempor.

Sample Output H3

Et vulputate justo ad quis consetetur elitr consetetur. Rebum dolores et eirmod et aliquyam eirmod vero ipsum dolor. Zzril no rebum. Eu tempor et lorem vulputate lorem kasd elitr labore diam amet elitr nobis dolor. Dolores gubergren nibh imperdiet ea nostrud aliquip. Rebum nam magna clita nonumy et dolore clita volutpat at hendrerit aliquyam.

Nam voluptua elitr ipsum voluptua sed dolore dignissim tempor est sed takimata. Feugiat ut elit rebum volutpat dolore esse sanctus diam ullamcorper et. Vero nonumy consetetur dolor praesent clita et labore sadipscing ipsum diam cum clita consequat aliquam zzril. Ut id labore et rebum clita voluptua tempor clita duo duis dolor justo at et invidunt. Dolor takimata et ut accusam sadipscing. Ut veniam sadipscing luptatum voluptua dolor labore nulla. Voluptua stet kasd takimata takimata sadipscing justo duo no vulputate tempor ad blandit hendrerit sed duo duo dolore adipiscing. Voluptua est commodo ut nonumy minim labore nulla vero kasd no vel at veniam iriure.

Sample Output H4

Facilisis voluptua vero aliquyam. Ipsum congue dolores rebum dolor duo ea lorem no. Duo sed ipsum accusam consectetuer dolore ea in et tation. Lorem illum mazim gubergren lorem sit et nostrud facilisi sanctus takimata gubergren hendrerit takimata. Ut at magna lorem.

Ut esse ut erat eu dolore ipsum dolore voluptua illum nam nostrud. Praesent duo iriure erat feugiat blandit amet lobortis tempor amet sea dolor nulla ea. Quis nonummy iriure vel amet aliquyam ea elitr sea. Et autem consectetuer sanctus nulla nonumy aliquam gubergren kasd takimata dolore vero accusam volutpat amet dolore. Ea sanctus vero gubergren justo nam. Odio dolores nonumy et ad ipsum nisl. Duo vero no est et aliquyam accumsan amet in ut gubergren nibh et duis sanctus. Lorem nam gubergren amet molestie labore accusam dolore sadipscing ut facer stet amet option lorem eum ipsum.

Sample Output H4

Dolor no eu clita gubergren sea gubergren et at takimata aliquyam lorem. Kasd kasd accusam. Aliquyam ipsum dolore amet. Nibh clita dolor nonumy clita facilisis diam dolore magna iusto sadipscing sanctus no et dolore consetetur enim tation. Consectetuer autem voluptua stet tempor blandit. Assum diam dolor at erat. Kasd sadipscing eleifend dignissim et odio sit dolore sanctus euismod lobortis at laoreet illum ipsum sed blandit duis nisl. Te option eros consequat lorem diam nonumy.

Ad duo sit lorem eirmod kasd ea in luptatum erat dolor veniam at elit et diam. Aliquyam et nobis duis voluptua invidunt justo in consetetur nulla. Amet dignissim eirmod et eirmod sea tation amet no accusam vulputate vero lorem et. Praesent te rebum dolores justo at consetetur clita magna est at duis sanctus dolore sed dolor sed congue stet. Aliquyam diam delenit sed odio eos in magna ut sadipscing. Consequat no eos ipsum consetetur nostrud consetetur dolore quis dolore. Sea kasd rebum sed commodo stet lorem at feugait at diam et et diam kasd tempor ad.

More Sample Output H2

Rebum consetetur tempor vero doming tempor et nonummy et ut wisi invidunt et rebum. Et esse sit. Nonumy diam dolore gubergren ipsum ex ut nibh sit gubergren dolores diam delenit zzril sanctus amet rebum et. Duo sadipscing qui sit dolores eos diam eirmod dolor justo amet amet sed. Et et diam illum.

Sea labore facilisis magna dolore adipiscing amet justo diam dolore. Sea clita est erat enim et at zzril accusam clita nulla est. Sit ipsum voluptua ipsum sea nonumy erat rebum aliquyam illum. Enim stet in aliquyam amet diam et volutpat aliquip ex sadipscing eirmod invidunt stet lorem. Dolor feugiat dolor elitr clita dolores. Magna iusto feugait sit tincidunt amet lorem ut diam sit amet dolore et sit sit eirmod sea iriure magna. Sanctus sea illum nonumy invidunt tation. Sed et ea eum dolor vel vulputate sea tempor sed eu sanctus duo commodo diam dolores. Sed ea labore. Sanctus dolores ut enim magna et dolores eos eirmod et kasd accusam. At at iriure dolor ipsum invidunt aliquyam sadipscing dolor dolor quis magna aliquyam labore erat et.

Sample Output H3

Accusam iusto delenit est amet ad voluptua dolores adipiscing eos dolores diam diam tempor sea justo sed. Sadipscing ut consetetur erat est autem lorem at. Vulputate sit dolore eirmod eu no justo nonumy luptatum erat possim facer voluptua diam. Vero accusam tincidunt vel dolor elitr vero amet et dolor dolore minim tempor hendrerit et. Duo vero gubergren takimata et congue labore soluta sed dolores dolor nostrud et stet ea ut. Autem velit consequat duo ipsum eos ea rebum vulputate dolore et amet dolor invidunt ipsum autem magna accusam. Esse sit commodo at sanctus at lobortis.

Eu vero sanctus voluptua molestie. Et lorem justo duo sit sit kasd sadipscing voluptua vero consequat duo. Dolore amet eros est lorem dolores dolore nonumy amet stet diam euismod invidunt eirmod ex feugiat et. Nonumy duo kasd dolore consetetur ipsum dolor at. Et te eos dolor qui accusam.

Sample Output H4

Amet accusam justo sanctus. Dolor ea vero sed elitr velit diam stet elitr sit gubergren diam vel ut ipsum qui sanctus dolor elitr. Ipsum facilisis nibh dolore clita elitr. Ipsum labore accumsan gubergren dolor ad aliquyam magna sit takimata dolor sanctus sea. Duo dolore vel rebum kasd. Tempor ad ipsum nonumy quod imperdiet ea dolor voluptua lorem facilisis sanctus amet invidunt clita sed aliquip invidunt. Te ad odio tempor duis lorem takimata sit voluptua illum amet magna et sit dolore sit et consequat. Dolores aliquam lorem tation est sadipscing sanctus ullamcorper. Lorem lobortis vulputate magna dolor et dolor sea ut eos vulputate ut invidunt amet.

Magna eos erat diam amet sit stet. Aliquyam sit duis imperdiet no minim ut dolores rebum sit feugiat in sadipscing. Sit sit lorem diam duo voluptua at ipsum lorem vero dolor amet vero justo magna vel sanctus. Elitr clita sit amet odio. Amet tempor nonumy vero est sit dolores dolor facilisis blandit accusam. Sed nisl dolor et dolore rebum dolor hendrerit duo sadipscing in magna lorem magna sit et lorem duis rebum. Quis vel iriure facilisis aliquam justo diam et takimata sit accusam accusam ipsum amet est ut diam. Sed accusam consetetur. Odio takimata stet takimata accusam at hendrerit clita autem rebum velit et invidunt praesent kasd et sed.

Sample Output H4

Ipsum eirmod accusam et dolore gubergren ipsum doming gubergren clita. Vero et sit elit velit lorem et aliquyam ipsum nisl sadipscing sed ipsum sanctus adipiscing dolore. Lorem at ut vero esse diam sed labore duis lobortis. Nulla amet consequat diam sadipscing liber justo ipsum hendrerit. Diam diam sanctus dolores esse. No lobortis vero ea. Sit et sea invidunt lorem lorem invidunt ipsum est. Nonumy ea est diam iriure no labore. Veniam commodo accusam vero ut feugait duo. Nonumy lorem no dolore ipsum at nonumy kasd exerci dolore in. Justo consequat eirmod amet labore amet tempor accusam.

Diam amet vel vel magna stet ipsum takimata sed. Duo sanctus sit tempor et nonumy magna ea magna consetetur eu erat. Laoreet dolore gubergren ipsum voluptua diam consectetuer iusto. Suscipit in et enim. Augue minim takimata vel sit esse vero. Kasd dolores dolores eos sit vel eos.

Sample Output H3

Erat eos ipsum duo invidunt dolore et eirmod. Veniam consetetur et esse sanctus rebum. Amet duo dignissim accusam magna luptatum voluptua quis dolor justo in magna erat dolore. Delenit et et stet feugait dolores. Invidunt sed voluptua in. Vero aliquyam praesent sed amet lorem dolor erat erat stet lorem amet eos eos.

Lorem in dolor esse et. Magna amet erat elitr. No sit ad facilisis sit molestie amet ut molestie. Sed dolores sadipscing euismod cum accusam kasd dolor velit eleifend vulputate ea nonumy justo dolore accumsan. Nonumy sit amet dolores dignissim dolor amet stet dolor esse ut feugait nulla tempor accusam dolores minim. Consetetur no gubergren stet no sit. Dolore kasd ut amet takimata consetetur magna sanctus augue sanctus sanctus ut. Elitr et diam eirmod sit lorem illum feugait dolore ad zzril dolor elitr in. Ea dolore diam invidunt.

Sample Output H4

Aliquam elitr kasd facilisis amet sed nonumy accusam consetetur zzril luptatum nobis. Nisl nonumy dolore lorem duis esse duo et sit dolor lorem autem ea justo. Placerat et et justo est dolore ex vero sed clita takimata. Vero sanctus eirmod. Ea ad consetetur diam vero enim. Lorem dolore clita duis aliquam consetetur at tincidunt aliquyam et ut. Vel ipsum consectetuer nihil et lorem. Dignissim sadipscing vulputate at ad invidunt stet et aliquam ipsum et nonumy dolores eos. Magna et te accusam magna.

Justo voluptua diam esse euismod sea. Dolor et iriure et vero dolor eu nulla takimata ipsum consetetur et kasd. No sed exerci duo takimata eos et dolore invidunt sit dolores accumsan justo vero quis ut vero gubergren. Aliquam lorem dolore amet est at diam elitr vero consectetuer nostrud. Sed tempor eros euismod dignissim. Volutpat blandit vel takimata vulputate erat et takimata enim sea eos aliquyam odio at.

Sample Output H4

Tation dignissim eos amet lobortis sea aliquyam luptatum et erat sadipscing invidunt iriure et consetetur magna. Ullamcorper nonumy sea eirmod. Delenit takimata clita zzril kasd sit dolor. Gubergren esse amet accusam dolor sanctus liber accumsan dolore sit in et hendrerit dolore aliquip dolor. Vel labore tincidunt accusam et ut. Eos hendrerit sed amet labore elitr dolor augue rebum et justo ipsum sed accumsan et eirmod. Ut dolore diam et justo eirmod duo amet rebum justo. Sit et eos amet duo eirmod et aliquyam ea accusam et dolore lorem at.

Vero rebum takimata eos dolore sit. Invidunt et takimata ut stet lorem voluptua ipsum ipsum voluptua rebum sit eos lorem vero invidunt ipsum. Ea et velit at et. Dolor rebum justo. Esse sea feugiat hendrerit accusam eros invidunt imperdiet gubergren tempor nonumy sit vero et sanctus. Ut vel sit justo est sed eirmod accusam et vero sed tempor sit erat.