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

Lorem sanctus magna dolores vero sed. Vero consequat magna labore nobis amet sed accusam. Velit ipsum sea molestie in sit takimata consequat luptatum et accusam. Dolor voluptua nonummy eirmod consetetur elitr accusam eos vero ipsum nonumy vero nisl eirmod lorem et et. Nonummy eirmod assum et dolores quod sed luptatum sanctus sea. Ipsum dolores sea qui sit odio quis adipiscing amet. Lorem ut nulla iriure sed sea dolores aliquyam. Et ipsum diam est lorem sit dolore et. Tempor sadipscing sit invidunt dolore delenit dolor consectetuer dolore lorem justo molestie takimata lobortis tincidunt. Tincidunt soluta aliquyam voluptua. Velit kasd vel.

Rebum accusam dolor ut enim amet possim ipsum nihil. Sit dolores et no et diam at stet clita. Et enim duo amet tation duo ex takimata kasd ut eirmod te dolore vel et. Invidunt vero accusam. Amet est sanctus takimata dolore quis aliquyam accusam vero praesent quis dolor accumsan amet dolore vel lorem aliquyam clita. Kasd consectetuer tempor sed labore vel veniam sit te in sed dolores sed sadipscing. Duo vero sanctus aliquam sit eirmod amet ipsum sed no dolores accusam facilisis sit. Et suscipit feugiat accusam molestie magna duo sed duo at amet. Sed eirmod et consetetur sanctus nulla illum accusam accusam eros sadipscing dolore.

Sample Output H3

Ut justo qui invidunt wisi nonumy hendrerit. Volutpat suscipit vel accusam sed stet amet elit eum augue accusam diam lorem sed takimata et aliquyam exerci. Ut ex magna sanctus et eros est sit. Sadipscing magna feugiat in justo in. Accusam nonummy ut vero et et est sit enim. Dolor at sea et dolor in sea wisi duo nam stet sadipscing luptatum. Invidunt amet et at exerci ipsum sed no consectetuer nisl invidunt tation consetetur. Tempor invidunt sit erat autem autem iriure sed tempor nulla esse sed accusam voluptua justo et sit. Gubergren accumsan eirmod justo. Aliquyam accumsan amet facilisi consetetur magna tempor aliquyam dolore wisi et at dolore kasd at feugiat duo tempor. Eirmod kasd consequat.

Facilisi nulla autem aliquyam gubergren imperdiet. Dolor duo ipsum ea vero laoreet sanctus dolore amet. Labore takimata quod option ut diam in kasd dolores elitr sit kasd justo iusto consetetur lorem. Ut volutpat nobis magna tempor aliquip kasd at at erat sit dolores. Clita magna magna et. Ipsum sed sit. Voluptua sea nonumy tation cum et invidunt lorem rebum accusam et no accusam imperdiet minim clita dolor ipsum.

Sample Output H4

Facilisi sea erat sadipscing quis aliquyam rebum no. Eum aliquyam at stet consetetur lorem sadipscing dignissim. Sit consetetur diam voluptua amet et zzril ipsum diam sed tempor. Delenit doming rebum dolore duo. Stet tempor sit iusto. Facer sit wisi sed. Amet at ipsum justo adipiscing dolor amet ipsum illum aliquyam at ipsum duis.

Ut voluptua diam dolore lorem nulla qui. Aliquip dolore duo consetetur consequat elitr volutpat. Rebum labore accusam ipsum duis aliquyam et dolor kasd no te. Vulputate eos gubergren. Tation dolor dolores quis suscipit molestie odio. Consetetur justo veniam lobortis sit nulla. Kasd dolores sit kasd dolor et accumsan rebum est eros euismod et autem accusam in sed.

Sample Output H4

Vero invidunt consequat at ipsum sadipscing amet ad sed vero nulla duo. Aliquyam nisl aliquip ea gubergren tempor clita accusam molestie. Soluta clita eirmod diam volutpat amet. Sit clita stet tempor accumsan vulputate facilisi. Ipsum takimata adipiscing voluptua labore. Invidunt velit magna stet vel diam nonumy eum et dolore magna sadipscing tempor ipsum stet et dolores. Dolor vel diam minim rebum sea takimata. Dolor erat feugiat vel duis. Option ea eu dolor sanctus stet dolore lorem ut sanctus vero est sanctus zzril tempor nostrud et.

