www.cloudformatter.com

cloudformatter format requests: 6,164,225    pages delivered: 14,074,079

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.

Note:

Recent changes in some browsers will not treat this XML as XML. Instead it tries (incorrectly) to not close tags. For best results, be sure to use open and close tags and not a self-closing tag.

<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

Ipsum et et consetetur amet sed. Option dolor tempor no et iriure qui elitr suscipit voluptua aliquyam rebum duis vero eirmod dolor nonummy magna. Sanctus diam laoreet sed. Sed ipsum sit sea justo nisl ipsum ea sit sadipscing lorem. Amet ad autem ad suscipit velit tempor vulputate no gubergren et erat consetetur et. Rebum justo accusam lorem eos est. Consetetur et magna gubergren eos ipsum iriure consequat clita ex sit volutpat stet rebum vel labore ut odio. Et ex et dolor nulla dolore. Odio diam dolor magna diam adipiscing labore est et facilisis justo rebum augue ut.

Dolor justo labore eros sanctus illum sanctus duo iusto amet. Et augue accusam vulputate lobortis amet mazim kasd ipsum tempor dolore augue takimata dolore no consetetur sed ea. No justo diam sanctus facilisis nulla accumsan. Sadipscing tempor sed nonumy sadipscing. Kasd sit no eos ut clita lorem accusam.

Sample Output H3

Takimata et at diam. Autem nonumy labore lorem et elitr ut dolore lobortis rebum stet labore et amet nonumy at sed. Sanctus facilisis vel dolore. Iriure ipsum ea tempor amet consequat praesent gubergren ipsum. Dolor dolor ipsum sadipscing elitr sanctus. Diam kasd dolor dolores nisl facilisis ea et sadipscing duo ea sed justo lorem ea. Elitr veniam sit lorem est ut sed diam ipsum kasd est at tincidunt dolor dolore amet eleifend laoreet lorem.

Quis ut ut. Dolores sanctus wisi dolor eirmod ea delenit ipsum facilisis est duis diam consequat consetetur sed justo duis ea imperdiet. Liber ea stet invidunt minim doming in sed in labore nihil. Voluptua lorem diam erat feugait eirmod esse facilisis. Aliquyam consetetur sed dolores no lorem sit dolor commodo lorem. Vero et stet vel dolor aliquyam suscipit molestie vero. Ut doming diam vero ea gubergren euismod clita amet eos consetetur et amet at accusam accusam.

Sample Output H4

Iriure dolor et diam rebum. Dolor kasd sea soluta. Ipsum sit dolores soluta eos quod duo ipsum sadipscing nibh eirmod aliquyam sit sed dolore. Lorem ea eirmod eirmod et clita illum voluptua voluptua invidunt diam eum dolore facer lorem. Eos voluptua sit sed nonummy ipsum imperdiet dolore.

Et voluptua lobortis vero et dignissim ipsum laoreet lorem aliquyam nonumy ipsum consequat invidunt dolores in et tempor. Odio tempor erat ut aliquyam et ut vel diam augue consequat diam diam magna elit amet no vulputate duo. Vero kasd lorem et. Dolore dolor ipsum kasd et dolor. Gubergren duo ea odio. Volutpat dolor amet sea consetetur no sed vel elitr et eos rebum labore diam labore elitr consequat diam kasd. Magna labore no nostrud no molestie molestie kasd laoreet. Et feugiat sed autem sed invidunt vero sit option ipsum at exerci ea duis ad illum voluptua. Commodo sit dolore duis aliquyam eos laoreet dolore eum praesent ipsum no aliquyam dolores accusam duis. Et invidunt cum velit dolor labore diam ullamcorper rebum eos. Justo magna sit consetetur lobortis eirmod illum.

Sample Output H4

No gubergren est eos et exerci euismod magna est sit sea ipsum. Et at rebum sed iriure dolor cum elitr dolor et eirmod accusam delenit clita odio magna invidunt dolore. Et amet volutpat ea aliquyam facilisis gubergren nostrud vero takimata. Nonummy ea rebum dolor ea. Dolore sit iriure ut ipsum at takimata ut placerat.

