PDF Properties
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.
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
In esse stet ut nonumy et lorem nibh lorem. Amet veniam clita elitr rebum stet voluptua in hendrerit nobis sit et vel. Sanctus ut ex dolores stet invidunt labore et sed. Eirmod lorem ex labore stet. Velit lorem hendrerit stet clita elitr elitr erat aliquyam hendrerit stet magna takimata amet.
Consetetur euismod veniam lorem duo molestie nostrud in gubergren et tincidunt dolor ipsum. Et et sadipscing sit et elitr voluptua dolore wisi rebum sadipscing magna eirmod et diam. Sea erat elitr at dolore. Nonumy no euismod delenit quis dolor. Sed ipsum sed diam justo accusam et accusam erat aliquyam voluptua magna clita rebum eleifend kasd erat elit. Ipsum tation quis te no erat amet ipsum tempor ut. Ut sit vero diam amet imperdiet dolor nihil justo.
Sample Output H3
Ex quis blandit amet invidunt dolore hendrerit magna dolor sit ea justo iusto delenit diam sed. Ipsum est et labore dolor exerci consetetur eum iriure ut autem est no option wisi diam erat. Sit diam nonummy esse lorem at dolore magna sadipscing accusam magna stet dolore labore dignissim odio ea dolor sed. Rebum sanctus velit takimata nostrud ea ipsum wisi eirmod dolor volutpat congue diam. Dolor zzril et consetetur est luptatum et clita magna iriure. No consequat clita et labore amet wisi sed no sadipscing dolore accusam dignissim gubergren justo sadipscing augue dolor. Ipsum dolore sadipscing vero elitr sanctus et sanctus gubergren nulla lorem dolor vero. Consetetur diam at invidunt ut amet vel lorem accusam volutpat enim dolores clita lorem labore. Eos iusto sit. Esse no ea clita.
Sanctus consetetur elitr luptatum gubergren sed ea est in sanctus facilisi sea dolor consectetuer eu. Eu amet sed voluptua exerci aliquyam sanctus vero sed sed vulputate nonumy nostrud congue eos ea et eos euismod. Et est facilisi ut ipsum. Dolor nulla rebum dolore sadipscing iriure labore illum labore accusam ea consetetur vel diam tempor. Gubergren eu invidunt voluptua kasd diam. Sed et sed takimata. Dolor dolore tempor est eos nonumy dolores. Clita at duo erat consectetuer sed facilisis dolor ipsum eos suscipit. Ea eos rebum diam labore diam amet invidunt id. Sed justo velit nonummy tempor amet et clita et aliquyam gubergren nostrud vulputate.
Sample Output H4
Eos at et. Magna dolor aliquip qui et erat accumsan amet sit ut sit quod. Dolor at labore illum exerci sea. Qui ex ea dolor takimata. Vero duo erat voluptua et dolor dolore et ad eros sea. Sit vel feugiat et tempor erat at erat clita nam magna duo. Eu et mazim kasd amet vel duis feugiat sed ut takimata et et diam. Stet elitr sea et feugait. Elitr diam consetetur amet dolores nonumy sed iusto magna dolores et gubergren nihil nobis ut eirmod at.
Sea sanctus et vero at sit dolores sadipscing erat feugait tempor lorem eu eum rebum vero takimata. Gubergren sed tempor tempor sanctus autem iusto tempor et placerat vel dolore at commodo. Amet amet sit justo lorem et sit amet sit dolore rebum consetetur ex molestie. Labore diam duis nulla soluta diam nihil accusam amet accumsan invidunt nonumy. Quod elitr ut labore nisl sadipscing amet mazim duo suscipit. Nonumy sadipscing eum et eirmod elitr ipsum lorem eirmod qui sea mazim ipsum vel amet dolores dolore erat sit. Justo magna sanctus takimata ut dolore vel takimata at nonumy consetetur et lorem te no. Veniam nonumy dolore at tempor eirmod nonumy gubergren invidunt amet nisl duis eros exerci. Augue et sed labore dolor tempor est ut takimata erat rebum sanctus gubergren vero voluptua sit justo sanctus dignissim. Sed aliquyam magna nulla qui elitr autem nonumy. Eum rebum nulla lorem diam amet amet.
Sample Output H4
Et takimata nisl esse exerci sed sed. Facilisis invidunt feugait ipsum aliquyam clita sed tempor ipsum duo et autem lorem est gubergren molestie dolore feugiat lorem. Erat et eum ex et nihil. Stet duo consetetur soluta imperdiet tempor diam sit gubergren aliquyam nonumy et. In kasd clita dolore sed blandit autem sed dolor et sea labore. Facilisi elitr sit te gubergren nihil. Et diam et est ea justo dolore nobis no. Aliquip vulputate clita sed clita dolores accusam veniam dolore commodo ipsum no et amet invidunt justo duis commodo est.
Dignissim sea ea commodo ad. Eros dolores no takimata sadipscing dolore dolor dolor dolor et labore erat at voluptua amet nam. Congue rebum kasd at. Ea accusam dolore clita nonummy sit amet rebum aliquyam ipsum ipsum vero clita. Stet iriure no takimata justo nonumy justo stet rebum ipsum aliquyam magna amet ipsum. Invidunt esse praesent et elitr vel nonumy sea dolore sadipscing sit vel accusam. Lobortis magna dolore. Velit consetetur et diam et vero aliquyam lorem ipsum sanctus erat dolore lorem.
Sample Output H3
Lorem consetetur stet dolore iriure et. Diam ipsum sed stet sanctus tincidunt rebum tempor erat et. Et clita ipsum dolor sit no vero clita sadipscing aliquip. Sed lorem diam. Ipsum et magna facer lorem odio erat rebum lorem ea clita clita. Eirmod invidunt et kasd sea ut nihil vero ipsum ipsum lorem lorem sea gubergren kasd. Elitr voluptua erat invidunt voluptua consetetur elitr nonumy eirmod in amet clita dolor amet duis ut sed dolor. Sanctus duo et dignissim autem te takimata sit ipsum et velit elitr amet dolor sanctus eum diam. Et erat tempor consetetur sed et esse diam velit nonummy ipsum labore.
Est sed ut suscipit invidunt aliquyam magna augue justo consetetur accumsan sanctus et. Illum consetetur in lorem consetetur et at iriure est duis vulputate et lorem. At congue ipsum aliquyam ipsum dolor ipsum labore at et te sit dolor. Te consequat et diam odio dolor nisl in sit dolor sed iriure delenit diam sanctus gubergren duo. Invidunt velit et diam hendrerit. Ipsum invidunt erat adipiscing et sadipscing nulla. Amet consequat magna sed iriure labore eum duo dignissim aliquip clita elitr ipsum nibh ex nonumy dolore.
Sample Output H4
Vero ea augue tempor lorem facilisi kasd tempor eos lorem accusam euismod nulla. Dolores no rebum ea ea velit dolores at dolores justo eos feugiat duo nonumy. Eos elitr nonumy eirmod amet cum sit. Dolor imperdiet adipiscing dolore rebum lorem ipsum duis at lorem takimata invidunt praesent ipsum accumsan iriure lorem nulla. Dolor id vel voluptua vero dolore consetetur exerci. Magna sadipscing consectetuer eu iusto.
Eirmod amet est dolor no. Lorem dolor vero clita ipsum amet voluptua dolore consetetur et eirmod justo. Nihil dolore ut. At sit diam ipsum dolores eu et takimata ipsum vel wisi et. Consetetur sed nonumy tincidunt et dolores dolor consetetur dolore lorem invidunt. Esse consetetur et clita et vero ipsum soluta eirmod vero.
Sample Output H4
Amet velit lorem dolore lorem vero dolore iusto ea augue nonumy sed aliquyam aliquyam vero eirmod dolore luptatum gubergren. Et elitr erat tation facilisi sit accumsan nostrud lorem duo ut sit. Et hendrerit eirmod ut. Laoreet sed et autem at at lorem elitr et ipsum lorem et. Diam et imperdiet rebum sea takimata sed facilisis. Lorem eos eos ipsum et iusto ex. Imperdiet duo dolor et sed eleifend nam vero et est tempor nulla duis et nostrud. Et et ut stet at labore lorem consetetur odio lorem eu sadipscing. Dolore lorem consectetuer kasd nulla sanctus option mazim eirmod lorem duo nonumy. Quod ipsum aliquam lorem rebum exerci dolore vero et dignissim est tempor. Vero et ipsum dolore sed.
Volutpat ipsum sit ipsum tempor est amet no tempor sed. Dolor vero ut sed amet accusam iusto consequat duo facilisis delenit rebum dolor diam sed lorem erat elit. Nonummy takimata sed amet et vulputate ipsum et nulla no sit eos diam tempor commodo lorem vel. Velit vero rebum. Nonumy diam et. Tation praesent minim stet eos tempor. Autem et autem eos erat clita aliquip dolore sanctus voluptua dolore in takimata. Sed ipsum sanctus feugiat et. Ullamcorper voluptua assum justo vero kasd ipsum et. Hendrerit dolores kasd at at. Amet luptatum magna dolores accusam dolore dolore in clita exerci dolor diam sit aliquyam veniam nam qui feugait.
More Sample Output H2
Iusto dolore veniam ipsum. No dolore hendrerit dolores ut luptatum et dolore magna nonummy. Quod tation amet consetetur diam ea laoreet at sed dolore sed ipsum sanctus et delenit clita. Labore lorem duo invidunt et lorem amet nonumy dolor vero. Kasd ex nibh ea volutpat facilisis stet sadipscing et zzril ea et sed diam accusam ipsum. Praesent dignissim et sed rebum dolores ipsum duis feugait dolor. Amet facilisis amet sanctus consetetur suscipit ad imperdiet ipsum sadipscing dolor augue et ut ipsum lorem ipsum. Diam sit clita sit.
Duo diam elitr wisi sed diam molestie. Et dolor ad ea et nonummy erat aliquip te consetetur lorem consetetur amet et rebum at dolores dolores. Zzril vel accusam dolore lorem dolore eirmod. Nisl rebum ipsum stet sed tincidunt takimata takimata justo nonumy dolore enim et dolor sea. Duo dolor eos aliquyam aliquyam diam ut commodo nulla dolores eos ipsum ut justo praesent diam clita. Quod voluptua dolore elit hendrerit et gubergren molestie sit sit labore ea est at accumsan. Zzril vel et facilisis no ut diam erat et justo ut elitr et lorem diam clita.
Sample Output H3
Sed et no ullamcorper liber kasd invidunt iriure eu cum rebum dolore. Sed accumsan et. Ipsum amet invidunt magna dolores ipsum diam dolor in tempor dolor clita sit. Autem erat soluta justo. In consetetur ea no sed dolor. Vero lorem erat gubergren. Justo nisl elit mazim at ipsum sanctus kasd dolores et no dolores at duo illum dignissim. Ad ex erat no amet eos kasd enim tempor. Duo takimata at eos eros sed aliquyam labore.
Tempor et id dolor no takimata sed ut ipsum. Et ad sea. Sanctus accusam aliquyam ipsum duo dolore justo at et velit eirmod nisl vero voluptua dolores eirmod. Ex erat invidunt diam sea. Dolore sit sadipscing minim. Qui ipsum et ut praesent no consectetuer possim ipsum ea dolore vulputate lorem veniam sit accusam takimata ut dolor. Dolor no nonumy qui ut et gubergren consequat lorem ipsum consequat takimata. Consetetur invidunt lorem vel dolore invidunt qui no diam sed aliquyam odio esse odio at sea ut facilisi. Enim no vero veniam magna nam nonumy aliquyam lorem eirmod invidunt lorem tempor sanctus.
Sample Output H4
Eirmod et takimata tation. Sed amet at dolor no dolore enim consequat dolore. Magna et amet dolor rebum tempor stet takimata at erat dolore. Tempor dolore ut duis magna labore et tincidunt hendrerit clita dolore. Consectetuer stet eos sadipscing et at vero. Et eu gubergren takimata tempor clita vulputate duo no voluptua. Ea clita et sea et feugait delenit dolores sed amet laoreet dolor.
Vero consetetur amet velit assum molestie justo lorem clita aliquip hendrerit clita ut gubergren justo. Ipsum et ad lorem illum autem sadipscing aliquyam gubergren wisi voluptua diam rebum facilisis. Labore sed feugiat clita duo lorem erat accusam quis stet clita sit nisl diam kasd velit. Ut dolores dolor te et lorem iriure laoreet wisi nulla erat et no nonumy diam. Eu liber magna nonumy nihil amet lobortis justo erat takimata dolore laoreet dolor. Sit amet consetetur tempor hendrerit rebum diam. Qui eirmod invidunt et ea gubergren labore sit sit. Et nisl diam dolore nulla dolor ut. Nonummy labore ea no amet eos dolor sit.
Sample Output H4
At et erat diam possim sit sit sed tempor at option nihil cum consetetur velit praesent sit. Id dolor voluptua sed feugiat at aliquip euismod dolor te invidunt stet. Et ea accusam voluptua eu magna sed stet ea magna voluptua eirmod invidunt dolores. Congue eirmod ipsum. Ipsum amet et kasd ipsum luptatum minim dolore takimata kasd duis elitr nihil eos rebum diam lorem consequat. Nonumy ipsum eos ea aliquyam accusam duo amet sadipscing no dolore aliquyam magna facilisis dolores sea. Ipsum eirmod dolores nulla et lorem eirmod ipsum ipsum vulputate ipsum no eirmod nonumy magna et justo eos nobis.
Takimata diam esse dolore clita. Aliquip feugiat vel elit elit. Ipsum at gubergren kasd et clita et ut dolor kasd feugiat invidunt ut sanctus justo sea. Clita ut consequat feugait kasd sit ipsum nihil sanctus minim ut aliquip est accusam sed dolores facilisis ut zzril. Et erat nulla. Feugiat et facilisis sed ea invidunt aliquyam dolore nulla luptatum clita dolore ipsum. Sed stet clita blandit duo diam delenit lorem elitr.
Sample Output H3
Justo diam accusam nonumy tempor dolore et et ea sed. Dolores lorem amet assum velit dignissim clita. Et sea dignissim vero consetetur accusam no ea gubergren. Aliquip kasd magna hendrerit. Consequat amet gubergren nostrud et. Lorem consetetur dolore exerci justo sit no eos lorem erat erat. Accusam dolor diam consequat gubergren voluptua dolores quis dolores euismod et feugiat nonummy. Iriure et dolore mazim et takimata elitr et elit amet molestie dolore at at. Et clita dolor nibh erat no facer diam lorem augue gubergren gubergren elitr ipsum sed accusam ut. Elitr lorem elitr. Lorem dolor accusam amet dolor invidunt lorem dolore tempor sit in minim at rebum.
Dolores amet sit diam. Amet gubergren ipsum amet adipiscing accusam clita et ea et est no. Hendrerit sit est. Eros lorem sed justo at ea dolores augue vero consequat. Dignissim rebum kasd dolor ipsum aliquyam kasd sadipscing eos autem commodo wisi invidunt consequat sanctus justo sanctus ipsum. Vero ut luptatum et vero. Invidunt sea justo nostrud magna tempor. Sanctus amet vel dolore lorem nisl consetetur labore at takimata eos sea vero nisl est at assum imperdiet. Nonumy eu nulla illum est rebum consequat est clita. Sed lorem sed sea id gubergren elitr.
Sample Output H4
Rebum ipsum nulla diam magna dolor et elitr lorem voluptua magna dolores amet dolores magna elitr no dolor feugiat. Accusam lorem lorem sit amet amet vero diam dolore. Nihil stet at volutpat consequat laoreet dignissim est tempor diam dignissim eos ipsum. Feugiat vero quis. Diam ut ut sit vel elitr enim kasd ut sea ex augue duo diam elitr justo imperdiet. Sed dolore ea consetetur eos ipsum assum.
Congue duo et justo. Voluptua feugiat sit. Aliquyam dolores autem dolore amet et ipsum imperdiet vero delenit eos elitr lorem ipsum sit diam. At wisi doming. Ea nulla consetetur diam justo te ipsum et sed tempor facilisi diam takimata. Amet sanctus lobortis dolore aliquyam laoreet id erat diam wisi sit amet magna justo sed. Luptatum stet eos. Ipsum vero ex rebum feugiat.
Sample Output H4
Vero consetetur amet labore ea sadipscing rebum sanctus et sadipscing imperdiet dolore justo lorem invidunt dolores commodo sadipscing. Facilisis ut illum. Accusam in et ipsum sed ea et consetetur dolores esse. Accusam invidunt ad magna aliquyam diam dolores stet justo. Accusam eum cum elitr duis et sanctus et. Ipsum et vero et tincidunt in.
Vero laoreet accusam et. Amet sanctus consequat amet et dolores erat erat clita accusam clita diam amet sit duo. Dolor elitr no et laoreet vulputate te in diam nonumy vero consequat amet at. Eu congue no clita et ad diam accusam eos consetetur dolore tempor amet et. Velit dolor in facilisi kasd facilisis takimata consetetur et dolore amet. Lorem et sadipscing quis labore. Amet facilisis ipsum diam labore dolore sadipscing justo possim dolor sed est amet feugiat consetetur. Labore facilisis sadipscing takimata praesent nulla ullamcorper lobortis tempor lorem et ullamcorper accumsan eirmod erat nobis.