Et takimata voluptua sed est et placerat takimata esse dolor takimata amet facer dignissim sit. Ipsum amet sed te eirmod sit ipsum vero labore nonumy. Ipsum quis tempor liber. Sit sed tincidunt eos sed clita dolore ea amet sanctus consetetur tation ipsum takimata tempor justo est ipsum dolor. Eleifend consequat lorem diam no ipsum sed dolores ad nonumy kasd dolore eos ipsum ipsum amet magna. Et diam velit euismod clita ipsum. Et gubergren sed dolor feugait ipsum tation elitr. At ipsum eirmod ipsum ea sit accusam vel et consetetur vero diam in.

Sample Output H3

Tempor lorem sanctus qui kasd est. Feugait est sea tempor labore aliquyam et sea vero sea diam gubergren diam qui iriure dolores augue eirmod justo. Sadipscing sit eos est blandit rebum lorem rebum est invidunt lorem magna sed sit nonumy. Nonumy diam sea elitr erat voluptua et et sed euismod justo eos. Accusam congue zzril at elitr luptatum et eu ipsum justo takimata in dolor erat eirmod est takimata.

Eum eos diam magna no nostrud labore labore ex sea iriure at nonummy. Et labore sanctus vero accumsan amet consectetuer et zzril tempor sea et ut diam et magna. Accusam at sea kasd sadipscing id sed dolores augue sed volutpat sed ullamcorper sea amet eros dolor aliquyam. Eleifend magna eu duo feugait veniam praesent sed ad. Sit nibh iriure justo sit. Lorem tempor et erat exerci erat et diam vero.

Sample Output H4

Diam clita clita feugait et. Ut magna no labore takimata amet eum amet diam amet iriure soluta zzril molestie. Quis dolores sit eirmod eros sit aliquyam et no est no tincidunt accusam nonummy eu consequat ut. Erat no labore luptatum diam sed eirmod at dolores et amet lorem consetetur sed ea dignissim amet facilisis et. Veniam sit ipsum dolor est. Praesent quod vero praesent sea et sea nibh dolore diam sit clita. Est sit soluta labore sea. Sed sed illum gubergren dolor et lorem duis ipsum consectetuer et nonumy exerci aliquyam. Hendrerit rebum amet sit dolor. Sed dolores at.

Vel eu kasd et no. Vel et voluptua invidunt invidunt molestie eos blandit gubergren ut gubergren sadipscing odio facilisi. Eleifend sed ipsum odio nisl et facilisis ipsum in at sanctus in et wisi dolores aliquam. Et et dolor diam tempor labore ullamcorper erat diam eleifend diam diam magna. Aliquip aliquyam nibh dolore vulputate stet. Vero eu ipsum et sanctus no magna sadipscing laoreet amet elitr dolore luptatum nonumy gubergren dolores aliquyam. Takimata ullamcorper elitr.

Sample Output H4

Et dignissim ullamcorper lorem et kasd dolore dolor gubergren et consetetur lorem sadipscing diam. Dolore voluptua facilisis ut magna duis sit et lorem ipsum accusam. Ea ut dolore. Elitr lorem diam kasd et lorem nonumy at nobis lorem lorem eleifend odio tation diam. Clita elitr autem magna labore takimata sanctus amet erat nonumy elitr aliquam amet commodo nisl. Eros accusam invidunt sit et. Diam dolore liber ipsum dolor et aliquip amet iriure hendrerit rebum dolor. Mazim eirmod lorem est sit voluptua sea dolore aliquyam eros dignissim diam lorem ut kasd eos ea. Nonumy sea lorem duo labore in justo eirmod no invidunt ut.

Est ipsum dolor ea at diam et invidunt in facilisis vel. Sanctus sit diam ea lorem ut accusam kasd diam no lobortis aliquyam vero molestie sadipscing dignissim dolor. Nonumy ipsum et. Et euismod vulputate dolor lorem labore dolor adipiscing nulla magna gubergren takimata at sea magna suscipit feugait sit. Sit consetetur sit rebum volutpat ullamcorper sed dolor eum tation laoreet tempor imperdiet accumsan veniam vulputate stet. Et minim tempor sea facer ipsum ut et ut sadipscing ut magna. Diam nonumy vel justo et invidunt clita elitr.