Option ipsum placerat ex vulputate nonumy iusto. Magna quis et iriure qui tempor. Dolores et nulla. Takimata nostrud minim aliquyam consetetur qui justo et option et at nulla takimata vero vel. Magna amet ut est. Et dolor amet magna eum est. Erat nulla et vero laoreet. Amet labore labore eos ipsum amet nisl ipsum sea eum ipsum iriure consetetur justo eirmod. Clita sit dolore dolore. Consequat veniam wisi amet zzril rebum aliquyam nonumy et soluta lorem. Sit consectetuer ipsum voluptua luptatum invidunt dolores et eos ut ut eu justo invidunt molestie vel.

Sample Output H3

Accusam sadipscing ipsum stet stet placerat tempor eos dolore invidunt gubergren duis invidunt diam diam lorem sadipscing. Et sit tempor eleifend ut diam et wisi labore et ex. Diam vel qui rebum nulla clita sed et justo takimata lobortis at velit lorem. Elitr lorem dolor amet dolore. Sit stet soluta. Nonumy id facilisis clita ipsum iusto lobortis in eirmod. Et amet et sed ut gubergren. Ut ea erat at ea. Consectetuer erat et et dolore enim et no illum dolor kasd sed invidunt sit kasd accusam.

Tempor lorem possim sed duis diam iriure ea lobortis accusam et ipsum vero eum et diam consetetur. Ex dolore dolore eos duo lorem lobortis dolor dolor lorem wisi elitr kasd magna. At tempor et eum in eleifend hendrerit. Dolores kasd lorem consetetur duo clita zzril amet sea sea. Ipsum eu consequat rebum magna lorem sanctus. Et nonumy ea lorem consetetur ut sit. Suscipit sed feugiat stet dolore clita et cum stet dolor est et dolore aliquyam. At ut sit quis clita sadipscing vero ut sanctus invidunt dolor voluptua et odio facilisis sanctus elitr. Illum elitr suscipit sed. Diam tincidunt stet dolor sit sanctus amet. Consequat lorem invidunt possim ea no gubergren dolore sanctus adipiscing invidunt vero dolor ut velit sit.

Sample Output H4

Vel magna labore aliquam eirmod ad sed enim eos dolore sanctus sit eos facilisi. Et clita justo duo dolore rebum sit et amet euismod at justo diam ea elitr ipsum dolores rebum eu. Assum stet ut ea et takimata wisi invidunt clita voluptua at. Luptatum justo duo vero ut diam. Eirmod amet lorem dolore.

Consetetur erat kasd magna sed exerci dolore elitr diam. Et gubergren ipsum aliquyam vero iriure kasd et feugait dolor congue dolor. Sit dolor kasd hendrerit stet sadipscing veniam nonumy kasd elitr soluta. Consequat eos est consequat consectetuer aliquyam ut nonumy dolor lorem. Blandit eu vero.

Sample Output H4

Rebum clita dolor et voluptua. Amet stet nulla et ut. Adipiscing dolor vero molestie justo commodo dolore et nonumy est eos dolor erat magna. Velit diam congue iusto et adipiscing diam diam commodo kasd aliquam eirmod vel duis elitr dolor. Amet et sea voluptua hendrerit sit dolores et. Accusam blandit takimata nonumy sed lorem consetetur nonummy no id et erat eu feugiat lorem justo aliquyam facilisis amet. Gubergren autem dolor soluta elitr diam euismod ut sadipscing dolor sed magna. Est enim diam lorem gubergren consequat et sadipscing est. Et et justo augue vulputate ipsum diam gubergren justo. Volutpat est te voluptua justo sit aliquyam eum in ipsum clita.

Magna sed duo molestie elit. Voluptua nisl tempor est sea magna autem takimata. Sit et accumsan ut et diam accusam ea justo labore aliquyam. Amet qui molestie ipsum vulputate stet dolores nibh aliquam lobortis. Molestie nisl consetetur ea consequat sit sit et. Nonumy sed kasd et stet sed illum est blandit augue eos. Blandit at ex duis molestie dolor duo duo magna clita elitr. Enim invidunt lorem sed enim tation augue duo euismod vero accumsan ut takimata commodo nonumy sit sit.

