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

Nibh diam gubergren luptatum vero takimata blandit aliquip esse sit sanctus dolores feugiat facilisis accusam. Sea duo iusto sanctus eos et option dolor hendrerit. Voluptua stet nonumy sadipscing. Clita erat consequat ipsum eos imperdiet eum amet lorem labore consetetur sit dolore in dolor eos sea dolor invidunt. Magna kasd ut rebum at feugait sea eos stet eirmod ipsum et sadipscing sadipscing sadipscing. Dolor eos et dolor enim ut diam diam at accumsan dolor elitr sea facilisi ipsum kasd lorem est voluptua. Facilisis sed sed vel lorem. Dignissim et nibh dolor molestie est.

Accusam ut cum labore takimata sit nulla sea et dolor sed. Ea vero eum diam clita esse et elitr elitr tempor sit ut eos. Eirmod magna et dolore invidunt stet quod at. Nobis eros et ipsum aliquyam amet diam minim voluptua sed eirmod takimata. No sit ut labore nonumy sea sanctus dolor et dolore invidunt amet sed veniam sed eirmod. Consetetur sed voluptua eirmod aliquyam sit mazim velit tempor dolor dolor elitr invidunt facilisis consetetur amet ipsum est.

Sample Output H3

Ipsum vero sit et sit sadipscing no ut ipsum et commodo lorem tincidunt clita dolor imperdiet. Elitr sit et kasd minim ut gubergren eirmod. Iusto eirmod sed eirmod facilisis ut no hendrerit sit et sed. Tempor accusam elitr exerci facilisi diam. Aliquam dolor at vel et ea iriure te dolore justo no facilisi diam ut at. Iusto sadipscing dolore invidunt amet sanctus autem amet sed ullamcorper sit est sea sea ipsum. Amet delenit eleifend sea consequat magna. Ut lorem kasd sea et invidunt elit amet dolore elit. Lorem et sea cum ea ut ipsum no est gubergren dolor no dolor ullamcorper et assum duis. Ea volutpat hendrerit et luptatum lorem tempor ut erat at stet wisi sanctus tempor. Exerci tempor nam delenit gubergren et.

Nonumy dolor elit accusam no no vel takimata dolores dolores nonumy magna rebum vero labore duis ut. Labore molestie diam autem diam ut kasd dolore takimata eirmod. Nonumy ipsum ea blandit kasd molestie rebum et feugiat imperdiet voluptua sanctus qui wisi. Ut voluptua clita labore sit eos et consetetur dolor ea. Nostrud clita kasd gubergren at illum stet stet nonummy ea at magna volutpat consequat tation ea. Et vero no sadipscing aliquyam kasd takimata velit tempor tempor labore suscipit duo elitr duo lorem. At et iusto volutpat consequat et ea sanctus eirmod autem facilisi vero voluptua dolor diam takimata eos. Et sanctus justo sed dolor est. Eirmod eum nostrud et accumsan iriure sanctus sadipscing dolore kasd eirmod consetetur zzril et dolore no. Sed duis eirmod rebum duis et sit nihil amet erat dolor ipsum aliquyam sanctus. Soluta dolor autem sed diam autem ipsum et sit ad iusto vulputate.

Sample Output H4

Sea euismod nonumy aliquyam consequat lorem. Est accusam sed consetetur dolor facilisis facilisis eos gubergren amet elitr erat. Feugait tempor aliquam accusam justo magna at labore vel. Vero nonummy vero autem tempor elitr takimata sit congue nam kasd duis takimata ullamcorper ut vero. Erat sit sed dolore.

Et nonumy dolor sanctus molestie kasd diam diam invidunt elitr vero ipsum vel diam aliquyam. Magna dolor tempor dolor clita. Stet magna rebum dolor sadipscing est consetetur et sed. Elitr vero invidunt id et tempor vulputate nostrud. At vero diam et ipsum liber consequat ipsum ut. Accusam consetetur dolore sed in no elitr sed esse labore et illum et. Clita consetetur vero est est in consetetur ut duo sea dolor blandit id commodo euismod zzril sed sit ipsum. Accusam velit accusam sit consetetur ut vero amet ipsum. Lorem no feugait diam hendrerit gubergren dolore ad ut labore voluptua invidunt gubergren rebum. Voluptua ea consetetur.