More Sample Output H2

Molestie et diam lorem at eos labore rebum aliquyam dolor. Consetetur ipsum voluptua sadipscing sit lorem erat nihil sadipscing ipsum clita eos labore eirmod ea voluptua. Stet ex consequat et magna et ut labore rebum sadipscing. Nisl eos erat. Est eos labore justo id gubergren. Eirmod exerci nibh illum delenit et dolor voluptua velit augue suscipit nostrud sit nonumy consequat labore in.

Te sea magna. Diam consetetur ex dolore ipsum aliquyam amet. Sit aliquyam illum dolore sed suscipit nonumy diam nostrud ea tempor ipsum ut sit aliquip erat sed. Nonumy iriure ex blandit duis eirmod. Amet est est amet nonummy ea sit facer nobis nonumy vel sit sit laoreet nihil amet. Molestie consetetur accusam invidunt tation. At et sed eum sed aliquyam quis. Congue clita stet clita luptatum gubergren amet magna. Diam dolore enim. Et minim facilisis dolor.

Sample Output H3

At ut odio velit dolor sea et delenit vulputate diam et sanctus ut sed. Labore esse dolore kasd dolor et volutpat nisl consetetur aliquyam. Diam sadipscing lorem stet autem ad amet at. Consectetuer sadipscing consetetur dolores sit adipiscing sit takimata. Aliquyam ut sit eros sea labore vulputate sit. Consetetur magna tempor duis voluptua sanctus suscipit accusam eos dolore at sed euismod sanctus takimata vero at sed.

Gubergren dolor rebum ullamcorper diam. Consetetur ut dolore. Luptatum takimata autem sanctus est facilisis elitr dolore dolores eirmod voluptua. Minim voluptua aliquip tempor vero aliquyam odio invidunt duo. Sit erat dolor ipsum et commodo at clita nonummy magna diam sit kasd duo diam et. Elit magna elitr at at nostrud dolore ea. Sea ipsum exerci magna accusam amet et nisl clita ut sea at clita vulputate. Lorem mazim amet sea at lorem molestie iriure est stet voluptua lorem no eos tempor hendrerit ipsum aliquyam. Vel eos eos amet kasd consetetur erat voluptua sanctus nibh nibh.

Sample Output H4

Sed ut et consequat rebum et sadipscing diam nulla. Lorem sit iriure et clita erat vero aliquyam accusam diam esse magna et. Sadipscing labore magna et eos feugiat. Ullamcorper ut eros aliquyam vero diam suscipit voluptua wisi accusam takimata dolor ea invidunt congue lorem ut ullamcorper. Dolore dolor vero dolor et gubergren amet est exerci delenit diam dolor dolores ipsum vero minim dolores lorem. Tempor sadipscing eirmod eirmod at vulputate sed ad. Delenit duis ut duis justo. Dolor sanctus amet dolores vel justo. Dolore sit exerci dolore ut sed laoreet sea facilisi eum clita et qui dolor.

Duo veniam est ea sit nostrud amet augue erat feugiat eos. Aliquip exerci sit euismod. Congue eum elitr kasd adipiscing lorem accusam sed nibh eos. Vero diam ut eros qui magna. Invidunt nonumy erat kasd et sit lorem imperdiet est dolores odio dolore aliquyam. Dolor erat et aliquyam lorem lorem dolore.

Sample Output H4

Vero invidunt consequat rebum possim eirmod adipiscing eum amet tempor amet te justo nonumy tempor. At clita nonumy amet ipsum eirmod est sadipscing invidunt vulputate nibh rebum sanctus amet et wisi praesent accusam dolore. Et tempor nonummy sea placerat diam est in duo tempor erat aliquyam labore kasd rebum tempor. Et ea invidunt magna sea erat lorem nonummy dolores. Sit lorem dolore sadipscing duo ut kasd sit lorem cum rebum tempor diam labore sit voluptua. Veniam at rebum. Invidunt delenit nonumy consetetur vulputate clita sed ipsum sea at magna vero et et ut elitr sadipscing.

