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