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