More Sample Output H2

Et no eirmod. Consectetuer duis lorem lorem. Illum eos te sed invidunt dolore. Diam elitr ipsum suscipit aliquyam lorem rebum et rebum aliquam et sed. Stet soluta amet justo labore et. Dolore dolor esse molestie ipsum tation.

Liber nulla kasd nonummy vero magna stet sadipscing ipsum et eu et amet sit vulputate rebum. Takimata dolores molestie et vero ut at consequat magna. At vulputate duo. Iusto tempor sit labore consectetuer et stet dolores vel et sadipscing sit eros esse dolore takimata aliquyam eu. Lorem sit at voluptua justo eirmod nonumy dolores magna sadipscing sed aliquam.

Sample Output H3

Nonumy kasd consequat. Dolores no invidunt sadipscing possim. Ut sanctus est ea consetetur ipsum vero gubergren veniam dolore. Takimata amet kasd sed amet eum facer diam ullamcorper consetetur id dolore et laoreet at eum takimata clita. Lorem elit euismod in volutpat clita sed vero vero clita duo magna no. Ea dolore facilisis at iusto sit dolore dolore ipsum aliquyam est sed sit et kasd. In sit ipsum tempor lorem soluta ex suscipit. Et et et ut feugiat lorem aliquyam dolor takimata takimata accusam sit consequat ut nulla molestie.

Dolor dignissim facilisi amet augue nonummy sanctus sanctus amet labore luptatum rebum. Luptatum et adipiscing facilisi sed ipsum ut hendrerit at voluptua clita sadipscing tempor et. Et et velit facer esse. Sanctus eirmod aliquip accusam diam magna kasd justo est sit ut consetetur sea accumsan at tempor minim dolore. Rebum ut et doming no dolor stet feugait ex ea ex. Gubergren no vero gubergren et labore magna. Nulla sed lorem et. Eros erat erat wisi aliquyam labore possim amet dolore feugait justo lorem quis tempor justo takimata rebum. Lorem justo ea ullamcorper labore qui nulla elitr.

Sample Output H4

Ut lorem vero. Amet et aliquam ut ipsum consetetur magna esse ea luptatum sed. Labore vero sed dolor sit consetetur. Aliquyam amet ut ea et amet ipsum sit tempor magna congue. Et esse eos lorem amet amet. Diam et gubergren lorem lorem luptatum adipiscing ut.

Dignissim est suscipit facer eos at amet ea aliquip odio justo lorem tempor consectetuer nisl. Dolore amet eirmod clita stet sit vel consequat euismod at. Stet option dolores lorem lorem dolore autem invidunt diam nonumy sadipscing tincidunt et lobortis et duis. Eu consequat vero eum labore qui. Dolor ut iusto lorem ut sed. Et ipsum nibh accusam et ut dolore esse vulputate magna sit diam iriure et diam feugait eos congue illum. Labore sadipscing augue nulla facilisis amet luptatum duo stet.

Sample Output H4

Erat qui dolore sed euismod dolore clita sanctus nulla veniam sed. Amet ex laoreet sea kasd. Amet amet vero ut molestie eos et clita dolores in accusam ipsum duo at sit sea. Lobortis facilisis sit in sed lorem facilisi et sadipscing takimata labore dolores no nonumy esse sanctus ex justo vel. Et dolore no nonumy sadipscing lorem nostrud invidunt sed consetetur dolor sit nam consequat duo stet duis accumsan dolores. Dolore et at. Et ut no soluta gubergren magna rebum takimata magna accusam clita laoreet justo takimata.

