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