Eos ea euismod wisi aliquyam rebum enim dolor nonummy. Aliquyam takimata dolor est sit ipsum possim. Lorem clita wisi et iusto amet vero et justo ad rebum. Et est eleifend at accusam no mazim magna sadipscing congue sea consetetur kasd zzril. Et quis et rebum.

Sample Output H3

Dolor consetetur volutpat dolore nonumy hendrerit gubergren feugait. Amet sit tempor ea lorem. Sanctus sea autem et et nostrud rebum justo lorem voluptua consectetuer takimata ut ipsum diam ipsum praesent at. Aliquyam kasd labore nulla amet dolores sed sanctus. Tempor takimata voluptua sit minim est amet diam sanctus nisl magna lorem no. Stet gubergren justo vel sit est nibh dolor et. Euismod justo dolor et diam et sed et lorem et dolore dolor lorem. Gubergren vero et lorem exerci amet. Volutpat ipsum tempor et consequat sed magna exerci amet et.

Sed sed kasd nibh nonummy clita. Magna ea sit mazim. Amet gubergren laoreet consetetur at aliquip nulla ut nonumy aliquyam kasd ea. Dolor elitr eirmod amet euismod molestie sit et vero et diam commodo ut amet ut molestie sed amet ut. Voluptua et at tincidunt et molestie lorem kasd nonumy qui lorem sit vel volutpat accumsan accusam aliquam.

Sample Output H4

Ipsum imperdiet invidunt vel velit consetetur sit nonumy liber et dolor. Kasd quis duo et dolore et rebum at elitr tempor cum. Est eos vel luptatum consectetuer aliquyam et tempor erat at ipsum qui laoreet vel invidunt elit eos dolor clita. Elitr amet dolores sit sed duo hendrerit accusam ut. Dolores gubergren elitr lorem velit praesent elit aliquyam nonumy sit laoreet nibh consetetur sed consetetur. Nibh ullamcorper aliquyam ipsum dolor ea vel rebum facilisis gubergren diam magna eirmod. Nonummy stet zzril et eros elitr eros eros lorem ipsum lorem in ullamcorper. Dolores eum amet doming takimata eu takimata invidunt sed dolore voluptua ipsum et sed lorem amet autem ex. Molestie tempor no rebum vero autem soluta in amet ea iriure ipsum elitr sea.

Duo no nibh at nulla. Doming accusam rebum consetetur accumsan voluptua congue voluptua gubergren. Erat velit vel nibh. Consectetuer tation sit eos dolor takimata ut enim. Blandit consetetur soluta. Tempor ut ea at lorem consetetur gubergren vulputate ut no at laoreet diam quis in sit. Est eos sanctus sea cum. Duis qui velit consequat sadipscing facilisis et diam elit sadipscing justo justo vero sadipscing sadipscing. Eros volutpat eirmod augue magna et autem minim sed.

Sample Output H4

Ipsum clita et dolore eos enim. Dolores est kasd sed et clita ut lorem minim. Sed dolor aliquam id in diam zzril sea justo sanctus invidunt voluptua tempor. Mazim labore duis lorem ipsum ullamcorper feugiat dolor et ullamcorper voluptua tempor nibh invidunt eleifend. At sed erat amet volutpat soluta sea sit eirmod eum invidunt et ipsum diam zzril diam.

Ipsum eu magna vero magna. Vel ad takimata stet justo. Kasd erat takimata in ad eros ut sanctus feugait diam. Et dolor est et consetetur. Quod sanctus invidunt duo tincidunt et et erat labore velit nibh minim sea sed sit. Dolor diam consetetur delenit sadipscing amet. Hendrerit feugiat ut takimata eos ipsum nulla dolore aliquip nostrud ipsum luptatum diam consequat eos justo sea eos. Ipsum tempor nonumy. Dolor nonummy consectetuer nobis sit sadipscing at. Sit ipsum enim clita liber ipsum enim gubergren. Nonumy accusam voluptua sanctus eirmod duis.