Nostrud accusam labore amet lorem tempor aliquyam in accusam sadipscing nisl aliquyam dolor commodo ea vero et. Ut diam nonumy kasd lorem kasd rebum sit consetetur amet et kasd. Vero vero eirmod ullamcorper clita lorem sed autem lorem voluptua ut consectetuer eos. Vel lorem eos et eirmod diam quis suscipit sadipscing et lorem. Iusto et no consetetur erat iusto euismod sit aliquyam magna ipsum elitr takimata euismod. Dolore clita ex est imperdiet. Diam diam sed labore consetetur et vero dolore. Magna ea takimata. Amet accumsan vulputate sea tempor eum lorem eos stet sit et. Dolore adipiscing autem diam consequat dolore cum dolor aliquam clita sea dolores sanctus vel esse aliquip duo kasd hendrerit.

Sample Output H3

Sed no justo ad. Gubergren nibh nulla sanctus. Consequat dolores sed facilisis. Nihil eos in at elit nonumy est at illum et suscipit placerat. Labore sanctus dolor accusam voluptua amet dignissim sit voluptua ea duis ipsum diam consetetur dolore amet sed ea amet. Duo takimata facilisis velit dolor sit veniam eos aliquyam ut sadipscing lorem justo erat exerci sit placerat. No stet at justo et sea diam diam lobortis clita eos option ex liber accusam amet diam sed diam. Et aliquam ea diam clita dignissim et. Diam nibh ex dolore ipsum et sanctus accusam lorem ipsum ut diam vero sed labore cum amet. Dolor nam nulla tempor euismod magna eos.

Voluptua eu sed sed velit. Delenit ut diam facilisis sed dolore ipsum zzril aliquam sit sed elitr. Labore sed hendrerit amet eu eos blandit duo. Elitr ipsum voluptua no no vero qui. Eirmod hendrerit duo lorem rebum. Diam diam no erat lorem takimata takimata.

Sample Output H4

Est diam gubergren stet dolores. Delenit labore dolore dolor sadipscing at aliquyam et. Amet erat aliquyam nonummy rebum lorem sea luptatum accusam lorem et duo et consetetur cum nulla clita. Consetetur duo vulputate lorem. Duo tempor iriure feugait adipiscing ipsum et dolor diam takimata voluptua kasd lorem vero sit nonumy lorem magna. Nonumy at soluta et diam nonumy rebum nulla magna. Ut ipsum quis lorem duo sit id vulputate vero no clita sit. Eos kasd augue dolores. Zzril dolor sit sed odio accusam sadipscing ex labore tempor aliquip justo magna amet. Et sed lorem ut eos.

Consectetuer ut lorem labore lobortis eirmod ut dolore eos sanctus eos stet sadipscing. Consectetuer consetetur et hendrerit nonumy dolore stet elitr. Tempor nam duo stet invidunt magna takimata sit sadipscing lorem dolores amet ipsum at dolores magna est. Ipsum aliquyam nonumy nonummy nisl dolor. Et ipsum tation amet ad lorem diam sed diam consetetur zzril est at in amet et et. Ea ut erat et justo lorem no vero minim sadipscing sed amet eos lorem et ipsum justo. Erat amet commodo consectetuer ipsum in at magna praesent et erat dolores et rebum vero nobis hendrerit sadipscing rebum. Sed facilisi tempor hendrerit aliquip sadipscing sit.

Sample Output H4

Et nonumy et. Kasd ut sit duis ipsum euismod sea. Eirmod dolore aliquip quis sit accusam stet nostrud at et. Nulla tempor est gubergren augue gubergren magna sanctus diam dolores kasd sit consequat. Stet sanctus ad et sit nonumy delenit sanctus voluptua diam voluptua lorem. Sadipscing et diam ea autem nostrud. Dolore vel diam liber et vulputate gubergren magna labore. Sed magna ea sed dolore zzril kasd lorem nonumy sit ut soluta gubergren lorem cum consetetur labore odio.

Ea aliquyam kasd et. Sed sed kasd dolor et clita voluptua accusam dolor augue kasd hendrerit cum gubergren diam accusam gubergren sadipscing minim. Erat dolore clita ipsum. Sanctus imperdiet sanctus magna in feugiat lorem. Dolore est molestie et ipsum.