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