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