Sample Output H4

Diam est et delenit aliquyam. Est sed kasd. Illum ipsum dolore quis hendrerit eum no sed no ut et accumsan ipsum nisl consetetur labore. Voluptua et duo ipsum magna diam et commodo consetetur exerci aliquyam takimata ad sanctus est odio et eirmod diam. Lorem odio aliquip dolores. Ut vel erat ipsum dolor delenit et dolor amet sed. Sadipscing dolores dolor dolores et. Elit magna erat labore enim quis kasd lorem vero et sit sit voluptua eos amet dolor gubergren erat ut. Amet elitr stet in sed duis diam commodo sed minim facilisis elitr.

Tempor volutpat eirmod suscipit. Et voluptua amet sed diam aliquam amet at magna est hendrerit sanctus eum sit. Vel in duo invidunt hendrerit sit amet dolore voluptua. Feugait gubergren vero eirmod esse dolores stet tempor eirmod sit. Sit rebum ipsum sadipscing diam dolor justo sadipscing tempor. Invidunt vero dolor stet magna dolores dolor et nonumy kasd.

Sample Output H3

Dolores justo et. Iusto eirmod nonumy sed. Liber et dolor justo nonummy molestie voluptua. Lorem dolor nonumy eirmod vero eos ut et amet accusam et kasd. Erat justo sed accusam minim molestie erat duo ea dolor accusam sadipscing sit option hendrerit sit. Molestie dolor voluptua. Diam duo vero ut eum enim velit lorem erat. Nonumy et amet tempor magna kasd dolor clita sit diam dolore labore sit dolores veniam vero vero kasd accusam. Dolores magna invidunt iusto.

Amet ut eos justo. Dolore veniam ut kasd facilisis dolore minim. Vero sit at dolor dolore velit voluptua placerat ullamcorper aliquyam justo vulputate dolor et vel. Sea aliquyam kasd no illum gubergren dolor dolore magna. Volutpat dolor sea dignissim nonumy accusam aliquyam et ut. Mazim congue lorem tempor takimata. Stet dolor tempor ipsum et consequat hendrerit esse takimata dolor at qui rebum. Sed ut stet ut ea ea no invidunt dolores congue consetetur eos. Sed voluptua feugiat at at ipsum est luptatum hendrerit ipsum praesent sit. Delenit voluptua sit at ea exerci dolores ipsum sit takimata sea duo est sed stet facilisis.

Sample Output H4

Est labore kasd rebum no aliquyam accusam option et te dolor diam et tempor duo. Dolor in feugait et et praesent sit et eleifend. Dolores takimata in imperdiet sed diam nostrud delenit. Et stet lorem invidunt wisi et ea te et. Vero sed facilisi sit at diam in dolores aliquam sed ullamcorper tempor iriure eirmod odio.

Kasd eirmod blandit nulla congue sit takimata ut rebum invidunt dolor consetetur. Dolor et diam amet. Dolore eum sanctus eros takimata dolores voluptua tempor vero sed dolor dolor dolor veniam. Takimata lorem accusam et adipiscing. Diam duis lorem eirmod eirmod placerat eos illum. Dolore veniam aliquip sanctus kasd. Exerci justo magna et et eros sit dolores ut sed adipiscing est diam amet consequat eleifend erat.

Sample Output H4

Ullamcorper te nibh kasd aliquam at vel lorem eleifend. Ex labore sed aliquip duis duo lorem no magna clita magna. Dolore at lorem eirmod. Feugiat velit consetetur labore dolor et est ut eu magna sea illum doming tempor lobortis iriure sed. Amet sanctus sit ea doming consetetur elitr dolor magna molestie at vero consequat takimata erat magna sit lorem takimata. Ipsum rebum at dolore sit vulputate duis diam at vero elitr. Facilisi dolor feugait dolore justo dolore sed sit elitr amet duo dolores consetetur blandit amet sit amet.

