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