Sadipscing et dolores dolor minim magna aliquip et no luptatum ipsum et dolor nonumy duis et stet. Amet diam dignissim tempor nonumy consequat justo erat elitr tempor amet tempor. At ipsum tempor lorem nonummy diam ipsum sadipscing dolor zzril. Justo vel ad sed. Ullamcorper dolores sed.

More Sample Output H2

Labore soluta sit et amet dolor magna dolor et dolores elit. Et dignissim duo. Et duo aliquyam duis laoreet ipsum et tempor duo lorem eirmod sed. Ut ipsum amet blandit elitr. Aliquam tempor diam in esse. Elitr sanctus kasd labore dolor delenit elitr gubergren elit. Ea cum invidunt aliquyam aliquip sed delenit est nonummy ea eu consetetur eirmod quis lorem et. Hendrerit duo est.

At lorem illum ut at molestie et vero erat magna sit hendrerit justo kasd diam kasd. Facer diam lobortis dolor accumsan duo dolor vero molestie justo no illum sit et laoreet nulla. Sed et erat ut nisl voluptua et at justo congue enim no vero nobis dolore. Tempor diam rebum amet aliquyam. Invidunt labore nulla dolor ipsum clita velit amet sanctus. Amet sit est rebum dolore laoreet labore ea eos. Est molestie ipsum gubergren dolor dolores et. Delenit ipsum diam clita gubergren.

Sample Output H3

Labore nonumy dolores facilisi eos amet et elitr stet rebum vero duis at tempor dolore sadipscing lorem in. Dolore et ut magna at esse sed in commodo elitr sadipscing eirmod diam. Luptatum nulla molestie dolores at dolores eirmod aliquyam aliquyam ut nulla. Aliquyam consetetur liber amet lorem. Diam justo amet. Ipsum ipsum quis diam magna. Amet amet et et. Justo gubergren amet luptatum diam nonummy invidunt diam wisi invidunt.

Soluta dolor vel et ea vulputate. Ad et tincidunt sit nonumy. At sit ut diam. Sit magna et. Et ut odio et sed justo dolores ex ipsum sed nihil iriure sea gubergren. In et feugiat aliquyam dolor veniam sed elitr facer wisi qui facilisis. Diam imperdiet diam eirmod ipsum consetetur gubergren augue consequat lorem ullamcorper ea option possim.

Sample Output H4

Feugiat ipsum volutpat. Ipsum et lobortis. Voluptua sed dolor gubergren eros ea kasd sadipscing elitr stet. Sanctus eirmod gubergren kasd delenit duo dignissim et erat accusam eos sit et sit justo. Ut ipsum velit sit diam nonumy. Veniam tincidunt magna adipiscing invidunt et praesent et et dolor lorem soluta ut nam. Duo laoreet magna consetetur kasd dolore ipsum. At no voluptua at duis sed euismod. Consequat dolores eum ad invidunt dolor illum illum no augue tincidunt et tempor facilisi duo molestie invidunt takimata et.

Vel nihil delenit. Takimata ullamcorper euismod facilisis elitr duo et dolor in et adipiscing. Nonumy eirmod esse sed ipsum ut vel eirmod nobis vero duo at sed nonumy elitr takimata nulla. Amet aliquyam dolore sea erat sit no diam et iriure labore ut ipsum sed enim amet dolor duo. Qui eos duis et exerci takimata. Diam luptatum sit lorem at dolores dolores adipiscing ea aliquyam sea feugiat te velit.

Sample Output H4

Justo invidunt tempor erat. Sea sadipscing zzril voluptua. At kasd duo nonumy ut nonumy ut kasd nibh voluptua et sit ut et sanctus sit diam stet tempor. Sadipscing sed molestie ea in veniam nonumy sed rebum sed. Et diam dolor sadipscing sanctus ut at takimata amet enim.

Et suscipit hendrerit molestie et lorem tempor molestie est clita erat rebum dolor ut tempor magna sea eleifend. Ea ea duo lorem duo dolore elitr et lorem amet rebum dolor dolor consetetur. Sit feugiat invidunt magna dolores et sed dolore qui in dolore eirmod doming dolore rebum sed ipsum tempor. Soluta eu eos takimata ut luptatum autem euismod luptatum vel no diam consetetur in eu sed no. Nostrud autem sit tempor tempor lorem liber illum facilisis sit et sed eos et ipsum sadipscing hendrerit aliquip.

Sample Output H3

Kasd commodo lorem minim exerci aliquyam nonumy ea accumsan enim erat lorem lobortis dolores est. Sea delenit te accumsan qui suscipit et dolores sed tation eos elitr ipsum. Duis lorem lorem ullamcorper labore rebum facilisis nisl consetetur sea lorem vulputate gubergren kasd dolores ad. Takimata kasd voluptua ut clita takimata dolore amet eirmod diam. Sea dolor sanctus dolore ipsum vero accusam congue sit ipsum nobis sea dolor. Est molestie et erat autem gubergren sit at sanctus dolores dolore. Lorem sit iriure sanctus justo stet et sadipscing amet sadipscing ut velit est. Diam vulputate ad nam eos ipsum kasd aliquyam sed. Nostrud iusto facilisi labore qui nonummy sit nonumy lorem rebum voluptua est takimata consetetur erat possim accusam.

Kasd invidunt ut at consetetur justo eos et volutpat minim sed takimata. In diam veniam. Eos odio suscipit et dolor sit et sed at cum aliquyam ut sed et eleifend eum dolor erat. Kasd dolor augue ea stet illum. Amet at takimata takimata clita ipsum sit dolore dolores amet gubergren sit amet. Justo labore labore dolore dolor congue diam at sit consetetur dolores quis dolor sit labore no nam et. Sit sit eros labore. Takimata eros dolor sit dolores et invidunt takimata ea augue et.

Sample Output H4

Lorem duo dolore vero et erat eum diam et tempor sit dolore sed sed tation consetetur. Nonumy sadipscing amet kasd elitr consetetur magna diam voluptua nulla. Gubergren et eirmod et et veniam takimata lorem et vero ut nihil. Vel suscipit vero sit rebum doming iusto dolor augue dolore nulla dolore delenit dolor facilisi at volutpat erat. Dolores sanctus aliquyam.

Consetetur elit te et lobortis at et lorem no kasd dolor duo justo. Consectetuer amet sea clita. Sit ipsum feugait nisl sit blandit sed dolores et sit magna praesent. Vulputate at takimata labore labore nobis elitr et kasd liber. Molestie lorem nonumy est sanctus dolor accumsan no consetetur.

Sample Output H4

Sit adipiscing eos lorem accusam euismod in vero sea amet. Amet clita sadipscing et augue magna at et takimata sed tincidunt sea et. Erat vero dolore erat est lorem elitr ut eos at sed kasd dignissim. Ut ipsum aliquip augue velit consetetur gubergren diam kasd et ut feugiat et sed dolore amet iriure. Ipsum takimata sadipscing commodo rebum sanctus accusam feugiat ut. Nonumy justo luptatum dolor id sit blandit. Odio erat velit no eos invidunt stet dolor labore diam iusto duo mazim clita sit autem sea stet accusam. Wisi delenit sed no ut et iusto.

Dolores et nisl ullamcorper soluta accumsan minim tempor amet id takimata ipsum lorem placerat eum odio duo ipsum. Sit dolor euismod diam at et sea eos sit feugiat magna ipsum ad. Tation dolores amet sit nibh. Eirmod nonumy tation. Diam rebum magna lorem takimata dolores stet in aliquyam rebum elitr et aliquam invidunt magna laoreet consetetur sit vero.